* This is an advanced endpoint. To use, please make sure your plan has advanced access.
Create a new brand using the information provided. The Appreciation Engine will expose further data about the brand from each service based on the URLs provided. For example Twitter ID.
Additional fields ([custom data]) can also be sent to be saved against the brand, but must be enabled first (Enterprise Only).
string |
Your API access key | |
name | string |
Name of brand |
officialwebsiteurl | string |
website for brand |
wikipediaurl | string |
wikipedia page for brand |
facebookurl | string |
facebook page for brand |
twitterurl | string |
twitter account url for brand |
instagramurl | string |
instagram account url for brand |
googleurl | string |
google plus url for brand |
youtubeurl | string |
youtube channel url for brand |
spotifyurl | string |
spotify artist url |
deezerurl | string |
deezer artist url |
soundcloudurl | string |
soundcloud artist url |
groovesharkurl | string |
grooveshark artist url |
lastfmurl | string |
lastfm artist url |
type | string |
One of the following category types: 'Music','Sport','Consumer','Movie','TV','Video Game','Influencer' |
[custom data] | integer |
Enterprise Only. Additional fields can be added to the brand for customer specific requirements. |
Sign in with your developer account to use the console, or sign up here
curl -X POST "https://api.theappreciationengine.com/v1.1/brand/create?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p"
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.theappreciationengine.com/v1.1/brand/create?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
import requests
url = "https://api.theappreciationengine.com/v1.1/brand/create?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p"
headers = {}
payload = {}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text.encode('utf8'))
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.theappreciationengine.com/v1.1/brand/create?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p',
'headers': {}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
{
"ID": 1234,
"Slug": "starfleet",
"Name": "Starfleet",
"Type": "TV",
"OfficialWebsiteURL": "https://memory-alpha.fandom.com/wiki/Starfleet",
"FacebookURL": "https://www.facebook.com/StarTrekFleetCommand",
"TwitterURL": "https://twitter.com/hashtag/starfleet",
"WikipediaURL": "https://en.wikipedia.org/wiki/Starfleet",
"TwitterScreenName": "starfleet",
"TwitterID": "12345677",
"FacebookID": "9876543",
"ImageURL": "http://someurl.com"
}