Brands - Crossover



Endpoint

GET /v1.1/brands/[BrandID]/crossover

Description

Return the top list of preferred cross brands for a based on parameters provided. If no brandid provided then it shows the top most popular brands overall.

Parameters
required *

apiKey *  string Your API access key
[brandID] *  integer The ID of the brand to be queried
country  string ISO 3166-1 alpha-2, comma separated list. eg US,CA,GB
services  string Comma separated list – eg. twitter, facebook, lastfm, rdio, youtube, custom, etc
period  string In format of '[Amount] [Unit]' - eg 2 Month, 1 Day, 3 Week
period_end  string In format of '[Amount] [Unit]' - eg 2 Month, 1 Day, 3 Week
start_date  string In format of 'YYYY-MM-DD HH:MM:SS' – start of date range for results
end_date  string In format of 'YYYY-MM-DD HH:MM:SS' – end of date range for results
limit  string Limit the results, default 10, max 1000 eg 100 or 10,10 (offset,limit)
brand_type  string Filter the crossover brands for a single brand type (category)

Sign in with your developer account to use the console, or sign up here

Example Request

curl -v -X GET "https://api.theappreciationengine.com/v1.1/brands/1234/crossover?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p"
$curl = curl_init();

curl_setopt_array($curl, array( 
	CURLOPT_URL => "https://api.theappreciationengine.com/v1.1/brands/1234/crossover?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p", 
	CURLOPT_RETURNTRANSFER => true, 
	CURLOPT_ENCODING => "", 
	CURLOPT_MAXREDIRS => 10, 
	CURLOPT_TIMEOUT => 0, 
	CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, 
	CURLOPT_CUSTOMREQUEST => "GET", 
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "https://api.theappreciationengine.com/v1.1/brands/1234/crossover?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p"

headers = {}
payload = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text.encode('utf8'))
var request = require('request');
var options = {
	'method': 'GET',
	'url': 'https://api.theappreciationengine.com/v1.1/brands/1234/crossover?apiKey=0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p',
	'headers': {}
};
request(options, function (error, response) {
	if (error) throw new Error(error);
	console.log(response.body);
});

Example Response

{
"totalSize": 2,
"items": [
{
"ID": "12345",
"Name": "USS Enterprise",
"Slug": "uss-enterprise",
"Type": "Artist",
"OfficialWebsiteURL": "https://www.uss-enterprise-ncc1701.com/",
"FacebookURL": "https://www.facebook.com/enterprise",
"FacebookID": "12345",
"YouTubeURL": "https://www.youtube.com/user/USSEnterpriseVevo",
"YouTubeUsername": "USSEnterpriseVevo,
"TwitterURL": "https://twitter.com/USSEnterprise",
"TwitterScreenName": "USS Enterprise",
"TwitterID": "4567",
"InstagramURL": "https://www.instagram.com/ussenterprise",
"InstagramUsername": "ussenterprise",
"GoogleURL": null,
"GoogleID": null,
"TumblrURL": null,
"HashTag": "ussenterprise",
"SpotifyURL": "https://open.spotify.com/artist/66CXWjxzNUsdJxJ2JdwvnR",
"SpotifyID": "66CXWjxzNUsdJxJ2JdwvnR",
"SpotifyUserURL": null,
"SpotifyUserID": null,
"DeezerURL": "https://www.deezer.com/en/artist/1234",
"DeezerName": "USS Enterprise",
"DeezerID": "1234",
"DeezerUserURL": null,
"DeezerUserID": null,
"AppleMusicURL": "https://itunes.apple.com/us/artist/ussenterprise/412778295",
"AppleMusicName": "USS Enterprise",
"AppleMusicID": "12345",
"NapsterURL": null,
"NapsterID": null,
"NapsterUserURL": null,
"NapsterUserID": null,
"SoundCloudURL": "https://soundcloud.com/uss-enterprise-official",
"SoundCloudUsername": "USS Enterprise",
"SoundCloudID": "12345",
"WikipediaURL": "https://en.wikipedia.org/wiki/USS_Enterprise_(NCC-1701)",
"ImageURL": "http://someurl.com",
"ActiveMembers": "150",
"Percentage": "65.5"
},
{
"ID": "67890",
"Name": "Commander Data Violin Sessions",
"Slug": "commander-data-violin-sessions",
"Type": "Artist",
"OfficialWebsiteURL": "http://www.dataviolinsessions.com",
"FacebookURL": "https://www.facebook.com/dataviolinsessions",
"FacebookID": "1234",
"YouTubeURL": "https://www.youtube.com/dataviolinsessions",
"YouTubeUsername": null,
"TwitterURL": "https://twitter.com/dataviolinsessions",
"TwitterScreenName": "Commander Data Violin Sessions",
"TwitterID": "1234",
"InstagramURL": "https://www.instagram.com/dataviolinsessions",
"InstagramUsername": "Commander Data Violin Sessions",
"GoogleURL": null,
"GoogleID": null,
"TumblrURL": null,
"HashTag": null,
"SpotifyURL": "https://open.spotify.com/artist/6qqNVTkY8uBg9cP3Jd7DAH",
"SpotifyID": "6qqNVTkY8uBg9cP3Jd7DAH",
"SpotifyUserURL": null,
"SpotifyUserID": null,
"DeezerURL": "https://www.deezer.com/artist/4567",
"DeezerName": "Commander Data Violin Sessions",
"DeezerID": "4567",
"DeezerUserURL": null,
"DeezerUserID": null,
"AppleMusicURL": "https://itunes.apple.com/us/artist/dataviolinsessions/6789",
"AppleMusicName": "Commander Data Violin Sessions",
"AppleMusicID": "6789",
"NapsterURL": null,
"NapsterID": null,
"NapsterUserURL": null,
"NapsterUserID": null,
"SoundCloudURL": null,
"SoundCloudUsername": null,
"SoundCloudID": null,
"WikipediaURL": null,
"ImageURL": null,
"ActiveMembers": "119",
"Percentage": "42.0"
}
]
}