Přejít na obsah
SEOCheck
SEOCheckRegistrovat se

Dokumentace

Přehled endpointů a cen

Jedna URL, mnoho akcí. To je celý rozsah.

Výzkumný tým SEOCheck ·

Pevný kamenný most přes mlhavé údolí představující spolehlivý endpoint API

Akce a náklady

AkceKredityCo vrací
doménazdarmaZákladní záznam a DR pro jednu doménu
přehledzdarmaSouhrn odkazového profilu domény
statistikyzdarmaStatistiky pro celý index
doporučenízdarmaNávrhy domén při psaní
bulk_dr1DR pro až 2 000 domén
porovnání1Vedle sebe pro až 20 domén
top1Nejlepší domény
dr_distribution1Rozložení DR mezi odkazujícími doménami
tld_breakdown1Odkazy podle domény nejvyššího řádu
refdomains2Odkazující domény
backlinks2Jednotlivé zpětné odkazy
anchors2Anchory
toppages2Nejvíce odkazované stránky
anchor_cloud2Váhy anchorů
intersect2Společní odkazovatelé pro 2 až 10 domén
search3Full-textové vyhledávání v anchorách, názvech a URL
keyword3Kdo 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 overview na 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 _credits v 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.

bash
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'
Zahradník pečlivě stříhající bonsai speciálními nůžkami ilustrující přesné úpravy

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.

Pár vintage mosazných vah vyvažujících dvě odlišné závaží představující různé typy chyb

Č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ě.

01

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ěď.

02

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.

03

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.

04

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.

Bezplatné akce

$0

  • domain, overview, stats, suggest
  • Není potřeba klíč
  • Pohání web checker
Otevřít checker

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
Získejte $100 zdarma

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.