Dokumentace
Přehled endpointů a cen
Jedna URL, mnoho akcí. To je celý rozsah.
Výzkumný tým SEOCheck ·

Akce a náklady
| Akce | Kredity | Co vrací |
|---|---|---|
| doména | zdarma | Základní záznam a DR pro jednu doménu |
| přehled | zdarma | Souhrn odkazového profilu domény |
| statistiky | zdarma | Statistiky pro celý index |
| doporučení | zdarma | Návrhy domén při psaní |
| bulk_dr | 1 | DR pro až 2 000 domén |
| porovnání | 1 | Vedle sebe pro až 20 domén |
| top | 1 | Nejlepší domény |
| dr_distribution | 1 | Rozložení DR mezi odkazujícími doménami |
| tld_breakdown | 1 | Odkazy podle domény nejvyššího řádu |
| refdomains | 2 | Odkazující domény |
| backlinks | 2 | Jednotlivé zpětné odkazy |
| anchors | 2 | Anchory |
| toppages | 2 | Nejvíce odkazované stránky |
| anchor_cloud | 2 | Váhy anchorů |
| intersect | 2 | Společní odkazovatelé pro 2 až 10 domén |
| search | 3 | Full-textové vyhledávání v anchorách, názvech a URL |
| keyword | 3 | Kdo je odkazován s přesným anchor textem |
Ověření a tvar
Základní URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Preferujete hlavičky? Pošlete místo toho Authorization: Bearer sk_....
Toto API pro analýzu zpětných odkazů odpovídá v JSON a umožňuje volání napříč doménami, takže ho může prohlížeč oslovit přímo. Každá odpověď má pole ok. Ověřené odpovědi také obsahují _credits, které udává cenu daného volání a váš zbývající zůstatek.
Chyby jsou přímé. HTTP 401 znamená, že klíč chybí nebo je špatný. HTTP 402 znamená, že došel zůstatek. Oba případy jsou snadno zpracovatelné a ani jeden by neměl být opakován v nekonečné smyčce.
Před prvním placeným voláním
- Spusťte
overviewna doméně, kterou znáte. Je zdarma. - Ověřte, že váš klíč funguje, pomocí jednoho volání za 1 kredit, například
compare. - Přečtěte si
_creditsv odpovědi a potvrďte, že cena odpovídá tabulce výše. - Nastavte si v skriptu upozornění na HTTP 402, aby vyčerpání zůstatku nezůstalo bez povšimnutí.
Stránkování a řazení
Počet řádků na volání jde až po 1 000. Požádejte o méně nebo více pomocí per, od 10 do 5 000, procházejte pomocí page a řaďte pomocí sort a order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Parametry, které mění výsledek
Každá akce bere stejné dva základní parametry, action a q, a pak krátkou sadu možností. Přečtěte si je nejprve. Většina chyb pramení z možností, které vypadají jako volitelné, ale mění cenu nebo tvar řádků. Přečtěte si možnosti předtím, než zkopírujete volání z fóra nebo blogu.
Níže uvedené příklady předpokládají klíč v parametru key. Nahraďte zástupný symbol svým vlastním. Uchovávejte klíč v proměnné prostředí, ne v souboru, který commitujete. Každý příklad v této dokumentaci API pro analýzu zpětných odkazů používá stejnou základní URL.
Stránkování pomocí page a per
Možnost per nastavuje, kolik řádků se vrátí, od 10 až po 5 000. Možnost page vás posouvá sadou. Volání, které požaduje 500 řádků a pak page 2, vrátí další blok, ne další sadu stejných řádků.
Hluboké stránkování končí na 50 000 řádcích. Pokud úloha potřebuje více, zúžete dotaz pomocí sort nebo rozdělte práci podle domény, aby každé volání zůstalo v rámci limitu.
Řazení pomocí sort a order
Řaďte na serveru, ne ve svém skriptu. Požadavek na sort=dr&order=desc vrátí nejsilnější odkazující domény první, takže řádky, které vás zajímají, přijdou na první stránce. Filtrace po stažení všech dat plýtvá časem i kredity.
Použijte order=asc, když chcete nejslabší řádky, například pro nalezení tenkých odkazů nebo pro odhalení náhlého poklesu v profilu.
Seznamy: bulk_dr, compare a intersect
Akce se seznamem přijmou několik domén v jednom volání. bulk_dr přijme až 2 000 domén za jeden kredit, pomocí GET query stringu nebo POST těla. compare přijme až 20 domén a intersect přijme dvě až deset.
Protože cena nezávisí na počtu řádků, dlouhý seznam v jednom volání je levnější než mnoho krátkých volání. Řekněme, že v pondělí zkontrolujete 1 500 potenciálních webů. To je jedno volání, ne 1 500.
Volání search a keyword stojí více
Akce search provádí full-textové vyhledávání v anchorách, názvech a URL. Akce keyword se ptá, kdo je odkazován s přesným anchor textem. Oba stojí tři kredity za volání, takže je používejte k odpovědi na konkrétní otázku, nikoliv k prohlížení.
Výběr per a page pro první stažení
Pro první pohled na novou doménu začněte s malým per, například 50. Uvidíte tvar řádků, názvy polí a cenu v jedné krátké odpovědi. Zvyšte per až tehdy, když víte, že řádky jsou to, co potřebujete. Stejná návyk funguje pro každou akci v tabulce výše.
Častou chybou je požádat o 5 000 řádků při prvním pokusu a pak většinu z nich zahodit. Odpověď je větší, čekání delší a úspora, na kterou jste doufali, se neobjeví.
Čtení měřiče kreditů
Každá ověřená odpověď končí _credits, který udává cenu daného volání a váš zůstatek po něm. Logujte to. Sečtěte to na konci měsíce a budete znát svou skutečnou fakturu na cent přesně.
Přibližný rozpočet pomůže. Tisíc volání refdomains stojí 2 000 kreditů, což je $0.20. Tisíc volání search stojí 3 000 kreditů, neboli $0.30. Denní běh bulk_dr na seznamu 2 000 domén stojí 1 kredit, tedy asi $0.003 měsíčně.
Ve srovnání s plány, které začínají na $129 měsíčně za 200 000 jednotek API, jak uvádí Ahrefs, je tvar faktury jiný. Přečtěte si srovnání, jak.

Čtení chyb a pole _credits
Odpověď může selhat dvěma různými způsoby a váš kód by je měl řešit odlišně. Jde o různé problémy. Špatný klíč je problém konfigurace. Prázdný zůstatek je problém fakturace. Zpracování obou jako jedné obecné chyby skryje, kterou opravu potřebujete.
Nejprve přečtěte pole ok. Pak přečtěte blok _credits. Až poté se podívejte na řádky, protože chybějící nebo krátký výsledek je snazší vysvětlit, když už víte, kolik stálo volání.
Zpracujte 401 a 402 odděleně
HTTP 401 znamená, že klíč chybí nebo je špatný. Zastavte úlohu a opravte klíč. HTTP 402 znamená, že je zůstatek vyčerpán. Dobijte ho z účtu a pokračujte. Opakování 401 nikdy nepomůže a opakování 402 bez dobití také ne.
Logujte zůstatek před a po běhu
Zapište si zůstatek _credits na začátku běhu a na konci. Rozdíl by měl odpovídat tomu, co jste očekávali od provedených volání. Větší skok znamená, že smyčka běžela častěji, než jste zamýšleli.
Pro rychlou kontrolu vynásobte počet volání jejich cenou v kreditech. Pokud je odpověď 40 a zůstatek klesl o 4 000, něco je špatně se skriptem, ne s ceníkem.
Zkontrolujte řádky, které jste požadovali
Úspěšná odpověď s méně řádky, než se očekávalo, není automaticky chybou. Malá doména může jednoduše mít málo odkazů. Porovnejte počet řádků s hodnotou per, kterou jste poslali, a mezera je otázka k zodpovězení, ne chyba k utajení.
Nejprve otestujte levná volání
Než zapojíte volání do úlohy, spusťte ho jednou ručně s nejmenšími smysluplnými možnostmi. Zkontrolujte odpověď, názvy polí a hodnotu _credits. Úloha, která selže na druhém řádku, je mnohem těžší na ladění než volání, které selhalo při prvním pokusu.
První relace s API
Čtyři volání v pořadí, aby každé další volání bylo takové, které již rozumíte. Pouze první je zdarma, a to záměrně.
Spusťte overview na doméně, kterou znáte
Je zdarma a nepotřebuje klíč. Porovnejte souhrn s tím, co vidíte v Search Console a na samotném webu, abyste věděli, jak vypadá normální odpověď.
Otestujte klíč s jedním voláním za 1 kredit
Pošlete compare se svou doménou a jedním konkurentem. Potvrďte, že pole ok je true a že _credits ukazuje cenu jednoho kreditu.
Stáhněte si 2-kreditní výpis s malým per
Požádejte o refdomains s per=50 a sort=dr. Zkontrolujte, že počet řádků a cena v kreditech odpovídají tabulce výše.
Zapište cenu do logu
Zaznamenejte zůstatek před a po. Od teď každé skript, který napíšete, začne tímto zvykem, a překvapivý účet se stane řádkem v logu místo záhadou.
Ceník
Předplacené kredity. Jeden kredit je $0.0001. Žádný předplatný model, žádné měsíční minimum.
Platba podle spotřeby
$0.10za 1 000 volání za 1 kredit
- $100 zdarma kredit při registraci
- Není potřeba karta
- Dobití pomocí USDT (TRC-20)
- Fakturováno jednou za volání, ne za řádek
Limity, které byste měli znát
Index pokrývá 181 132 097 domén a 2 774 625 913 odkazů na domény. Obnovuje se přibližně měsíčně. To je pomalejší než denní crawl.
Hluboké stránkování končí na 50 000 řádcích. Pro větší stažení zúžte dotaz pomocí sort nebo rozdělte podle domény.
Přihlášení je pouze přes Google a dobíjení je v USDT. Začněte s DR checkerem, vyzkoušejte audit konkurence s průvodcem konkurencí nebo si přečtěte proč některé týmy opouštějí API Ahrefs pro čistě link building.
FAQ
Platím za řádek?
Ne. Volání se fakturuje jednou, ať vrátí 10 řádků nebo 1 000.
Co se stane, když dojdou kredity?
API vrátí HTTP 402. Dobijte pomocí USDT (TRC-20) z účtu a pokračujte.
Kde najdu svůj klíč?
V dashboardu po přihlášení přes Google.