Reference
Reference: každá akce, co stojí, jak selhává
Mějte toto otevřené, zatímco skriptujete svůj audit. Seznamuje akce, ceny, limity stránkování a dvě chyby, se kterými se pravděpodobně setkáte.

Základy před tabulkami
Endpoint je https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Klíč můžete odeslat také jako Bearer header. CORS je otevřený, takže funguje i skript v prohlížeči.
Každá odpověď má příznak ok. Autentizované odpovědi také obsahují _credits, který uvádí náklad a váš zbývající zůstatek. To usnadňuje sledování rozpočtu.
Ve srovnání s cenami Moz API Backlinks se struktura liší: Ahrefs prodává jednotky v rámci předplatného začínajícího na $129 měsíčně za 200 000 jednotek, zatímco zde platíte za každé volání z předplaceného zůstatku.
Neexistuje žádná úroveň předplatného, kterou byste museli vylepšit, ani měsíční minimum. Předplacený zůstatek znamená, že neexistuje žádný fakturační přeplatek. Jedno pravidlo platí pro všechny. Skript, který běží jednou měsíčně, a skript, který běží při každém onboardingu klienta, platí podle stejného pravidla. Noví registrovaní začínají s $100 volného kreditu, což stačí přibližně na 500 000 dvouciferných volání.
Napsání prvního skriptu bez překvapení
Začněte malým. Skript, který volá API, je snadno napsatelný a snadno přeběhne. Níže uvedená pravidla udržují první verzi poctivou.
Omezte první běh na jednu doménu. Jakmile výstup vypadá správně, rozšiřte seznam po krocích a mezi každým krokem si přečtěte zůstatek.
Stránky jsou jednotkou nákladu
Jedno volání se účtuje jednou, bez ohledu na počet vrácených řádků. Stránka, kterou načtete, je další volání, takže procházení velkého seznamu stojí jeden náklad za stránku.
Řekněme, že web má 2 500 odkazujících domén a chcete všechny. Při velikosti stránky, kterou zvolíte, je to několik volání a každé nese svůj vlastní náklad. Spočítejte stránky před spuštěním smyčky. Vyberte velikost stránky, která odpovídá otázce, protože krátký seznam potřebuje jedno volání a dlouhý stejnou péči na každé stránce.
Čtěte kredity v každé odpovědi
Každá autentizovaná odpověď obsahuje _credits, který uvádí, kolik stálo volání a co zbylo. Uložte toto pole, nikoli číslo, které jste odhadovali v hlavě.
Skript, který zapisuje zůstatek do výstupu, vám umožní zastavit před dlouhým během, který by vyčerpal účet. Udržujte kontrolu jednoduchou a viditelnou.
Použijte volná volání k otestování plánu
domain, overview, stats a suggest nepotřebují klíč a nic nestojí. Použijte je k potvrzení pravopisu domény a základního tvaru dat před spuštěním jakéhokoli placeného volání.
Teprve poté přidejte placená volání, jedno po druhém, proti stejné doméně. Chyba zachycená na volném volání nic nestojí. Uchovávejte výstupy z volných volání ve stejné složce s datem jako placené.
Volné akce a akce za jeden kredit
| Akce | Náklad | K čemu to je |
|---|---|---|
| domain | Zdarma | Rychlé vyhledání DR, volání za kontrolerem na domovské stránce |
| overview | Zdarma | Hlavní čísla pro doménu |
| stats | Zdarma | Čísla o samotném indexu |
| suggest | Zdarma | Doplňování názvů ve stylu autocomplete pro domény |
| bulk_dr | 1 kredit | Až 2 000 domén na volání, GET s domains= nebo tělem POST |
| compare | 1 kredit | Až 20 domén vedle sebe |
| top | 1 kredit | Seznam seřazený podle hodnocení z našeho indexu |
| dr_distribution | 1 kredit | Jak se DR rozkládá v sadě |
| tld_breakdown | 1 kredit | Odkazující domény seskupené podle TLD |
Akce za dva a tři kredity
| Akce | Náklad | K čemu to je |
|---|---|---|
| refdomains | 2 kredity | Domény, které odkazují na cíl |
| backlinks | 2 kredity | Jednotlivé odkazy |
| anchors | 2 kredity | Seznam anchor textů |
| toppages | 2 kredity | Stránky, které přitahují odkazy |
| anchor_cloud | 2 kredity | Slova anchor textu vážená podle použití |
| intersect | 2 kredity | Kdo odkazuje na 2–10 domén najednou, pro hledání náhradních odkazů |
| search | 3 kredity | Plnotextové vyhledávání přes anchor texty, tituly a URL |
| keyword | 3 kredity | Kdo je odkazován s přesným anchor textem |

Jedno volání se účtuje jednou, bez ohledu na počet řádků, až 1 000 řádků na volání. Použijte page a per (10–5 000) k procházení výsledků, řaďte pomocí sort plus order=asc|desc. Hluboké stránkování končí na 50 000.
Chyby, které můžete vidět
| HTTP kód | Význam | Co dělat |
|---|---|---|
| 401 | Chybějící nebo neplatný klíč | Zkontrolujte parametr key nebo header |
| 402 | Kredity došly | Doplňte pomocí USDT (TRC-20) na stránce účtu |
Když volání selže a co zkontrolovat jako první
Dvě chyby pokrývají většinu selhání v praxi. Každá má jiné řešení, takže před změnou čehokoli jiného přečtěte kód.
Selhané volání vám stále něco říká. Do protokolu si uložte URL požadavku, čas a tělo odpovědi, bez klíče.
401 znamená, že klíč není přijat
Odpověď 401 říká, že klíč chybí nebo je neplatný. Řešení spočívá v požadavku, ne v datech. Zkontrolujte parametr key nebo Bearer header a ujistěte se, že hodnota byla zkopírována kompletně. Při ladění nikdy netiskněte klíč.
Řekněme, že skript funguje na vašem laptopu, ale na serveru selže. 401 tam často znamená, že proměnná prostředí nebyla na tom stroji nikdy nastavena.
402 znamená, že zůstatek došel
Odpověď 402 znamená, že kredit je vyčerpán. V datech není nic špatně a opakování stejného volání selže stejným způsobem, dokud nedoplníte kredit.
Doplňky se provádějí v USDT na síti TRC-20 ze stránky účtu. Před dlouhým během zkontrolujte zůstatek, aby skript nezastavil polovinu seznamu. Nastavte také prahovou hodnotu varování, protože časná výstraha je mnohem levnější než zastavený audit.
Opakování bez plýtvání
Opakujte pouze chyby, které se mohou změnit, jako je timeout. 401 nebo 402 opakováno ve smyčce přidává hluk do protokolu a žádná data do auditu.
Pauza mezi pokusy a udržování selhávající domény v samostatném seznamu, abyste ji mohli znovu spustit úmyslně, nikoli náhodou. Zapište pravidlo opakování do komentáře na začátku skriptu, aby si ho další úprava udržela.
Která akce pro kterou otázku obnovy
Přizpůsobte otázku, kterou máte, nejlevnějšímu volání, které ji zodpoví.
Jak velké je poškození?
Začněte s overview, což je zdarma. Poté spusťte refdomains jednou a porovnejte ji souborem, který jste uložili minulý měsíc. Naše měsíční rutina ukazuje rozdíl.
Jak vypadají špinavé odkazy?
Použijte anchors a anchor_cloud. Podivná slova, která se opakují napříč mnoha doménami, jsou vzorem, který chytit před otevřením mýtů o disavow.
Kterí dárci stojí za hon?
intersect bere dvě až deset domén a vrací weby, které odkazují na několik z nich. Naplňte své rivaly, hledejte dárce, kteří vás přeskočili, a poté vyhodnoťte seznam pomocí bulk_dr.
Došlo k úniku při přesunu?
toppages na staré a nové doméně ukazuje, kam odkazy směřují. Průvodce migrací jej používá krok za krokem.

Jednorázový audit ve čtyřech voláních
Tento pořadí udržuje placená volání malá a každé vázané na otázku. Spusťte jej jednou na doménu, poté opakujte placená volání každý měsíc se stejnými nastaveními.
Spusťte volná volání
Začněte s overview a domain. Oba jsou zdarma a jejich výstup určuje měřítko pro každé následující placené volání.
Načtěte odkazující domény
Použijte refdomains za 2 kredity za volání. Nejprve spočítejte stránky, poté rozhodněte, kolik jich budete potřebovat.
Zkontrolujte směs anchor textů
Spusťte anchors nebo anchor_cloud za 2 kredity každé. Hledejte podivná slova, která se opakují napříč mnoha doménami.
Vyhodnoťte seznam kandidátů
Napájejte pochybné domény do bulk_dr za 1 kredit za volání, který zvládne až 2 000 domén. Udržujte skóre ve stejném souboru jako odkazující domény.
Jedno stránkované volání, anotované
Všechny parametry po akci jsou volitelné.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsFérové srovnání s alternativou Moz API Backlinks
Férová srovnání začínají stejnými jednotkami. Stránky cen často skrývají jednotku, takže si zapište, za co skutečně platíte za každou odpověď, než porovnáte celkové částky.
Na Ahrefs jsou jednotky součástí předplatného, které začíná na $129 měsíčně a kupuje 200 000 jednotek. Každý požadavek použije alespoň 50 z nich. To je past. Umístěte ji vedle ceny za volání a až pak má srovnání nějaký smysl.
Test podobný na podobné
Vyberte pět domén známé velikosti a spusťte stejné otázky přes obě služby. Porovnejte odpovědi, které potřebujete, nikoliv funkce, které obdivujete.
Řekněme, že jedna služba vrací odkazující domény v jednom volání a druhá potřebuje tři. Náklad na odpověď pak má větší význam než seznamová cena.
Ceny ve stejných jednotkách
Převeďte vše na náklad na odpověď. Naše volání jsou ceněna v kreditech po $0,0001, takže dvouciferné volání stojí $0,0002 a volné volání nic. Řekněme, že měsíční běh používá sedm kreditů. To je $0,0007, méně než desetina centu.
Zahrňte náklad na plýtvání, jako jsou opakování po selhání volání. Levné volání, které často selhává, může nakonec vyjdr dražší než dražší, které funguje napoprvé.
Kde stále vyhrává plná sada
Výzkum klíčových slov, sledování hodnocení a denní crawling jsou mimo toto API. Pokud jsou tyto vaše otázky, plná sada na ně odpoví lépe a srovnání by to mělo říct.
Použijte ledř pro otázku, kterou dobře zodpovídá: jak se posunul profil odkazů a které dárci stojí za bližší pohled. Pojmenujte mezeru ve svých poznámkách, například žádná data klíčových slov zde, aby další čtenář předpokládal, že ledř to pokrývá.