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" 

}]