Documentazione
Riferimento endpoint e prezzi
Un URL, molte azioni. Questa è l'intera superficie.
Team di ricerca SEOCheck ·

Azioni e costi
| Azione | Crediti | Cosa restituisce |
|---|---|---|
| domain | gratuito | Record base e DR per un dominio |
| overview | gratuito | Riepilogo del profilo link di un dominio |
| stats | gratuito | Statistiche su tutto l'indice |
| suggest | gratuito | Suggerimenti di dominio durante la digitazione |
| bulk_dr | 1 | DR per fino a 2.000 domini |
| compare | 1 | Confronto affiancato per fino a 20 domini |
| top | 1 | Domini principali |
| dr_distribution | 1 | Distribuzione del DR tra i domini linkanti |
| tld_breakdown | 1 | Link per dominio di primo livello |
| refdomains | 2 | Domini linkanti |
| backlinks | 2 | Backlink individuali |
| anchors | 2 | Testi anchor |
| toppages | 2 | Pagine più linkate |
| anchor_cloud | 2 | Pesi degli anchor |
| intersect | 2 | Linkanti condivisi per 2-10 domini |
| search | 3 | Ricerca full-text su anchor, titoli e URL |
| keyword | 3 | Chi è linkato con un anchor esatto |
Autenticazione e struttura
URL base: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Preferisci le intestazioni? Invia invece Authorization: Bearer sk_....
Questa API di analisi dei backlink risponde in JSON e permette chiamate cross-origin, quindi un browser può chiamarla direttamente. Ogni risposta include un campo ok. Quelle autenticate includono anche _credits, che indica il costo di quella chiamata e il tuo saldo residuo.
Gli errori sono espliciti. HTTP 401 significa che la chiave manca o è errata. HTTP 402 significa che il saldo è esaurito. Entrambi sono facili da gestire e non dovrebbero essere ritentati in un ciclo.
Prima della prima chiamata a pagamento
- Esegui
overviewsu un dominio che conosci. È gratuito. - Verifica che la tua chiave funzioni con una chiamata da 1 credito, come
compare. - Leggi
_creditsnella risposta e conferma che il costo corrisponda alla tabella sopra. - Imposta un allarme script per HTTP 402 in modo che un saldo esaurito non fallisca in silenzio.
Paginazione e ordinamento
Le righe per chiamata arrivano fino a 1.000. Richiedi meno o più con per, da 10 a 5000, scorri con page e ordina con sort e 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'
Parametri che modificano la risposta
Ogni azione richiede le stesse due basi, action e q, e poi un breve set di opzioni. Leggile prima. La maggior parte degli errori deriva da opzioni che sembrano opzionali ma modificano il costo o la struttura delle righe. Leggi le opzioni prima di copiare una chiamata da un forum o un blog.
Gli esempi seguenti presuppongono una chiave nel parametro key. Sostituisci il segnaposto con la tua. Tieni la chiave in una variabile d'ambiente, non in un file che fai commit. Ogni esempio in questo riferimento API di analisi dei backlink utilizza lo stesso URL base.
Paginazione con page e per
L'opzione per imposta quante righe vengono restituite, da 10 a 5000. L'opzione page ti fa scorrere attraverso l'insieme. Una chiamata che richiede 500 righe e poi page 2 restituisce il blocco successivo, non il prossimo set delle stesse righe.
La paginazione profonda si ferma a 50.000 righe. Se un lavoro richiede più di quello, restringi la query con sort o dividi il lavoro per dominio, in modo che ogni chiamata rimanga entro il limite.
Ordinamento con sort e order
Ordina sul server, non nel tuo script. Richiedere sort=dr&order=desc restituisce i domini linkanti più forti per primi, in modo che le righe che ti interessano arrivino nella prima pagina. Filtrare dopo un download completo spreca tempo e crediti.
Usa order=asc quando vuoi le righe più deboli, ad esempio per trovare link sottili o individuare un calo improvviso in un profilo.
Liste: bulk_dr, compare e intersect
Le azioni di elenco richiedono diversi domini in una chiamata. bulk_dr accetta fino a 2.000 domini per un credito, con una query string GET o un body POST. compare accetta fino a 20 domini e intersect ne accetta da due a dieci.
Poiché il prezzo non dipende dal numero di righe, un lungo elenco in una chiamata è più economico di molte chiamate brevi. Supponi di verificare 1.500 siti prospect lunedì. È una chiamata, non 1.500.
Le chiamate di ricerca e keyword costano di più
L'azione search esegue una ricerca full-text su anchor, titoli e URL. L'azione keyword chiede chi è linkato con un anchor esatto. Entrambe costano tre crediti per chiamata, quindi usale per rispondere a una domanda specifica piuttosto che per navigare.
Scegliere per e page per un primo recupero
Per una prima occhiata a un nuovo dominio, inizia con un per piccolo, come 50. Vedrai la struttura delle righe, i nomi dei campi e il costo in una breve risposta. Aumenta per solo quando sai che le righe sono ciò di cui hai bisogno. Lo stesso abitudine vale per ogni azione nella tabella sopra.
Un errore comune è richiedere 5000 righe al primo tentativo e poi scartarne la maggior parte. La risposta è più grande, l'attesa è più lunga e il risparmio sperato non si manifesta.
Lettura del contatore dei crediti
Ogni risposta autenticata termina con _credits, che fornisce il costo di quella chiamata e il tuo saldo dopo di essa. Registratelo. Somma alla fine del mese e conoscerai la tua fattura reale al centesimo.
Un budget approssimativo aiuta. Mille chiamate refdomains costano 2.000 crediti, ovvero $0,20. Mille chiamate search costano 3.000 crediti, ovvero $0,30. Un'esecuzione giornaliera bulk_dr su un elenco di 2.000 domini costa 1 credito, quindi circa $0,003 al mese.
Rispetto ai piani che partono da $129 al mese per 200.000 unità API, come elencato da Ahrefs, la forma della fattura è diversa. Vedi il confronto per come.

Lettura degli errori e del campo _credits
Una risposta può fallire in due modi diversi e il tuo codice dovrebbe gestirli in modo diverso. Sono problemi diversi. Una chiave errata è un problema di configurazione. Un saldo vuoto è un problema di fatturazione. Gestirli entrambi come un errore generico nasconde la correzione necessaria.
Leggi prima il campo ok. Poi leggi il blocco _credits. Solo dopo dovresti guardare le righe, perché un risultato mancante o breve è più facile da spiegare quando sai già quanto è costata la chiamata.
Gestisci 401 e 402 separatamente
HTTP 401 significa che la chiave manca o è errata. Ferma il lavoro e correggi la chiave. HTTP 402 significa che il saldo è esaurito. Ricarica dalla pagina dell'account, poi continua. Il ritento di un 401 non aiuta mai, e il ritento di un 402 senza ricarica non aiuta mai.
Registra il saldo prima e dopo un'esecuzione
Annota il saldo _credits all'inizio di un'esecuzione e alla fine. La differenza dovrebbe corrispondere a quanto ti aspettavi dalle chiamate effettuate. Un salto maggiore significa che un ciclo è stato eseguito più spesso del previsto.
Per un controllo rapido, moltiplica il numero di chiamate per il loro costo in crediti. Se la risposta è 40 e il saldo è sceso di 4.000, qualcosa non va nello script, non nell'elenco dei prezzi.
Controlla le righe che hai richiesto
Una risposta riuscita con meno righe del previsto non è automaticamente un errore. Un dominio piccolo potrebbe semplicemente avere pochi link. Confronta il numero di righe con il valore per che hai inviato e tratta un gap come una domanda a cui rispondere, non un difetto da nascondere.
Testa prima le chiamate economiche
Prima di collegare una chiamata a un lavoro, eseguila una volta manualmente con le opzioni più piccole ragionevoli. Controlla la risposta, i nomi dei campi e il valore _credits. Un lavoro che si interrompe alla seconda riga è molto più difficile da debuggare di una chiamata fallita al primo tentativo.
Una prima sessione con l'API
Quattro chiamate, in ordine, in modo che ogni chiamata successiva sia una che già comprendi. Solo la prima è gratuita, ed è intenzionale.
Esegui overview su un dominio che conosci
È gratuito e non richiede una chiave. Confronta il riepilogo con ciò che vedi nella search console e sul sito stesso, in modo da sapere come appare una risposta normale.
Testa la chiave con una chiamata da 1 credito
Invia compare con il tuo dominio e un concorrente. Conferma che il campo ok sia true e che _credits mostri un costo di un credito.
Recupera un elenco da 2 crediti con un per piccolo
Richiedi refdomains con per=50 e sort=dr. Verifica che il numero di righe e il costo in crediti corrispondano alla tabella sopra.
Scrivi il costo nel tuo log
Registra il saldo prima e dopo. Da ora in poi, ogni script che scrivi inizia con quell'abitudine e una fattura sorpresa diventa una riga in un log invece di un mistero.
Prezzi
Crediti prepagati. Un credito è $0,0001. Non ci sono abbonamenti e nessun minimo mensile.
Azioni gratuite
$0
- domain, overview, stats, suggest
- Nessuna chiave necessaria
- Alimenta il checker web
Paga a consumo
$0.10per 1.000 chiamate da 1 credito
- $100 di crediti gratuiti all'iscrizione
- Nessuna carta necessaria
- Ricarica con USDT (TRC-20)
- Fatturato una volta per chiamata, non per riga
Limiti che dovresti conoscere
L'indice copre 181.132.097 domini e 2.774.625.913 link di dominio. Si aggiorna approssimativamente mensilmente. È più lento di un crawl giornaliero.
La paginazione profonda si ferma a 50.000 righe. Per recuperi più grandi, restringi la query con sort o dividi per dominio.
L'accesso è solo tramite Google e le ricariche sono in USDT. Inizia con il DR checker, prova un'analisi dei concorrenti con la guida competitor o leggi perché alcuni team abbandonano l'API Ahrefs per il lavoro puro sui link.
FAQ
Pago per riga?
No. Una chiamata è fatturata una volta, che restituisca 10 righe o 1.000.
Cosa succede quando i crediti si esauriscono?
L'API restituisce HTTP 402. Ricarica con USDT (TRC-20) dalla pagina dell'account e continua.
Dove trovo la mia chiave?
Nel dashboard dopo l'accesso con Google.