SEO API

Bouw eigen SEO-rapporten en automatiseringen met gestructureerde JSON uit je Screpy-projecten. Haal crawlbevindingen, zoekwoordposities, backlinks, opgeslagen AI Visibility en monitoringresultaten op via een REST API per project, met ondersteunde acties om je werk te beheren.

Lees de API-snelstart Maak een Screpy-account

Toegankelijke projecten opvragen

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Voorbeeldfragment van een antwoord. REST-toegang vereist een betaald ledenaccount; de sleutel geeft alleen eigen of gedeelde projecten terug waartoe je toegang hebt.

Authenticeer de SEO API

Maak een REST-sleutel in Instellingen → Gekoppelde apps en stuur deze vanaf je server als bearer-token. Kies de rechten die je integratie nodig heeft.

Alleen-lezen-sleutels halen data op; lees- en schrijfsleutels maken ook ondersteunde wijzigingen mogelijk.
Kopieer het geheim bij het aanmaken: het wordt maar één keer getoond. Plaats het niet in openbare browsercode.
Trek sleutels in via Gekoppelde apps. Maximaal 20 actieve sleutels zijn toegestaan; ze verlopen na één jaar.

Lees de authenticatiegids

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

Controleer API-toegang

REST vereist een betaald ledenaccount. Projectlidmaatschap en de functies waarvoor het project in aanmerking komt bepalen ook welke gegevens en acties beschikbaar zijn.

Accountendpoints tonen je abonnement, functies en aantal toegankelijke projecten.
Gebruiksrapporten bevatten functielimieten; gebruikt en resterend worden momenteel alleen voor eigen projecten berekend.
Null bij gebruik betekent een niet-beschikbare waarde, niet nul verbruik.

Bekijk accountendpoints

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

Beheer SEO-projecten

Bekijk eigen en gedeelde projecten, haal een projectoverzicht op of maak projecten binnen je limiet voor eigen projecten. Gebruik de teruggegeven project-UID's in vervolgaanvragen.

Wijzig namen, markt- en tijdzonevoorkeuren en ondersteunde crawl- of monitoringinstellingen.
Een ander domein vereist een nieuw project; gewijzigde instellingen herschrijven voltooide resultaten niet.
Bij het aanmaken worden capaciteit en sitevalidatie gecontroleerd.
Alleen de projecteigenaar mag het project verwijderen.

Bekijk projectendpoints

example.comProject

example.orgProject

example.netProject

Start websitecrawls

Start een crawl met schrijfrechten en bewaar de teruggegeven crawl-UID. De crawl draait op de achtergrond: volg de status voordat je resultaten ophaalt.

Een lopende crawl of uitgeschakelde crawler kan een nieuwe start verhinderen.
Samenvattingen en datasets vereisen een succesvol voltooide crawl; onvoltooide resultaten geven een conflict terug.
Bewaar project- en crawlreferenties samen bij rapportage of vergelijking van momentopnamen.

Bekijk crawlendpoints

1
Beoordeling/guides
Open
2
Gegenereerd/shop
Open
Voltooidexample.com
In afwachting

Haal SEO-crawldata op

Maak technische SEO-rapporten vanuit een geselecteerde voltooide crawl. Bekijk paginadetails en herleid links of afbeeldingen tot hun bronpagina's.

Pagina's bevatten HTTP-status, titels, beschrijvingen, koppen, canonicals, crawldiepte en tijden.
Linkgegevens tonen doelen, ankerteksten, nofollow-status en de bronpaginacontext.
Afbeeldingsgegevens bevatten alt-tekst, afmetingen, ophaalstatus en bronpagina's.
Gebruik ondersteunde veldfilters en gepagineerde gegevens; dit is geen volledige HTML-export of SQL-interface.

Bekijk crawldata-endpoints

/guides/seo200

Geïndexeerd

Vergelijk projecten en crawls

Vergelijk technische SEO-samenvattingen tussen projecten of voltooide crawlmomentopnamen. Bewaar expliciete crawlreferenties voor reproduceerbare vergelijkingen.

Projectvergelijkingen accepteren twee tot vijf toegankelijke projecten met de laatste voltooide crawls of gekozen momentopnamen.
Vergelijking van twee crawls geeft wijzigingen in gezondheid, pagina's en probleemaantallen als tweede min eerste.
Dit zijn samenvattingsvergelijkingen; haal crawlgegevens apart op om individuele URL's te onderzoeken.

Bekijk vergelijkingendpoints

Voor62→Na87

Haal SEO Quick Wins op

Neem geprioriteerde kansen met bron en rapportperiode op in je werkproces. Een voltooide crawlreferentie controleert toegang, maar maakt niet iedere kans tot een momentopname van die crawl.

Bij beschikbare gekoppelde data biedt Search Console kansen rond zoekvragen dicht bij topposities, CTR, kannibalisatie, dalingen en zichtbaarheidsschommelingen.
Bevindingen over interne links kunnen de nieuwste projectcrawl gebruiken die in de antwoordmetadata staat.
Verkeersbevindingen vereisen de betreffende koppeling, rechten en voldoende gegevens.
Bewaar rapporttypen, datumbereik, waarschuwingen en beschikbaarheid; een leeg rapport bewijst niet dat de site probleemloos is.

Ontdek Quick Wins

linen shirt#11

Vertoningen

2.860

Beheer rankingmonitoring

Lees opgeslagen zoekwoordzichtbaarheid, analysehistorie en rankingresultaten met markt- en apparaatcontext. Beheer gevolgde zoekwoorden in plaats van willekeurige livezoekresultaten op te vragen.

Filter zoekwoorden op zoekopdracht, apparaat en URL-gebaseerd segment, inclusief zoekwoorden zonder overeenkomst.
Voeg maximaal 100 zoekwoorden per aanvraag toe; de eerste analyse wordt ingepland en niet meteen teruggegeven.
Verwijder gevolgde zoekwoorden en bekijk, maak, wijzig of verwijder segmenten met schrijfrechten.
REST biedt geen live-SERP-opvraag, handmatige heranalyse of CSV/XLSX-export van Rank Tracker.

Bekijk Rank Tracker-endpoints

Posities

+24 Positie

Gebruik AI Visibility

Koppel opgeslagen AI-antwoorden aan merkvermeldingen, citaties en bronbewijs. Bewaar prompt-, land-, taal- en platformcontext in je eigen rapporten.

Lees overzichten, vermeldingen, antwoorden, citaties, gevolgde prompts en activiteit van brondomeinen of URL's.
Voeg binnen de projectcapaciteit maximaal 20 prompts per aanvraag toe of verwijder gevolgde prompts met schrijfrechten.
Promptsuggesties, handmatige heranalyse en AI Visibility-exports zijn geen REST-acties.

Ontdek AI Visibility

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Analyseer backlinks

Lees het backlinkprofiel van een project of een al toegevoegde concurrent uit de beschikbare opties. Koppel links aan verwijzende domeinen voor je eigen autoriteitsrapporten.

Haal overzichtsmetingen, verwijzende domeinen en backlinks van een geselecteerd domein op.
Bekijk backlinkgaten en ondersteunde datasets van verloren domeinen of domeinen met gebroken links.
Bewaar doel, filters, sortering en cursorcontext; het is geen onbeperkte zoekdienst voor ieder domein.
CSV/XLSX-tabelexports bevatten de huidige pagina. Ga verder met X-Next-Cursor.

Ontdek Backlink Checker

example.org
example.net
example.edu

example.com84 Links

Beheer disavow-gegevens

Bewaar beoordeelde domeinen of URL's met notities in het project en maak een tekstbestand in Google-formaat. Je beslist zelf over disavow.

Met schrijfrechten kun je maximaal 100 vermeldingen per aanvraag toevoegen of bestaande gegevens verwijderen.
Exporteer de disavow-tekst van het project apart van gepagineerde tabellen.
Controleer en dien het bestand handmatig in; opslaan verstuurt niets naar Google en verwijdert geen backlink.

Ontdek Disavow Management

disavow.txtBeoordeling

domain:example.org
https://example.net/links

Domeinexample.org
URLexample.net/links

Lees websitegezondheid

Scheid paginaprestaties en websitebeschikbaarheid in je rapporten. Deze endpoints leveren bestaande controles, geen nieuwe meting op aanvraag.

Prestaties geven de laatst gecontroleerde homepage met FCP, LCP, CLS, TTFB, TBT en Speed Index terug, niet iedere pagina of een volledige historie.
Uptime vat de laatste 30 dagen samen en levert maximaal de nieuwste 160 controles met status, responstijd en datum.
Ontbrekende prestaties geven data:null; zonder uptimecontroles blijven samenvattingswaarden null en de lijst leeg.

Bekijk gezondheidsendpoints

example.comLaboratorium

LCP2,1 s
TBT180 ms
CLS0,04

Pagineer SEO-data

Haal grote datasets in beheersbare pagina's op en behoud de aanvraagcontext in je verwerking. Controleer beschikbaarheid voordat je antwoorden omzet in dashboardmetingen.

Ondersteunde lijsten leveren standaard 50 en maximaal 100 gegevens; volg volgende links of ondoorzichtige cursors.
Houd filters, doelen en rapportperioden gelijk tussen pagina's. Ongeldige parameters worden afgewezen.
Behandel autorisatie-, onvoltooide crawl-, beschikbaarheids- en limietfouten expliciet in plaats van ontbrekende resultaten door nul te vervangen.

Lees de API-foutengids

JSONcursor_2

Praat over SEO API. Met SEO MCP.

Verbind je AI-assistent met je Screpy-project via SEO MCP. Kies een project, bekijk het overzicht en onderzoek ondersteunde crawl-, ranking- en zoekgegevens met afgebakende toegang.

Ontdek Screpy SEO MCP Verbind je AI-assistent

SEO API-vragen

Praktische antwoorden voor REST-toegang, gegevensverwerking en een betrouwbare integratie.

Welke API-aanvraaglimieten gelden?

Per minuut geldt een basislimiet van 300 aanvragen per sleutel en 900 per account. Zware endpoints staan daarnaast 60 per sleutel en 180 per account toe; schrijfendpoints 30 en 90. Deze controles gelden samen. Verwerk HTTP 429 en probeer opnieuw na de toegestane wachttijd.

Hoe verschillen SEO API en SEO MCP?

SEO API is voor zelfgebouwde software, met REST-aanvragen en een REST-bearersleutel. SEO MCP biedt ondersteunde tools aan compatibele AI-assistenten via Model Context Protocol en eigen autorisatie. MCP-inloggegevens authenticeren REST niet en de beschikbare acties zijn niet identiek.

Zijn alle API-resultaten actueel of live?

Nee. Crawlgegevens horen bij de gekozen momentopname; rankings en AI Visibility gebruiken opgeslagen analyses. Quick Wins volgt bron en rapportperiode. Gezondheidsendpoints leveren bestaande controles. Bewaar beschikbare tijdstempels en broncontext in rapporten.

Werkt een alleen-lezen-sleutel bij iedere POST-aanvraag?

Nee. POST-vergelijkingen van projecten en crawls accepteren lezen omdat ze bestaande data analyseren. Gegevens maken of wijzigen, crawls starten en segmenten vooraf bekijken vereist lees- en schrijfrechten. Controleer de gedocumenteerde rechten in plaats van ze uit de HTTP-methode af te leiden.

Biedt REST iedere dashboardfunctie?

Nee. De API-documentatie vermeldt ondersteunde REST-acties. Er zijn geen REST-endpoints voor Map Tracker-resultaten, artikelgeneratie, PDF-rapporten of alle ruwe analytics. Rank Tracker en AI Visibility hebben ook de hierboven beschreven actie- en exportgrenzen.

Hoe vind ik project-UID en crawl-UID?

Roep GET /projects aan, kies een toegankelijk project en haal de crawllijst op. Gebruik de teruggegeven project- en crawl-UID's samen. Samenvattings- en crawldata-endpoints vereisen een succesvol voltooide crawl.

Kan ik API-data als CSV of Excel exporteren?

Backlinktabel-endpoints ondersteunen CSV/XLSX van de huidige pagina met X-Next-Cursor voor vervolgpagina's. Disavow-tekst heeft een aparte export. CSV/XLSX-exports van Rank Tracker en AI Visibility blijven dashboardfuncties; andere gestructureerde antwoorden kunnen je eigen rapportcode voeden.

Betekent ontbrekende data dat de site geen SEO-problemen heeft?

Nee. Null-waarden, lege gegevens, waarschuwingen en beschikbaarheidsfouten hebben verschillende betekenissen. Een ontbrekende prestatiecontrole is geen websitefout en onbeschikbaar gebruik is geen nulverbruik. Controleer antwoord en inrichting voordat je conclusies trekt.