Reference
Reference k API backlinků: akce, náklady a chyby
Jedna stránka s fakty, které monitor potřebuje: kolik stojí každá akce, jak funguje stránkování a co API dělá, když něco selže.

Akce podle kreditového nákladu
| Náklad | Akce | Poznámky |
|---|---|---|
| Zdarma, bez klíče | domain, overview, stats, suggest | Vhodné pro dashboardy a kontrolu DR |
| 1 kredit | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr přijme až 2 000 domén (GET domains= nebo POST tělo); compare až 20 |
| 2 kredity | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect přijme 2 až 10 domén |
| 3 kredity | search, keyword | Full-textové vyhledávání v anchor textech, titulkách a URL; keyword zjistí, kdo je odkazován přes přesný anchor text |
Ověření a stavové kódy
Klíč předávejte jako key= nebo jako bearer header. Před parsováním těla odpovědi zkontrolujte HTTP kód.
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacParametry a chyby
| Položka | Hodnota | Význam |
|---|---|---|
q | doména | Cíl vyhledávání |
page, per | per od 10 do 5 000 | Stránkování; řádky na hovor jsou omezeny na 1 000, hluboké stránkování na 50 000 |
sort, order | order=asc nebo desc | Řazení vrácených řádků |
ok | v každé odpovědi | Zda byl hovor úspěšný |
_credits | pouze u ověřených odpovědí | Náklad hovoru a zbývající zůstatek |
| HTTP 401 | chybějící nebo špatný klíč | Zkontrolujte klíč nebo header |
| HTTP 402 | došly kredity | Dobijte pomocí USDT (TRC-20) |

Návrh hovoru před naplánováním
Většina problémů s API začíná v požadavku. Ne v odpovědi. Integrace seo backlinks api je většinou souborem malých rozhodnutí před prvním hovorem. Nejprve vyřešte klíč, velikost stránky a pořadí řazení.
Udržujte klíč mimo skript
Uložte klíč do proměnné prostředí nebo úložiště tajných klíčů, ne do souboru, který commitujete. Předávejte jej jako parametr key nebo jako bearer header. Header drží klíč mimo adresy, které se často dostávají do logů.
Nepaste živý klíč do ticketu nebo chatu. Považujte klíč, který se objeví ve sdíleném logu, za odhalený.
Zvolte velikost stránky záměrně
Parametr per běží od 10 do 5 000, ale hovor se účtuje jednou až pro 1 000 řádků, takže větší stránky znamenají méně poplatků. Řekněme, že potřebujete 3 400 řádků. To vyžaduje čtyři hovory po 1 000 řádcích, nikoliv 340 hovorů po 10.
Udržujte velikost stránky stejnou napříč běhy, aby se soubory překrývaly.
Připněte pořadí řazení
Nastavte sort a order explicitně místo spoléhání na výchozí hodnotu. Identické parametry dělají výstup srovnatelným týden po týdnu, takže diff ukáže skutečnou změnu a ne jen přehozené řádky.
Změněné pořadí je snadný způsob, jak vytvořit falešný poplach.
Čtení čísel
Data pocházejí z našeho vlastního link grafu: 181 132 097 domén, 2 774 625 913 odkazů mezi doménami a přibližně 798,5 miliardy backlinků. Obnovuje se přibližně jednou měsíčně. Jakákoli data novější než tato v něm nejsou, proto je API seo backlinks api nejlepší volat týdně.
DR je round(100 · log(ref_domains+1) / log(2·10^7)). Je to logaritmus. Díky tomu 100 odkazujících domén skóruje 27, 1 000 skóruje 41 a 10 000 skóruje 55, takže zdvojnásobení počtu odkazů přidá jen několik bodů. Používejte DR pro hodnocení webů vůči sobě a hrubý počet pro výstrahy, jak to dělá tabele závažnosti.
Cenová politika je předplacená. Neexistuje předplatné ani minimum. Úvodní kredit je $100, což je 1 000 000 kreditů. Srovnejte to s jednotkami API Ahrefs, prodávanými v plánech od $129/měsíc za 200 000 jednotek, s minimálně 50 jednotkami na požadavek.
Plánování nákladů je jednoduchá násobilka. Týdenní hovor refdomains pro jeden web stojí 2 kredity krát 4, což je 8 kreditů měsíčně, což je $0,0008. Deset webů stojí desetkrát více. Recept na ztracené odkazy a úkol konkurence používají pouze akce z tabulky výše.
Čtení chyby bez hádání
Kód chyby vám říká, kdo musí jednat. Čtěte ho tímto způsobem. Odpověď se pak stává rozhodnutím o směrování, ne záhadou. Dva kódy, které jsou pro monitor nejdůležitější, jsou 401 a 402.
401 a 402 jsou různé problémy
401 znamená, že klíč chybí nebo je špatný, a dokud to někdo neopraví, nic neprojde. 402 znamená, že na účtu došly kredity, a dobití to vyřeší. Směrujte je k různým odpovědným osobám, aby zprávu viděl ten správný člověk.
Pošlete obě zprávy člověku. Monitor, který selže tiše, je horší než ten, který nikdy neběžel.
Zkontrolujte stav před tělem
Nejprve přečtěte HTTP status a poté pole ok. Odpověď může být parsovatelná jako JSON a přesto obsahovat selhání, takže kontrola je kompletní, až když obě projdou. Logujte status při každém běhu, včetně úspěšných.
Opakujte pouze to, co se může obnovit
Opakování 401 plýtvá hovory a zaplňuje logy stejnou chybou. Síťový timeout je jiný. Opakujte jej několikrát s pauzou mezi pokusy, poté přestaňte.
Běh, který se zastaví a upozorní, je užitečnější než smyčka opakování, která skryje selhání, dokud nedojdou kredity.
Logujte status při každém běhu
Zapisujte HTTP status a zůstatek do logu při každém běhu, včetně úspěšných. Když běh selže o tři týdny později, tato řádka bude první věc, kterou budete chtít vidět.
domain, overview, stats a suggest nepotřebují klíč a nic nestojí. Použijte je k ověření názvu domény, přesného pravopisu nebo hrubé velikosti, než utratíte jediný kredit za placenou akci.
Před zařazením hovoru do cronu
- Náklad akce je známý a násobí se počtem běhů za měsíc.
- Kontroluje se exit code i HTTP status.
- 402 posílá upozornění člověku.
- Odpovědi se ukládají seřazené, aby diffy zůstaly čisté.
- Frekvence odpovídá měsíční obnově.

Poznámky k stránkování
Pořadí má význam. Používejte per=1000 pro snímky a udržujte stejné sort a order každý týden. Pokud se pořadí mezi běhy změní, diff ukáže šum. To je klasická příčina falešných poplachů.
Větší weby? Pro web s více než 1 000 odkazujícími doménami procházejte stránkováním s page=1, page=2 a tak dále. Každá stránka je samostatný účtovaný hovor. Hluboké stránkování je omezeno na 50 000 řádků, což pokrývá téměř všechny běžné weby.
Otázky k referenci
- Kterou akci mám zavolat první, když si nejsem jistý, jak doména vypadá?
- Začněte s
overviewnebodomain. Oba jsou zdarma a nepotřebují klíč, a ukazují hrubou velikost a základní tvar dat. Kredity utrácejte zarefdomainsneboanchorsaž poté. - Kolik stojí úplná kontrola jedné domény?
- Sečtěte kredity každé akce a poté násobte, jak často běží. Představte si hovor
refdomains, hovoranchorsa hovortld_breakdownpro jednu doménu týdně. To je 2 + 2 + 1 = 5 kreditů na běh, což je $0,0005. Za čtyři týdny to vyjde na přibližně $0,002. - Proč se mohou neshodovat dva počty pro stejnou doménu?
- Srovnejte podobné s podobným: stejná akce, stejné parametry a stejné období obnovy. Počty z různých akcí nejsou zaměnitelné a počet získaný během obnovy se může lišit od toho získaného o týden později.
- Jak otestuji cron úlohu bez utrácení kreditů?
- Nejprve spusťte zdarma akce k ověření zapojení, zpracování statusu a formátu výstupu. Poté proveďte jeden placený hovor k ověření čísel a omezte úlohu na jeden běh během testování.
- Funguje stránkování pro web s více než 1 000 odkazujícími doménami?
- Ano. Použijte
pagesper. Každá stránka je samostatný účtovaný hovor a hluboké stránkování je omezeno na 50 000 řádků, což pokrývá většinu běžných webů.
Monitor, který přežije špatný týden
Monitor si získá důvěru v týdnech, kdy se nedaří nic. Počítejte s pomalou odpovědí, změněným zůstatkem a částečným výsledkem před prvním během. To jsou běžné události. Každá z nich by měla zanechat jasnou řádku v logu.
Časy a částečné tahy
Nastavte timeout na každý hovor, aby jedna pomalá odpověď nemohla držet celý úkol otevřený. Pokud selže stránka vícestránkového tahu, zaznamenejte, o kterou stránku šlo, a restartujte od tamtoho. Tím se vyhnete placení dvakrát za řádky, které již máte.
Označte částečný soubor jako částečný, místo abyste ho uložili jako běžný snímek. Jinak další diff ukáže ztrátu, která nikdy nenastala.
Kontroly zůstatku
Přečtěte si _credits při každé ověřené odpovědi a zapište zbývající zůstatek do logu. Malý skript může porovnat zůstatek s dolní hranicí, kterou si zvolíte, a poslat varování před dalším během.
Řekněme, že dolní hranice je 500 kreditů. Týdenní běh, který stojí 40 kreditů, nechává prostor na dobití, než přijde 402 uprostřed noci.
Udržujte každý úlohu nudnou
Dejte každému úkolu jeden soubor a jedno naplánování. Cron záznam, který dělá tři věci, může selhat třemi způsoby, a log nemusí vždy říct, který se stal. Dva malé úkoly jsou snazší důvěřovat než jeden chytrý.
Přizpůsobte naplánování obnově
Přizpůsobte naplánování úkolu měsíční obnově, nikoliv hodinám. Denní běh vrací stejný soubor většinu dní, což přidává náklady a šum bez přidání informací. Týdně je obvykle dost.