Brands - Create *

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

Endpoint

POST /v1.1/brand/create

Description

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).

Parameters
required *

apiKey *	`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

Example Request

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);
});

Example Response

{

  "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"

}