Přejít na obsah
SEO Uptr
SEO UptrRegistrovat se

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.

Kámen most přes řeku s malou lodí plující pod ním

Akce podle kreditového nákladu

1 kredit = $0.0001. Každý hovor se účtuje jednou bez ohledu na počet řádků, až do 1 000 řádků na hovor.
NákladAkcePoznámky
Zdarma, bez klíčedomain, overview, stats, suggestVhodné pro dashboardy a kontrolu DR
1 kreditbulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr přijme až 2 000 domén (GET domains= nebo POST tělo); compare až 20
2 kredityrefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect přijme 2 až 10 domén
3 kreditysearch, keywordFull-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.

bash
# 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" ;;
esac

Parametry a chyby

PoložkaHodnotaVýznam
qdoménaCíl vyhledávání
page, perper od 10 do 5 000Stránkování; řádky na hovor jsou omezeny na 1 000, hluboké stránkování na 50 000
sort, orderorder=asc nebo descŘazení vrácených řádků
okv každé odpovědiZda byl hovor úspěšný
_creditspouze u ověřených odpovědíNáklad hovoru a zbývající zůstatek
HTTP 401chybějící nebo špatný klíčZkontrolujte klíč nebo header
HTTP 402došly kredityDobijte pomocí USDT (TRC-20)
Tesař měřící dřevo a vybírající nářadí na pracovním stole v dílně

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.

Nejprve zdarma akce

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ě.
Zahradník uspořádávající rostliny v čistých řadách na zahradě

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 overview nebo domain. Oba jsou zdarma a nepotřebují klíč, a ukazují hrubou velikost a základní tvar dat. Kredity utrácejte za refdomains nebo anchors až 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, hovor anchors a hovor tld_breakdown pro 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 page s per. 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.