Brands - Edit *



* This is an advanced endpoint. To use, please make sure your plan has advanced access.

Endpoint

POST /v1.1/brand/[BrandID]/edit

Description

Update an existing brand. Any fields provided will overwrite current values. New look-ups will be performed for additional data from each service (eg. Twitter ID).

Parameters
required *

apiKey *  string Your API access key
[brandid]  integer ID of brand to edit
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
youtubeurl  string youtube channel url for brand
spotifyurl  string spotify artist url
spotifyuserurl  string spotify user url (seperate from an artist profile, this is used to track owners of playlists)
spotifypodcasturl  string spotify podcast url
deezerurl  string deezer artist url
deezeruserurl  string deezer user url (seperate from an artist profile, this is used to track owners of playlists)
applemusicurl  string applemusic artist url
napsterurl  string napster artist url
napsteruserurl  string napster user url (seperate from an artist profile, this is used to track owners of playlists)
soundcloudurl  string soundcloud artist url
tumblrurl  string tumblr url
twitchurl  string twitch channel url
discordserverurl  string discord server url
redditurl  string the subreddit url for the brand
tiktokurl  string tiktok profile url
[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

Example Request

curl -X POST "https://api.theappreciationengine.com/v1.1/brand/1234/edit?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p"
$curl = curl_init();

curl_setopt_array($curl, array( 
	CURLOPT_URL => "https://api.theappreciationengine.com/v1.1/brand/1234/edit?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/1234/edit?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/1234/edit?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p',
	'headers': {}
};
request(options, function (error, response) {
	if (error) throw new Error(error);
	console.log(response.body);
});

Example Response

[{
"Name":"Starfleet",
"Type":"TV",
"Slug":"starfleet",
"OfficialWebsiteURL":"https://memory-alpha.fandom.com/wiki/Starfleet",
"FacebookURL":"https://www.facebook.com/StarTrekFleetCommand",
"FacebookID":"123456",
"TwitterURL":"https://twitter.com/hashtag/starfleet",
"TwitterScreenName":"starfleet",
"TwitterID":"765433",
"WikipediaURL":"https://en.wikipedia.org/wiki/Starfleet",
"ID":1701, "SpotifyURL":"https://open.spotify.com/artist/1234",
"SpotifyID":"1234",
"ImageURL":"http://someurl.com"
}]