• SEO-tools

Rank Tracker API

  • Felix Rose-Collins
  • 16 min read

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

Maak kennis met Ranktracker

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 aan

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

Maak kennis met Ranktracker

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 aan

Of 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:

  • pagina
  • per_pagina

per_page ondersteunt maximaal 1.000 records per pagina.

Informatie over paginering wordt teruggestuurd via responsheaders, waaronder:

  • X-Totaal-Aantal
  • X-Totaal aantal pagina’s
  • X-Per-pagina
  • X-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:

StatusBetekenisVoorbeeld
400Ongeldig verzoekEen vereiste parameter ontbreekt of is onjuist opgegeven
402Quota overschredenDe gevraagde bewerking zou de toegestane limiet van het account overschrijden
403VerbodenHet verzoek is niet geautoriseerd of er is geen toegang tot de API
404Niet gevondenDe bron bestaat niet binnen het account
422ValidatiefoutHet verzoek is geldige JSON, maar bevat ongeldige gegevens
429Te veel verzoekenDe 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 APIRanktracker MCP
Het meest geschikt voorApplicaties, dashboards, datawarehouses en geplande takenAI-assistenten en -agenten
CallerUw backend of HTTP-clientChatGPT, Claude, Cursor of een andere MCP-client
InterfaceREST-eindpuntenMCP-tools
REST-pad/v1/.../mcp
Typisch gebruikSEO-gegevens automatisch verplaatsen en beherenSEO-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.

Maak kennis met Ranktracker

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 aan

Of 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/

Felix Rose-Collins

Felix Rose-Collins

Ranktracker's CEO/CMO & Co-founder

Felix Rose-Collins is the Co-founder and CEO/CMO of Ranktracker. With over 15 years of SEO experience, he has single-handedly scaled the Ranktracker site to over 500,000 monthly visits, with 390,000 of these stemming from organic searches each month.

Begin Ranktracker te gebruiken... Gratis!

Ontdek wat uw website belemmert in de ranking.

Maak een gratis account aan

Of log in met uw gegevens

Different views of Ranktracker app