Naar de inhoud springen
SEO Tools AI
SEO Tools AIAanmelden

Referentie

Velden voor de score van toolvermeldingen, één voor één

Ontwerp je vermeldingentabel één keer en de maandelijkse taak voert zichzelf uit. Hieronder vind je elke link-scorekolom die een directory kan opslaan, en de call die deze invult.

SEO Tools AI onderzoeksteam ·

De kolommen in één oogopslag

Kosten zijn per call, niet per rij. Eén call retourneert maximaal 1.000 rijen.
KolomIngevuld doorCreditsVerversen
drbulk_dr, tot 2.000 domeinen1Maandelijks
dr_checked_onJouw eigen taak, op de dag dat je het ophaalde0Bij elke run
ref_domainsrefdomains, gesorteerd op jouw keuze2Maandelijks, alleen topvermeldingen
top_anchorsanchors2Kwartaallijks
top_pagestoppages2Kwartaallijks
overview_bloboverview (gratis, geen key nodig)0Op verzoek
rival_overlapintersect, 2 tot 10 domeinen2Wanneer je een tool toevoegt

De kolommen die hun ruimte verdienen

Begin met twee. dr is de sortersleutel, en dr_checked_on is de kolom voor eerlijkheid.

Een score zonder datum lijkt een feit, en een maand later is het een gerucht. De datum voorkomt dat, en het stelt je taak ook in staat rijen over te slaan die een uur geleden zijn verfrist na een crash.

Behandel alles anders als optioneel. Een vergelijkingsite die verwijzende domeinen naast de rating toont, geeft lezers een tweede nummer om te kruiscontrollen, wat nuttiger is dan een mooier badge. Onze backlink analyse tool pagina laat zien hoe dat eruitziet in vergelijking met andere checkers.

Koppel de kolommen aan de glossary zodat lezers dezelfde woorden zien die je in de backoffice gebruikt, en aan het sync recipe wanneer je klaar bent om ze in te vullen.

Kolommen voor de links die een directory uitdeelt

Scores beschrijven de tool. Een directory deelt ook links uit, en die verdienen een eigen kolom. Catalogi die om een teruglink vragen zijn gebruikelijk, dus de vraag zal je eerder bereiken dan je denkt.

Begin met een ja/nee-veld dat het teruglink registreert. Voordat je het schrijft, controleer je de vermeldde site zelf, want een onthouden antwoord is het eerste dat fout gaat in een lijst van een paar honderd rijen.

Een kolom voor wederzijdse links

Voeg reciprocal_link toe als een ja/nee-kolom die aangeeft of de site van de vermeldde tool teruglinkt naar jou. Stel dat je 300 tools beheert en 40 ervan vroeg om een link terug. Die kolom vertelt je welke vermeldingen op een gunst rusten, en dat doet het voordat een lezer het vraagt.

Houd de kolom buiten de score-sorteervolgorde. Het beschrijft de relatie, niet de tool, dus het mengen ervan in een ranking zou de volgorde later moeilijker maak om uit te leggen.

Een statuskolom voor links die je publiceert

Registreer outbound_status met de HTTP-status van elke link die je publiceert, plus de datum waarop je het voor het laatst controleerde. Een vermelding die een 404 retourneert is een gebroken belofte aan de lezer, en niemand anders zal het voor je opmerken.

De check kan plaatsvinden tijdens dezelfde maandelijkse run als de scoreverfrissing. Je voegt één kolom toe en geen nieuw schema, wat het goedkoopste onderhoud is dat een directory kan kopen.

Schrijf de belofte op die je hebt gekregen

Wanneer een catalogus om een link terug vraagt, noteer dan de datum, de pagina en de exacte bewoording van het verzoek in een link_note-kolom. Een gewone notitie kost een minuut om te schrijven en bespaart een discussie zes maanden later.

Belofte geen plaatsing toe die je niet kunt nakomen. Als het teruglink nooit wordt toegevoegd, is de eerlijke zet de rij markeren en de score met rust laten.

Betaalde plaatsing gescheiden houden

Als een vermelding heeft betaald voor zijn plek, sla dan een placement-waarde op naast de score en laat de score de volgorde niet alleen bepalen. Een hoge dr mag niet de enige reden zijn waarom een betaalde rij boven een betere staat.

Toon de betaalde vlag naast de score, zodat iedereen die de pagina sorteert beide ziet. Een lezer die het label ziet, is een lezer die de rest van de lijst blijft vertrouwen.

De request parameters die je daadwerkelijk zult gebruiken

Dit zijn de parameters uit de API, in de volgorde die een sync-taak nodig heeft.

text
action   what to do: domain, overview, bulk_dr, refdomains, anchors ...
q        one domain, for single-domain actions
domains  comma list, for bulk_dr (GET) or send it as a POST body
key      your sk_ key, or use the Authorization: Bearer header
page     which page of rows
per      rows per page, 10 to 5000, up to 1,000 rows per billed call
sort     column to sort by
order    asc or desc

Naamgeving en types die goed verouderen

Noem kolommen naar wat ze bevatten, niet naar een leverancier. dr is prima voor onze, maar als je later een tweede metric toevoegt, zullen dr_ours en da_moz je een migratie besparen.

Sla de rating op als een integer van 0 tot 100, de datum als een ISO-string zoals 2026-10-01, en tellers als integers. Een tekstkolom die 1,2k bevat is een val voor de eerste persoon die erop sorteert.

Houd ook een source-kolom bij, met een korte waarde zoals seotoolsai. Het kost een paar bytes en beantwoordt de vraag die elke toekomstige editor stelt.

Twee response velden waarop je kunt vertrouwen

Elke response bevat ok. Geauthenticeerde bevatten ook _credits, met de kosten van die call en je resterende saldo. Log beide. Voordat je een ander veld naar een kolom mapt, doe je één gratis domain-call en lees je de JSON zelf.

Stel de tabel in vijf stappen in

01

Noem eerst de kolommen

Schrijf de kolomlijst voordat je een API-key aanraakt, en noem elke kolom naar wat deze bevat. Laat leveranciersnamen buiten de kolomnamen, zodat een latere metric geen hernoeming afdwingt.

02

Doe één gratis call

Voer overview uit voor één domein. Het heeft geen key nodig, dus je kunt de JSON lezen en de veldnamen controleren tegen je tabel voordat je credit uitgeeft.

03

Voeg de score en de datum toe

Sla dr op als een integer en dr_checked_on als een ISO-datum. Die twee kolommen zijn het minimum voor een score die een lezer kan vertrouwen.

04

Test op twintig rijen

Stuur bulk_dr voor twintig vermeldingen die je kent. Vergelijk drie resultaten handmatig met de gratis domain-actie, en voer pas de volledige lijst uit.

05

Voeg detailkolommen toe voor uitgelichte rijen

Verwijzende domeinen en anchors kosten 2 credits per call, dus haal ze op voor de vermeldingen die je in detail toont. De score van 1 credit kan nog steeds elke andere rij dekken.

Werkvoorbeeld: een hypothetisch vermeldingsrecord

Dit is een verzonnen voorbeeld, geen echte vermelding. Stel je een directory genaamd ToolShelf voor met een vermelding voor een fictief product, example-seo.test.

Het record bevat dr 41, dr_checked_on 2026-10-01 en ref_domains 1.000. Dat past bij de publieke formule, omdat log(1001) gedeeld door log(20.000.000) vermenigvuldigd met 100 afrondt naar 41.

Een maand later haalt de taak opnieuw op en vindt 1.800 verwijzende domeinen, dus de rating wordt 45. Alleen dr en de datum veranderen. De reviewtekst, de screenshots en de notities van de editor blijven precies zoals geschreven, omdat de score ze niet aanraakt.

Welke vermeldingen verdienen een score, en hoe diep

Niet elke vermelding heeft dezelfde diepte nodig. Een directory met een paar honderd tools kan elke rij scoren, maar de detailcalls zijn een aparte beslissing met een aparte kosten.

Score elke rij, zelfs degenen die je voor lezers verbergt. Een verborgen vermelding heeft nog steeds een waarde nodig wanneer iemand in de backoffice filtert, en een lege cel daar ziet eruit als een gemiste check in plaats van een keuze.

Twee vermeldingen op één domein

Twee vermeldingen kunnen één host delen, bijvoorbeeld een tool en zijn gratis proefversie op dezelfde site. Een score behoort tot een domein, dus beide rijen krijgen dezelfde dr.

Voeg een korte tekstnotitie toe zoals shares domain aan de tweede rij. Zonder dat ziet een editor twee identieke getallen en neemt aan dat een van hen een kopieerfout is.

Dezelfde regel geldt voor een bedrijf dat meerdere tools onder één site runt. Elke tool kan zijn eigen pagina verdienen, maar de score is nog steeds de score van het domein waar het op leeft, dus zeg dat in de notitiekolom.

Besteed detailcalls waar lezers kijken

De bovenkant van een categorie is waar een telling van verwijzende domeinen een beslissing verandert. Begin daar met de 2-credit calls en laat de lange staart met rust op dr.

Herzie de verdeling een keer per jaar. Vermeldingen bewegen omhoog en omlaag op de pagina, en een rij die in maart begraven was, verdient nu misschien de detailcall.

Houd de ruwe response één keer bij

Bewaar de ruwe JSON voor elke verfrissing in één tekstkolom of in een apart bestand. Wanneer je verandert wat de pagina toont, bouw je opnieuw vanuit die kopie en voorkom je dat je voor dezelfde rijen betaalt.

Het geeft je ook een record om naar te wijzen wanneer een rating verkeerd lijkt. Vergelijk de opgeslagen response met de huidige voordat je een score handmatig wijzigt.

Registreer ook de ok-waarde naast de opgeslagen response. Een rij die is gebouwd uit een response die niet ok was, moet worden gemarkeerd voor een tweede run, niet vertrouwd als een score.

Voer de verfrissing in een vaste volgorde uit

Een verfrissing die rijen in willekeurige volgorde aanraakt, is moeilijk te auditen. Verwerk de rijen in de volgorde zoals ze op de pagina verschijnen, en schrijf het eerste en laatste domein van de run in de log.

Als de taak halverwege stopt, vertelt de log je waar je moet hervatten. Rijen die al de datum van deze maand dragen, kunnen worden overgeslagen, en niets wordt twee keer betaald.

Vragen over velden

Moet ik de ruwe JSON voor elke vermelding opslaan?

Ja, één keer per verfrissing. Houd het in één tekst- of JSON-kolom, en leid daaruit dr en de andere weergavevelden af. Wanneer je verandert wat je toont, kun je pagina's opnieuw bouwen zonder opnieuw de API aan te roepen en twee keer te betalen.

Wat gebeurt er als een domein niet in de index zit?

Gok niet een score. Laat de dr-cel leeg en toon geen badge voor die vermelding. Onze index bevat 181.132.097 domeinen, wat groot is maar niet het hele web, en een lege waarde is eerlijker dan een nul.

Moet ik al deze velden op de publieke pagina hebben?

Nee. Toon de rating en de datum, en misschien verwijzende domeinen voor uitgelichte vermeldingen. Houd de rest in de backoffice voor sorteren, auditen en het spotten van vermeldingen waarvan de getallen tussen maanden springen.