Referens
Fält för listningsbetyg, en och en
Designa din listningstabell en gång så sköter den månatliga jobbet sig självt. Här är varje länkbetygskolumn en katalog kan lagra, och den anrop som fyller den.
SEO Tools AI forskarteam ·
Kolumnerna, på en översikt
| Kolumn | Fylls av | Krediter | Uppdatera |
|---|---|---|---|
| dr | bulk_dr, upp till 2 000 domäner | 1 | Månadsvis |
| dr_checked_on | Ditt eget jobb, den dag du hämtade | 0 | Varje körning |
| ref_domains | refdomains, sorterade efter ditt val | 2 | Månadsvis, endast topplistningar |
| top_anchors | anchors | 2 | Kvartalsvis |
| top_pages | toppages | 2 | Kvartalsvis |
| overview_blob | overview (gratis, ingen nyckel) | 0 | På begäran |
| rival_overlap | intersect, 2 till 10 domäner | 2 | När du lägger till ett verktyg |
Kolumnerna som förtjänar sin plats
Börja med två. dr är sorteringsnyckeln, och dr_checked_on är ärlighetskolumnen.
Ett betyg utan datum ser ut som en fakta, och en månad senare är det en rykte. Datumet stoppar det, och det låter också ditt jobb hoppa över rader som uppdaterades en timme efter ett krasch.
Behandla allt annat som valfritt. En jämförelsesida som visar referensdomäner bredvid betyget ger läsarna ett andra nummer att kontrollera, vilket är mer användbart än ett snyggare märke. Vår backlink-analyseringsverktyg sida visar hur det ser ut mot andra kontrollverktyg.
Para ihop kolumnerna med ordlistan så att läsarna ser samma ord som du använder i backoffice, och med synk-receptet när du är redo att fylla dem.
Kolumner för de länkar en katalog ger ut
Betyg beskriver verktyget. En katalog ger också ut länkar, och de förtjänar en egen kolumn. Kataloger som ber om ett länktillbakagivande är vanliga, så frågan kommer nå dig tidigare än du tror.
Börja med ett ja-eller-nej-fält som registrerar återlänken. Innan du skriver den, kontrollera den listade webbplatsen själv, eftersom ett ihågkommen svar är det första som går fel i en lista med några hundra rader.
En kolumn för ömsesidiga länkar
Lägg till reciprocal_link som en ja-eller-nej-kolumn som säger om det listade verktygets webbplats länkar tillbaka till dig. Säg att du underhåller 300 verktyg och 40 av dem bad om en länk i gengäld. Den här kolumnen berättar vilka listningar som vilar på en tjänst, och det gör den innan en läsare frågar.
Håll kolumnen utanför betygssorteringen. Den beskriver relationen, inte verktyget, så att blanda in den i en rangordning skulle göra ordningen svårare att förklara senare.
En statuskolumn för länkar du publicerar
Registrera outbound_status med HTTP-statusen för varje länk du publicerar, plus datumet du senast kontrollerade den. En listning som returnerar en 404 är ett brutet löfte till läsaren, och ingen annan kommer att märka det för dig.
Kontrollen kan åka på samma månatliga körning som betygsuppdateringen. Du lägger till en kolumn och inget nytt schema, vilket är den billigaste underhåll en katalog kan köpa.
Skriv ner löftet du fick
När en katalog ber om en länk i gengäld, notera datumet, sidan och exakt formulering av begäran i en link_note-kolumn. En vanlig notis tar en minut att skriva och sparar en diskussion sex månader senare.
Lova inte en placering du inte kan hålla. Om återlänken aldrig läggs till är det ärliga draget att markera raden och lämna betyget ifred.
Hålla betald placering åtskild
Om en listning betalade för sin plats, lagra ett placement-värde bredvid betyget och låt inte betyget bestämma ordningen ensam. Ett högt dr får inte vara den enda anledningen till att en betald rad sitter ovanför en bättre.
Visa beteckningen för betald placering bredvid betyget, så att alla som sorterar sidan ser båda. En läsare som hittar etiketten är en läsare som fortsätter att lita på resten av listan.
De begärandeparametrar du faktiskt kommer att använda
Detta är parametrarna från API:et, i den ordning ett synkroniseringsjobb behöver dem.
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 descNamngivning och typer som åldras väl
Namnge kolumner efter vad de innehåller, inte efter en leverantör. dr är okej för vår, men om du senare lägger till en andra mätvärde, kommer dr_ours och da_moz att rädda dig från en migration.
Lagra betyget som ett heltal från 0 till 100, datumet som en ISO-sträng som 2026-10-01, och antal som heltal. En textkolumn som innehåller 1,2k är en fälla för den första personen som sorterar den.
Håll också en source-kolumn, med ett kort värde som seotoolsai. Det kostar några byte och svarar på frågan varje framtida redaktör ställer.
Varje svar bär ok. Autentiserade bär också _credits, med kostnaden för det anropet och ditt återstående saldo. Logga båda. Innan du mappar något annat fält till en kolumn, gör ett gratis domain-anrop och läs JSON:en själv.
Ställ upp tabellen i fem steg
Namnge kolumnerna först
Skriv kolumnlistan innan du rör en API-nyckel, och namnge varje kolumn för vad den innehåller. Lämna leverantörsnamn utanför kolumnnamnen, så att ett senare mätvärde inte tvingar fram en namnändring.
Gör ett gratisanrop
Kör overview för en enskild domän. Det behöver ingen nyckel, så du kan läsa JSON:en och kontrollera fältnamnen mot din tabell innan du spenderar någon kredit.
Lägg till betyget och dess datum
Lagra dr som ett heltal och dr_checked_on som ett ISO-datum. Dessa två kolumner är minimum för ett betyg en läsare kan lita på.
Testa på tjugo rader
Skicka bulk_dr för tjugo listningar du känner till. Jämför tre resultat för hand mot det gratis domain-anropet, och kör sedan hela listan.
Lägg till detaljkolumner för utvalda rader
Referensdomäner och ankare kostar 2 krediter per anrop, så hämta dem för de listningar du visar i detalj. 1-kreditbetyget kan fortfarande täcka alla andra rader.
Arbetsexempel: en hypotetisk listningspost
Detta är ett uppfunnet exempel, inte en verklig listning. Tänk dig en katalog som heter ToolShelf med en listning för en fiktiv produkt, example-seo.test.
Dess post innehåller dr 41, dr_checked_on 2026-10-01 och ref_domains 1 000. Det passar den publika formeln, eftersom log(1001) dividerat med log(20 000 000) gånger 100 avrundas till 41.
En månad senare hämtar jobbet om och hittar 1 800 referensdomäner, så betyget blir 45. Endast dr och datumet ändras. Granskningstexten, skärmdumparna och redaktörens anteckningar förblir exakt som skrivna, eftersom betyget inte rör dem.
Vilka listningar förtjänar ett betyg, och hur djupt
Inte varje listning behöver samma djup. En katalog med några hundra verktyg kan betygsätta varje rad, men detaljanropen är ett separat beslut med en separat kostnad.
Betygsätt varje rad, även de du döljer från läsarna. En dold listning behöver fortfarande ett värde när någon filtrerar backoffice, och en tom cell där ser ut som ett saknad kontroll snarare än ett val.
Två listningar på en domän
Två listningar kan dela en värd, till exempel ett verktyg och dess gratis provperiod på samma webbplats. Ett betyg tillhör en domän, så båda rader får samma dr.
Lägg till en kort textanteckning som shares domain till den andra raden. Utan den ser en redaktör två identiska nummer och antar att en av dem är ett kopieringsfel.
Samma regel täcker ett företag som driver flera verktyg under en webbplats. Varje verktyg kan förtjäna sin egen sida, men dess betyg är fortfarande betyget för domänen det bor på, så säg det i anteckningskolumnen.
Använd detaljanrop där läsarna tittar
Toppen av en kategori är där en referensdomänräkningsändring ett beslut. Börja 2-kreditanropen där och lämna den långa svansen på dr ifred.
Överväg spliten en gång om året. Listningar flyttar upp och ner på sidan, och en rad som var begraven i mars kan nu förtjäna detaljanropet.
Håll det råa svaret en gång
Håll den råa JSON:en för varje uppdatering i en textkolumn eller i en separat fil. När du ändrar vad sidan visar, bygger du om från den kopian och undviker att betala för samma rader två gånger.
Det ger dig också en post att peka på när ett betyg ser fel ut. Jämför det lagrade svaret med det aktuella innan du ändrar något betyg för hand.
Registrera ok-värdet bredvid det lagrade svaret också. En rad byggd från ett svar som inte var ok bör flaggas för en andra körning, inte lita på som ett betyg.
Kör uppdateringen i en fast ordning
En uppdatering som rör rader i en slumpmässig ordning är svår att granska. Bearbeta raderna i den ordning de visas på sidan, och skriv körningens första och sista domän i loggen.
Om jobbet stannar mitt i, berättar loggen var du ska återuppta. Rader som redan bär denna månads datum kan hoppas över, och inget betalas för två gånger.
Frågor om fält
Ska jag lagra den råa JSON:en för varje listning?
Ja, en gång per uppdatering. Håll det i en enda text- eller JSON-kolumn, härled sedan dr och de andra visningsfälten från det. När du ändrar vad du visar kan du bygga om sidor utan att anropa API:et igen och betala två gånger.
Vad händer om en domän inte finns i indexet?
Gissa inte ett betyg. Lämna dr-cellen tom och visa inget märke för den listningen. Vårt index innehåller 181 132 097 domäner, vilket är stort men inte hela webben, och en tom är mer ärlig än en nolla.
Behöver jag alla dessa fält på den publika sidan?
Nej. Visa betyget och dess datum, och kanske referensdomäner för utvalda listningar. Håll resten i backoffice för sortering, granskning och upptäckt av listningar vars nummer hoppar mellan månader.