Inleiding
Het bijhouden van posities wordt een heel ander probleem wanneer u honderden websites, duizenden zoekwoorden of SEO-rapportages beheert die automatisch moeten worden bijgewerkt.
Inloggen op een dashboard en gegevens handmatig exporteren werkt misschien nog wel voor kleinere projecten. Op grotere schaal wordt dit al snel een knelpunt.
Daarom hebben we de Ranktracker APIontwikkeld.
De Ranktracker API is nu live en biedt ontwikkelaars, SEO-teams, bureaus, SaaS-bedrijven en datateams programmatische toegang tot hun Ranktracker-gegevens.
Je kunt de API gebruiken om:
- Top 100-zoekwoordrangschikkingen ophalen
- Toegang tot SERP-gegevens
- Detecteer AI-overzichten en andere SERP-functies
- Gevolgde domeinen aanmaken en beheren
- Zoekwoorden toevoegen en beheren
- Concurrenten volgen
- Toegang tot de rangschikkingsgeschiedenis
- Share of Voice berekenen
- Zoekwoorden ordenen met tags
- Accountgebruik en quota monitoren
- Bouw geautomatiseerde rapportagepijplijnen voor SEO
- Koppel rankinggegevens aan interne applicaties en dashboards
In plaats van SEO-gegevens handmatig tussen platforms uit te wisselen, zorgt de Ranktracker API ervoor dat je eigen software rechtstreeks kan samenwerken met de ranking-infrastructuur achter Ranktracker.
Maak je API-sleutel aan of beheer deze: https://app.ranktracker.com/account/api
Het alles-in-één platform voor effectieve SEO
Achter elk succesvol bedrijf staat een sterke SEO-campagne. Maar met talloze optimalisatietools en -technieken om uit te kiezen, kan het moeilijk zijn om te weten waar te beginnen. Nou, vrees niet meer, want ik heb precies het ding om te helpen. Ik presenteer het Ranktracker alles-in-één platform voor effectieve SEO
We hebben eindelijk de registratie voor Ranktracker helemaal gratis geopend!
Maak een gratis account aanOf log in met uw gegevens
Lees de API-documentatie: https://developers.ranktracker.com/
Wat is de Ranktracker-API?
De Ranktracker API is een REST-API die programmatische toegang biedt tot uw Ranktracker-account.
In plaats van Ranktracker elke keer te openen wanneer u informatie over de positie nodig hebt, kan uw applicatie de gegevens automatisch opvragen.
De API is opgebouwd rond dezelfde kernbronnen die in heel Ranktracker worden gebruikt:
- Accounts
- Domeinen
- Zoekwoorden
- Concurrenten
- Rankingsgeschiedenis
- SERP-gegevens
- Share of Voice
- Tags
- Gebruik en quota
Dit biedt ontwikkelaars de mogelijkheid om zowel Ranktracker-gegevens op te halen als te beheren wat Ranktracker bijhoudt.
Een SEO-bureau zou bijvoorbeeld automatisch een Ranktracker-project kunnen aanmaken wanneer een nieuwe klant in het CRM wordt aangemaakt, de zoekwoorden en concurrenten van de klant kunnen toevoegen en vervolgens hun posities kunnen doorsturen naar een intern rapportagedashboard.
Een SaaS-platform zou dezelfde API kunnen gebruiken om rangschikkingsgegevens rechtstreeks in zijn eigen product weer te geven.
Een datateam zou dagelijkse posities automatisch kunnen verzenden naar BigQuery, Snowflake, PostgreSQL, Google Sheets of een ander datawarehouse voor verdere analyse.
Het alles-in-één platform voor effectieve SEO
Achter elk succesvol bedrijf staat een sterke SEO-campagne. Maar met talloze optimalisatietools en -technieken om uit te kiezen, kan het moeilijk zijn om te weten waar te beginnen. Nou, vrees niet meer, want ik heb precies het ding om te helpen. Ik presenteer het Ranktracker alles-in-één platform voor effectieve SEO
We hebben eindelijk de registratie voor Ranktracker helemaal gratis geopend!
Maak een gratis account aanOf log in met uw gegevens
Zie de handleiding ‘Ranktracker API Core Concepts’.
Standaard top 100-ranglijsten
Een van de grootste voordelen van de Ranktracker API is de diepgang van de ranglijstgegevens.
Elke zoekwoordcontrole omvat standaard de Top 100 Google-resultaten.
Dat betekent dat u alle 10 pagina's met zoekresultaten kunt analyseren in plaats van alleen te zien wat er momenteel op pagina één staat.
Dit is belangrijk omdat SEO-vooruitgang meestal al lang voordat een zoekwoord de Top 10 bereikt, begint.
Een zoekwoord kan als volgt stijgen:
positie 91 → positie 63 → positie 37 → positie 18 → positie 9
Dat is een aanzienlijke vooruitgang op het gebied van SEO.
Als je rankinggegevens stoppen bij de eerste 10 resultaten, blijft bijna het hele traject onzichtbaar.
Met het bijhouden van de top 100 kunt u het volgende monitoren:
- Nieuwe posities in de Top 100 van Google
- Zoekwoorden die op weg zijn naar de eerste pagina
- Grote stijgingen en dalingen in de ranglijst
- Bewegingen bij concurrenten
- Zichtbaarheid in long-tail-zoekopdrachten
- Prestaties van nieuwe content
- Programmatische SEO-campagnes
- Grote zoekwoordportfolio's
Dit maakt de API nuttig voor zowel SEO-rapportages op hoog niveau als gedetailleerde rankinganalyses.
Meer informatie over de API:
https://developers.ranktracker.com/
Volg rankings op meer dan 107.000 locaties
Zoekresultaten variëren aanzienlijk, afhankelijk van waar de zoekopdracht wordt uitgevoerd.
Ranktracker ondersteunt meer dan 107.000 locaties, waardoor teams via de API de lokale, nationale en internationale zichtbaarheid in zoekresultaten kunnen volgen.
Het bijhouden van zoekwoorden kan worden geconfigureerd op basis van factoren zoals:
- Zoekmachine
- Locatie
- Taal
- Apparaat
Zo kan hetzelfde zoekwoord bijvoorbeeld afzonderlijk worden gemonitord voor:
- Verenigde Staten — desktop
- Verenigde Staten — mobiel
- Verenigd Koninkrijk — desktop
- Duitsland — mobiel
- Polen — desktop
Elke configuratie kan worden behandeld als een afzonderlijk bijgehouden zoekwoord.
Dit is met name handig voor:
- Internationale SEO
- Bedrijven met meerdere vestigingen
- Lokale SEO-bureaus
- E-commercebedrijven
- Uitgevers die actief zijn in verschillende markten
- SaaS-bedrijven die zich op meerdere landen richten
- SEO-teams van grote ondernemingen
In plaats van een zoekwoord te beschouwen als één universele positie in de ranglijst, kunt u analyseren hoe de zichtbaarheid varieert tussen verschillende markten en apparaten.
Rangschikking volgen op desktop en mobiel
Zoekresultaten op desktop en mobiel kunnen verschillen.
Ranktracker maakt het daarom mogelijk om het bijhouden van zoekwoorden per apparaat te segmenteren.
Dit betekent dat een integratie afzonderlijk het volgende kan analyseren:
- Desktop-posities
- Mobiele rankings
Een pagina kan bijvoorbeeld hoog scoren op desktop, maar anders presteren op mobiel vanwege verschillen in de lay-out van de SERP, lokale resultaten of andere zoekfuncties.
Door deze datasets gescheiden te houden, krijgen SEO-teams een veel duidelijker beeld van hoe gebruikers hun websites daadwerkelijk tegenkomen in de zoekresultaten.
De API maakt ook segmentatie per apparaat mogelijk bij het werken met functies zoals Share of Voice.
Detectie van SERP-functies en AI-overzicht
Moderne Google-resultaten bevatten veel meer dan traditionele organische vermeldingen.
SERP's kunnen het volgende bevatten:
- AI-overzichten
- Uitgelichte fragmenten
- Kaarten
- Lokale resultaten
- Video's
- Winkelresultaten
- Veelgestelde vragen
- Andere zoekfuncties
De Ranktracker-API bevat naast zoekwoordgegevens ook informatie over SERP-functies en AI-overzichtsdetectie.
Dat betekent dat uw integratie niet alleen kan analyseren waar een website staat, maar ook wat er rondom die positie in Google te zien is.
U kunt bijvoorbeeld het volgende vaststellen:
- Zoekwoorden die een AI-overzicht activeren
- Zoekresultatenpagina's met uitgelichte fragmenten
- Zoekopdrachten waarin videoresultaten de boventoon voeren
- Zoekwoorden die lokale of kaartresultaten opleveren
- Veranderingen in de samenstelling van SERP's in de loop van de tijd
Dit wordt steeds belangrijker omdat de organische positie op zichzelf niet altijd het volledige beeld weergeeft.
Een pagina die op de derde plaats staat in een traditionele SERP en een pagina die op de derde plaats staat onder een AI-overzicht, een kaartpakket, video's en 'People Also Ask' kunnen zeer verschillende niveaus van zichtbaarheid hebben.
Met de API kunt u deze verschillen meenemen in uw SEO-analyse.
Bekijk de volledige API-documentatie:
https://developers.ranktracker.com/
Toegang tot volledige SERP-gegevens
Ranktracker biedt veel meer dan alleen een rangschikkingscijfer.
Voor bijgehouden zoekwoorden kan de API de meest recente zoekresultaten weergeven, samen met bijbehorende SERP-informatie.
De structuur van de API-bronnen omvat:
- Meest recente SERP-gegevens
- Informatie over de rangschikking
- SERP-functies
- Cache van SERP-HTML
Dit betekent dat ontwikkelaars workflows kunnen bouwen op basis van de daadwerkelijke zoekresultaten, in plaats van simpelweg iets op te slaan als:
Positie: 12
Voor gevorderde SEO-teams biedt dit veel meer flexibiliteit.
U kunt SERP-informatie gebruiken om:
- Concurrerende URL's analyseren
- Onderzoek onverwachte veranderingen in de rangschikking
- Veranderingen in de lay-out van de resultaten identificeren
- Interne SERP-analysetools bouwen
- Historische SERP-informatie opslaan
- Voer informatie over zoekresultaten in andere modellen of analysesystemen in
De volledige endpoint-referentie vind je hier:
https://developers.ranktracker.com/rest-api/
Domeinen beheren via de API
Domeinen zijn een van de belangrijkste bronnen van de Ranktracker-API.
Met de REST API kunt u:
- Domeinen aanmaken
- Domeinen ophalen
- Domeinen bijwerken
- Domeinen verwijderen
Een domein vertegenwoordigt een site die binnen Ranktracker wordt bijgehouden.
Elk domein kan vervolgens zijn eigen:
- Trefwoorden
- Concurrenten
- Rankingsgeschiedenis
- Share of Voice-gegevens
Dit maakt geautomatiseerde onboarding mogelijk.
Een bureau zou bijvoorbeeld de volgende workflow kunnen opzetten:
Nieuwe klant meldt zich aan
↓
Ranktracker-domein aanmaken
↓
Zoekwoorden van de klant toevoegen
↓
Concurrenten toevoegen
↓
Beginnen met het bijhouden van posities
↓
Gegevens naar het rapportagedashboard verzenden
Een teamlid hoeft niet elk nieuw project handmatig te configureren.
Een volledige handleiding is beschikbaar in de tutorial ‘Een domein toevoegen en zoekwoorden bijhouden’.
Zoekwoorden programmatisch toevoegen en beheren
Zodra een domein bestaat, kunnen zoekwoorden via de API worden beheerd.
U kunt de API gebruiken om bijgehouden zoekwoorden toe te voegen en tegelijkertijd de bijbehorende zoekconfiguratie op te geven.
Gegevens over bijgehouden zoekwoorden kunnen factoren omvatten zoals:
- Word
- Zoekmachine
- Locatie
- Taal
- Apparaat
- Resultaten rangschikken
U kunt ook de levenscyclus van bestaande zoekwoorden beheren.
Dit omvat de mogelijkheid om:
- Zoektermen ophalen
- Lees hun rangschikkingsinformatie
- Tracking pauzeren
- Tracking hervatten
- Tracking stoppen
- Toegang tot SERP-informatie
- Tags toewijzen
Hierdoor kan uw eigen applicatie bepalen welke zoekwoorden Ranktracker monitort.
Zoekwoordtracking in bulk
Grote SEO-accounts zouden niet voor elk zoekwoord een apart API-verzoek hoeven te doen.
Ranktracker ondersteunt bulkbewerkingen voor zoekwoorden.
Het eindpunt voor het aanmaken van zoekwoorden accepteert een configuratie van 'woorden × zoekmachines', waardoor in één verzoek veel combinaties van bijgehouden zoekwoorden kunnen worden aangemaakt.
Stel bijvoorbeeld dat u het volgende wilt volgen:
- 100 zoekwoorden
- Verenigde Staten (desktop)
- Mobiel in de VS
Die configuraties kunnen 200 combinaties van bijgehouden zoekwoorden opleveren zonder dat er 200 afzonderlijke configuratieverzoeken nodig zijn.
Bulkbewerkingen zijn met name handig voor:
- Bureaus
- SEO voor grote ondernemingen
- Grote e-commercewinkels
- Programmatische SEO
- SaaS-SEO-platforms
- Grote contentuitgevers
Ranktracker ondersteunt ook het in bulk toekennen van tags aan zoekwoorden.
Lees de volledige handleiding voor bulkbewerkingen:
https://developers.ranktracker.com/guides/bulk-operations/
SEO-concurrenten volgen
Rankings worden veel nuttiger wanneer ze de context van de concurrentie meenemen.
Met de Ranktracker-API kun je concurrenten vergelijken met de domeinen die je volgt.
Hierdoor kunt u uw zoekprestaties automatisch vergelijken met die van concurrerende websites.
U kunt gegevens van concurrenten gebruiken om het volgende te monitoren:
- Welke concurrenten winnen aan zichtbaarheid
- Welke sites halen uw domein in
- Veranderingen in gedeelde zoekwoordgroepen
- Trends in de concurrentiepositie
- Relatieve zichtbaarheid in zoekresultaten
- Veranderingen in het aandeel in de zoekresultaten
Voor bureaus kan dit onderdeel worden van een geautomatiseerd rapportagesysteem voor klanten.
In plaats van elke maand handmatig een klant met concurrenten te vergelijken, kunnen de relevante gegevens rechtstreeks in de rapportagestroom worden geïntegreerd.
Toegang tot historische rankinggegevens
Huidige posities laten alleen zien wat er op dit moment gebeurt.
Historische rangschikkingsgegevens geven aan in welke richting de SEO-prestaties zich ontwikkelen.
Ranktracker biedt via de API een overzicht van de rangschikkingsgeschiedenis van domeinen, waardoor ontwikkelaars de zichtbaarheid in de loop van de tijd kunnen analyseren.
Historische gegevens kunnen helpen bij het vaststellen van:
- Verbeteringen in de rangschikking
- Positieverliezen
- Trends in zichtbaarheid
- Veranderingen in zoekwoorden
- Veranderingen na SEO-campagnes
- Impact van Google-updates
- Campagneprestaties op de lange termijn
U kunt de rangschikkingsgeschiedenis ook gebruiken om aangepaste grafieken en dashboards te maken.
Bijvoorbeeld:
Ranktracker API
↓
Dagelijkse ranking-extractie
↓
Datawarehouse
↓
Historische SEO-dataset
↓
Dashboard / Waarschuwingen / Analyse
Ranktracker biedt een speciale tutorial waarin wordt uitgelegd hoe je dagelijkse ranglijsten naar een datawarehouse kunt halen:
https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/
Ranktracker-gegevens naar een datawarehouse sturen
Een van de handigste API-workflows is het automatisch opslaan van Ranktracker-gegevens in je eigen database of datawarehouse.
Zo kunnen rangschikkingsgegevens bijvoorbeeld worden verzonden naar:
- BigQuery
- Snowflake
- PostgreSQL
- MySQL
- Google Sheets
- Interne analysedatabases
Die informatie kan vervolgens worden gecombineerd met andere bedrijfsgegevens.
Bijvoorbeeld:
Ranktracker
↓
Ranktracker API
↓
Datawarehouse
↓
Google Search Console
Analytics
Conversies
Omzet
CRM-gegevens
↓
Business Intelligence-dashboard
Dit geeft een veel vollediger beeld van de SEO-prestaties.
In plaats van alleen te weten dat een zoekwoord van positie 8 naar positie 3 is gestegen, kun je analyseren of de verandering ook heeft geleid tot:
- Meer organische klikken
- Meer leads
- Hogere conversiepercentages
- Hogere omzet
De tutorial ‘Rankings to Warehouse’ geeft een voorbeeld van het opzetten van dit soort pijplijn.
Rapporten over 'Share of Voice' opstellen
De Ranktracker-API biedt ook 'Share of Voice '-gegevens.
Share of Voice biedt een bredere meting van de zichtbaarheid van een domein binnen een set van bijgehouden zoekwoorden.
In plaats van te vragen:
Waar staan we voor dit zoekwoord?
kunt u vragen:
Hoe zichtbaar zijn we op deze hele zoekmarkt?
Dit wordt vooral krachtig wanneer gegevens van concurrenten worden meegenomen.
De Share of Voice-API kan worden gebruikt om het volgende te analyseren:
- Uw algehele zichtbaarheid
- Zichtbaarheid van concurrenten
- Zichtbaarheid verandert in de loop van de tijd
- Relatieve marktpositie
- Zichtbaarheid op desktop
- Zichtbaarheid op mobiele apparaten
Het eindpunt ondersteunt datumbereiken en apparaatsegmentatie, waardoor Share of Voice kan worden geïntegreerd in aangepaste SEO-rapporten.
Een volledig implementatievoorbeeld is hier beschikbaar:
https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/
Organiseer zoekwoorden met tags
Grote zoekwoordportfolio's worden moeilijk te beheren als ze niet goed georganiseerd zijn.
Ranktracker biedt tags op accountniveau die aan bijgehouden zoekwoorden kunnen worden gekoppeld.
U kunt tags aanmaken voor:
- Productcategorieën
- Zoekintentie
- Locaties
- Inhoudstypen
- Campagnes
- Klanten
- Fase in de conversietrechter
- Bedrijfsonderdelen
- SEO-teams
Bijvoorbeeld:
"hardloopschoenen kopen" → Commercieel
"beste hardloopschoenen" → Vergelijking
"hoe maak je hardloopschoenen schoon" → Informatief
Dezelfde tags kunnen worden hergebruikt voor verschillende domeinen en zoekwoordgroepen.
Ranktracker biedt ook de mogelijkheid om in bulk tags toe te voegen, zodat grote groepen zoekwoorden kunnen worden georganiseerd zonder dat er afzonderlijke verzoeken nodig zijn.
Een speciale handleiding is hier beschikbaar:
https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/
Accountgebruik en quota monitoren
Geautomatiseerde systemen moeten ook inzicht hebben in de accountresources die voor hen beschikbaar zijn.
De Ranktracker-API biedt:
GET /v1/account/usage
Dit eindpunt rapporteert het accountgebruik en de limieten.
Huidige gebruiksinformatie kan het volgende omvatten:
- Status van API-toegang
- Zoekwoorden
- Gegevensrijen
- Gebruik op aanvraag
- Gebruik van SERP Analyser
Elke quota kan waarden opleveren zoals:
- Gebruik
- Limiet
- Resterend
Hierdoor kan een applicatie de beschikbare capaciteit controleren voordat een grote bewerking wordt gestart.
Voordat u bijvoorbeeld duizenden zoekwoorden importeert, kan uw systeem het accountgebruik opvragen en bepalen hoeveel capaciteit er nog over is.
Lees de volledige handleiding:
https://developers.ranktracker.com/guides/usage-and-quota/
Hoe de Ranktracker API-authenticatie werkt
REST API-verzoeken van Ranktracker worden geauthenticeerd met behulp van een API-sleutel.
U kunt uw sleutels rechtstreeks in Ranktracker aanmaken en beheren:
https://app.ranktracker.com/account/api
Behandel je API-sleutel altijd als een wachtwoord.
De basis-URL van de productie-API is:
https://api.ranktracker.com
API-bronnen bevinden zich onder het pad /v1.
Bijvoorbeeld:
https://api.ranktracker.com/v1/domains
De API-sleutel wordt rechtstreeks in de Authorization -header verzonden.
Er is geen 'Bearer '-voorvoegsel voor standaard REST API-verzoeken.
Voorbeeld:
curl https://api.ranktracker.com/v1/domains
-H "Authorization: tkn_usr_uw_api-sleutel_hier"
Een Ranktracker-API-sleutel moet op de server worden bewaard en mag nooit openbaar worden gemaakt via:
- JavaScript in de browser
- Front-end-broncode
- Openbare repositories
- Code voor mobiele applicaties
- Openbare configuratiebestanden
Lees voor meer informatie:
Snelstart: https://developers.ranktracker.com/guides/quickstart/
Authenticatie: https://developers.ranktracker.com/guides/authentication/
API-sleutels aanmaken/beheren: https://app.ranktracker.com/account/api
Structuur van API-bronnen
Ranktracker gebruikt UUID's om bronnen te identificeren.
Dat omvat bronnen zoals:
- Domeinen
- Trefwoorden
- Concurrenten
- Tags
Een vereenvoudigde weergave ziet er als volgt uit:
Account
│
├── Gebruik
├── Tags
│
└── Domeinen
│
├── Rangschikkingsgeschiedenis
├── Share of Voice
├── Concurrenten
│
└── Zoekwoorden
│
├── SERP
├── Gecacheerde SERP-HTML
└── Tags
Dit maakt de API-structuur voorspelbaar.
Een domein heeft zoekwoorden en concurrenten.
Een zoekwoord hoort bij een gevolgd domein en heeft bijbehorende SERP- en rangschikkingsinformatie.
Tags bestaan op accountniveau en kunnen aan zoekwoorden worden gekoppeld.
Lees meer:
https://developers.ranktracker.com/guides/concepts/
JSON API-reacties
Ranktracker-responsen maken gebruik van een consistente JSON:API-stijl.
De bron wordt geretourneerd onder 'data', terwijl de velden ervan worden opgeslagen onder 'attributes'.
Bijvoorbeeld:
{
"data": {
"id": "DOMAIN_UUID",
"type": "domain",
"attributes": {
"host": "www.example.com",
"projectName": "Example",
"matchType": "any"
}
}
}
Ontwikkelaars moeten ook rekening houden met een belangrijke naamgevingsconventie:
- API-reacties gebruiken
camelCase - Schrijf verzoekteksten in
snake_case
Een reactie kan bijvoorbeeld het volgende bevatten:
projectName
terwijl een schrijfverzoek het volgende gebruikt:
project_name
Deze conventie geldt voor de gehele API.
Zie:
https://developers.ranktracker.com/guides/concepts/
Paginering
Lijst-endpoints zijn gepagineerd, zodat applicaties efficiënt kunnen werken met grote Ranktracker-accounts.
Paginering is van toepassing op onder andere de volgende bronnen:
- Domeinen
- Trefwoorden
- Concurrenten
- Tags
De twee belangrijkste parameters zijn:
paginaper_pagina
per_page ondersteunt maximaal 1.000 records per pagina.
Informatie over paginering wordt teruggestuurd via responsheaders, waaronder:
X-Totaal-AantalX-Totaal aantal pagina’sX-Per-paginaX-Huidige-pagina
Bij grote exporten kunnen applicaties daarom doorgaan met het opvragen van pagina's totdat de volledige dataset is opgehaald.
Lees de handleiding over paginering:
https://developers.ranktracker.com/guides/pagination/
Foutafhandeling en limieten
De Ranktracker-API maakt gebruik van standaard HTTP-statuscodes om fouten programmatisch gemakkelijker te kunnen afhandelen.
Veelvoorkomende reacties zijn onder meer:
| Status | Betekenis | Voorbeeld |
|---|---|---|
400 | Ongeldig verzoek | Een vereiste parameter ontbreekt of is onjuist opgegeven |
402 | Quota overschreden | De gevraagde bewerking zou de toegestane limiet van het account overschrijden |
403 | Verboden | Het verzoek is niet geautoriseerd of er is geen toegang tot de API |
404 | Niet gevonden | De bron bestaat niet binnen het account |
422 | Validatiefout | Het verzoek is geldige JSON, maar bevat ongeldige gegevens |
429 | Te veel verzoeken | De integratie is onderworpen aan een limiet op het aantal verzoeken |
Wanneer een 429 -reactie optreedt, moeten integraties de geretourneerde Retry-After-informatie respecteren voordat ze het opnieuw proberen.
Hierdoor kunnen productieapplicaties tijdelijke beperkingen verwerken zonder dat ze simpelweg mislukken.
De volledige documentatie over fouten en verwerkingslimieten is hier beschikbaar:
https://developers.ranktracker.com/guides/errors-and-rate-limits/
Ranktracker REST API versus MCP
De REST API is niet de enige manier om externe software aan Ranktracker te koppelen.
Ranktracker biedt ook een gehoste MCP-server aan.
MCP staat voor Model Context Protocol en stelt compatibele AI-toepassingen en -agenten in staat om rechtstreeks met Ranktracker-gegevens te werken.
Hieronder vallen compatibele clients zoals:
- ChatGPT
- Claude
- Cursor
- Andere MCP-compatibele AI-toepassingen
REST en MCP maken gebruik van dezelfde onderliggende Ranktracker-gegevens, maar zijn ontworpen voor verschillende werkprocessen.
| Ranktracker REST API | Ranktracker MCP | |
|---|---|---|
| Het meest geschikt voor | Applicaties, dashboards, datawarehouses en geplande taken | AI-assistenten en -agenten |
| Caller | Uw backend of HTTP-client | ChatGPT, Claude, Cursor of een andere MCP-client |
| Interface | REST-eindpunten | MCP-tools |
| REST-pad | /v1/... | /mcp |
| Typisch gebruik | SEO-gegevens automatisch verplaatsen en beheren | SEO-gegevens op een conversatieachtige manier verkennen |
REST is bijvoorbeeld een betere keuze als u:
- Elke nacht ranglijsten exporteren
- Een BI-dashboard bijwerken
- SEO-projecten automatisch aanmaken
- Zoekwoorden toevoegen vanuit uw applicatie
- Synchroniseer ranglijstgegevens met een database
MCP is beter geschikt voor vragen zoals:
Welke van mijn bijgehouden zoekwoorden is deze week het meest gedaald?
of:
Welke concurrenten hebben de meeste zichtbaarheid gewonnen?
Een AI-client kan de juiste Ranktracker-tool selecteren en de relevante gegevens opvragen.
Veel geavanceerde SEO-teams kunnen beide gebruiken.
REST zorgt voor de infrastructuur en automatisering. MCP stelt Ranktracker-gegevens beschikbaar aan AI-agenten.
Meer informatie:
MCP-overzicht: https://developers.ranktracker.com/mcp/
Een MCP-klant aansluiten: https://developers.ranktracker.com/mcp/connect/
MCP-toolreferentie: https://developers.ranktracker.com/mcp/tools/
Wat kunt u bouwen met de Ranktracker-API?
De Ranktracker-API kan voor veel meer worden gebruikt dan alleen het weergeven van de positie van een zoekwoord.
Hieronder volgen enkele van de handigste toepassingen.
Geautomatiseerde SEO-rapportage
Een bureau kan rankinginformatie automatisch in zijn eigen rapportageplatform ophalen.
In plaats van:
Ranktracker openen
↓
CSV exporteren
↓
Spreadsheet bewerken
↓
Rapport uploaden
↓
Naar klant verzenden
kunt u het volgende opzetten:
Ranktracker API
↓
Rapportageplatform
↓
Automatisch bijgewerkt klantrapport
Dit is met name waardevol voor bureaus die grote aantallen klanten beheren.
Aangepaste SEO-dashboards
Misschien gebruikt uw bedrijf al een intern rapportage- of business intelligence-platform.
Met de API kunnen Ranktracker-gegevens een extra gegevensbron binnen die omgeving worden.
U kunt dashboards bouwen die het volgende weergeven:
- Zoekwoordposities
- Veranderingen in de ranglijst
- Top 3 zoekwoorden
- Top 10 zoekwoorden
- Top 100 zoekwoorden
- Aandeel in de aandacht
- Zichtbaarheid van concurrenten
- Functies in de SERP
- Aantal vermeldingen in AI-overzichten
Het resulterende dashboard kan specifiek worden afgestemd op de rapportagebehoeften van uw bedrijf.
Geautomatiseerde onboarding van klanten
SEO-bureaus kunnen Ranktracker koppelen aan hun onboardingproces voor klanten.
Bijvoorbeeld:
Klant koopt een SEO-pakket
↓
CRM maakt een klant aan
↓
Ranktracker API maakt een domein aan
↓
Zoekwoorden worden toegevoegd
↓
Concurrenten worden toegevoegd
↓
Het bijhouden begint
Dit maakt een einde aan repetitieve, handmatige projectconfiguratie.
SEO-datawarehouses
Rankings worden waardevoller wanneer ze worden gekoppeld aan andere marketing- en bedrijfsgegevens.
Ranktracker-informatie kan worden gecombineerd met:
- Google Search Console
- Analytics
- CRM-gegevens
- Conversiegegevens
- E-commerce-omzet
- Leadgegevens
- Prestaties van content
Dit kan helpen bij het beantwoorden van veel belangrijkere vragen dan alleen het controleren van een ranking.
Bijvoorbeeld:
Welke verbeteringen in de zoekresultaten hebben de meeste omzet opgeleverd?
of:
Welke zoekwoordgroepen zorgen voor meer zichtbaarheid, maar genereren geen conversies?
Ranglijstmeldingen
Historische positiegegevens kunnen ook worden gebruikt voor aangepaste waarschuwingssystemen.
Een integratie zou automatisch kunnen detecteren wanneer:
- Een zoekwoord valt uit de top 3
- Een pagina komt in de top 10
- Een zoekwoord komt in de top 100
- Een belangrijk zoekwoord verdwijnt uit de top 100
- Een concurrent haalt uw website in
- De zichtbaarheid in de zoekresultaten daalt sterk
Waarschuwingen kunnen vervolgens worden verzonden naar uw eigen e-mail, Slack, intern dashboard of monitoringsysteem.
Concurrentie-informatie
Door het volgende te combineren:
- Posities
- Concurrentienanalyse
- Rankingsgeschiedenis
- Share of Voice
vormt de basis voor een geautomatiseerd systeem voor SEO-monitoring van de concurrentie.
In plaats van concurrenten eens in de paar maanden te evalueren, kan hun zichtbaarheid in de zoekresultaten een continu gemonitorde indicator worden.
Programmatische SEO-monitoring
Programmatische SEO kan duizenden of honderdduizenden landingspagina's genereren.
Het is onrealistisch om die projecten handmatig te monitoren.
Met de Ranktracker-API kunnen ontwikkelaars ranking-workflows bouwen die grote datasets met zoekwoorden kunnen verwerken en de resulterende informatie automatisch naar interne analysesystemen sturen.
AI-aangedreven SEO-analyse
De REST-API en MCP-server van Ranktracker kunnen ook worden geïntegreerd in AI-gestuurde SEO-workflows.
AI-systemen kunnen bijvoorbeeld helpen bij het volgende:
- Verlies van posities identificeren
- Samenvatting van rangschikkingswijzigingen
- Zoek snel stijgende zoekwoorden
- Vergelijk de zichtbaarheid van concurrenten
- SERP-veranderingen analyseren
- Stel prioriteiten voor SEO-kansen
- Interne rapporten genereren
- Onderzoek ongebruikelijke schommelingen in de ranglijst
De API levert de gestructureerde gegevens, terwijl AI kan helpen deze te interpreteren.
Voor wie is de Ranktracker API bedoeld?
De Ranktracker-API is met name nuttig voor:
- SEO-bureaus
- SEO-teams binnen grote ondernemingen
- SaaS-bedrijven
- SEO-softwarebedrijven
- Ontwikkelaars
- Data-engineers
- BI-teams
- E-commercebedrijven
- Affiliate-marketeers
- Uitgevers
- Bedrijven met meerdere vestigingen
- Programmatische SEO-teams
- Teams voor AI-automatisering
Als rankinggegevens automatisch moeten worden opgehaald, verplaatst, geanalyseerd of beheerd, is een API doorgaans een veel schaalbaardere oplossing dan handmatige exports.
Waarom Ranktracker gebruiken in plaats van zelf een infrastructuur voor het bijhouden van zoekresultaten op te zetten?
Het op grote schaal verzamelen van zoekresultaten omvat veel meer dan alleen een Google-zoekopdracht uitvoeren.
Een productieklaar systeem voor het bijhouden van zoekresultaten moet rekening houden met:
- Locaties
- Talen
- Apparaten
- Top 100-resultatenverzameling
- SERP-functies
- AI-overzichten
- Zoekwoordconfiguratie
- Historische rankinggegevens
- Concurrenten
- Planning
- Wijzigingen in zoekresultaten
- Gegevensopslag
- Rapportage
Het intern opzetten en onderhouden van al die infrastructuur kan aanzienlijke ontwikkelingsmiddelen vergen.
Ranktracker beheert de infrastructuur voor het bijhouden van zoekresultaten en stelt de verkregen gegevens beschikbaar via een gestructureerde API.
Uw ontwikkelaars kunnen zich daardoor concentreren op het bouwen van de applicatie, het dashboard, de workflow of de analyse die uw bedrijf daadwerkelijk nodig heeft.
Aan de slag met de Ranktracker-API
Om aan de slag te gaan, zijn slechts een paar stappen nodig.
1. Open uw API-instellingen
Ga rechtstreeks naar:
https://app.ranktracker.com/account/api
Maak een API-sleutel aan en bewaar deze op een veilige plek.
2. Lees de snelstartgids
Volg de officiële snelstartgids:
https://developers.ranktracker.com/guides/quickstart/
3. Doe je eerste verzoek
Bijvoorbeeld:
curl https://api.ranktracker.com/v1/domains
-H "Authorization: tkn_usr_uw_api-sleutel_hier"
4. Bekijk de API-referentie
De volledige REST API-referentie is hier beschikbaar:
https://developers.ranktracker.com/rest-api/
5. Begin met bouwen
Vanaf daar kun je beginnen met het koppelen van Ranktracker aan:
- Uw applicatie
- Uw rapportagestack
- Uw datawarehouse
- Uw CRM
- Uw interne tools
- Uw AI-workflows
Ranktracker API-documentatie
De volledige documentatie voor ontwikkelaars is te vinden op:
Documentatie voor ontwikkelaars: https://developers.ranktracker.com/
API-sleutels aanmaken en beheren: https://app.ranktracker.com/account/api
Snelstart: https://developers.ranktracker.com/guides/quickstart/
Authenticatie: https://developers.ranktracker.com/guides/authentication/
Basisbegrippen: https://developers.ranktracker.com/guides/concepts/
Paginering: https://developers.ranktracker.com/guides/pagination/
Fouten en limieten: https://developers.ranktracker.com/guides/errors-and-rate-limits/
Gebruik en quota: https://developers.ranktracker.com/guides/usage-and-quota/
Bulkbewerkingen: https://developers.ranktracker.com/guides/bulk-operations/
Tutorial: een domein volgen: https://developers.ranktracker.com/guides/tutorials/track-a-domain/
Handleiding voor ranglijsten naar warehouse: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/
Handleiding 'Share of Voice': https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/
Handleiding voor het in bulk taggen: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/
REST API-referentie: https://developers.ranktracker.com/rest-api/
MCP-server: https://developers.ranktracker.com/mcp/
Een MCP-client verbinden: https://developers.ranktracker.com/mcp/connect/
MCP-toolreferentie: https://developers.ranktracker.com/mcp/tools/
Aan de slag met de Ranktracker API
De Ranktracker API verandert Ranktracker van een SEO-dashboard in infrastructuur die direct in uw technologiestack kan worden geïntegreerd.
U kunt deze gebruiken om domeinen en zoekwoorden te beheren, concurrenten te volgen, Top 100-ranglijsten op te halen, SERP's te analyseren, AI-overzichten te detecteren, Share of Voice te monitoren, toegang te krijgen tot historische rangschikkingsgegevens, zoekwoorden te organiseren, rapportagepijplijnen op te zetten en SEO-informatie te integreren met de rest van uw bedrijf.
Voor ontwikkelaars maakt dit het handmatig exporteren en verplaatsen van rankinggegevens overbodig.
Voor bureaus maakt het grootschalige automatisering voor klanten mogelijk.
Voor SEO-teams binnen grote ondernemingen zorgt het ervoor dat rangschikkingsinformatie onderdeel kan worden van de interne analyse- en data-infrastructuur.
Het alles-in-één platform voor effectieve SEO
Achter elk succesvol bedrijf staat een sterke SEO-campagne. Maar met talloze optimalisatietools en -technieken om uit te kiezen, kan het moeilijk zijn om te weten waar te beginnen. Nou, vrees niet meer, want ik heb precies het ding om te helpen. Ik presenteer het Ranktracker alles-in-één platform voor effectieve SEO
We hebben eindelijk de registratie voor Ranktracker helemaal gratis geopend!
Maak een gratis account aanOf log in met uw gegevens
En met de MCP-server van Ranktracker kunnen dezelfde onderliggende SEO-gegevens ook toegankelijk worden gemaakt voor AI-assistenten en -agenten.
Maak je Ranktracker API-sleutel aan: https://app.ranktracker.com/account/api
Lees de documentatie: https://developers.ranktracker.com/
Bekijk de REST API-referentie: https://developers.ranktracker.com/rest-api/

