MarketingTracer API
De MarketingTracer REST-API geeft gebruikers toegang tot de meeste features van MarketingTracer in JSON-formaat. Onze API is simpel en intuïtief opgezet. Alle resultaten worden geretourneerd als een JSON-object of een array van JSON-objecten.
1. Algemene info
API-endpoint
https://app.marketingtracer.com/rest/
API-authenticatie
Voor onze API-authenticatie gebruiken we basic auth. Ga naar 'white label' om je API-credentials te bekijken. Heb je momenteel geen white label-account, neem dan contact met ons op.
curl https://app.marketingtracer.com/rest/sites/list --user API-key:API-secret
2. Sitelijst
Wil je data opvragen via ons API-endpoint, dan moet je een website-id opgeven. Gebruik het sitelijst-endpoint om een lijst met websites op te halen
get
https://app.marketingtracer.com/rest/sites/list
Voorbeeld-response
[
{
"_id":{
"$oid":"my_id"
},
"domain":"www.example.com",
"locale":{
"lang":"en",
"cc":"en",
"lc":"en"
}
},
{
"_id":{
"$oid":"my_id"
},
"domain":"www.example2.com",
"locale":{
"lang":"en",
"cc":"en",
"lc":"en"
}
}
]
3. RankTracker API
Met de RankTracker-API haal je rankingdata op voor je website.
3.1 Rank Tracker-lijst
get
https://app.marketingtracer.com/rest/rank-tracker/list?websiteid=<websiteid>
Voorbeeld-response
[
{
"_id":{
"$oid":"some_id"
},
"q":"my_keyword",
"meta":{
"star":false,
"label":"",
"cpc":3.720173,
"seo":35.064935064935064,
"vol":1320
},
"summary":{
"google":{
"start":55,
"pos":1,
"best":1,
"worst":66
},
"googlemobile":{
"start":70,
"pos":2,
"best":1,
"worst":75
}
}
}]
3.2 Rank Tracker-zoekwoordhistorie
get
https://app.marketingtracer.com/rest/rank-tracker/history?ranking_id=<rankingid>&websiteid=<websiteid>
Voorbeeld-response
{
"wwwurl1":{
"url":"www.example.com/url1",
"data":[
{
"date":"20190413",
"pos":41
},
{
"date":"20190413",
"pos":41
}
]
},
"www.example.com/url2":{
"url":"www.example.com/url2",
"data":[
{
"date":"20190426",
"pos":44
}
]
}
}