Vai al contenuto
SEOCheck
SEOCheckRegistrati

Documentazione

Riferimento endpoint e prezzi

Un URL, molte azioni. Questa è l'intera superficie.

Team di ricerca SEOCheck ·

Un solido ponte di pietra che attraversa una valle nebbiosa che rappresenta un endpoint API affidabile

Azioni e costi

AzioneCreditiCosa restituisce
domaingratuitoRecord base e DR per un dominio
overviewgratuitoRiepilogo del profilo link di un dominio
statsgratuitoStatistiche su tutto l'indice
suggestgratuitoSuggerimenti di dominio durante la digitazione
bulk_dr1DR per fino a 2.000 domini
compare1Confronto affiancato per fino a 20 domini
top1Domini principali
dr_distribution1Distribuzione del DR tra i domini linkanti
tld_breakdown1Link per dominio di primo livello
refdomains2Domini linkanti
backlinks2Backlink individuali
anchors2Testi anchor
toppages2Pagine più linkate
anchor_cloud2Pesi degli anchor
intersect2Linkanti condivisi per 2-10 domini
search3Ricerca full-text su anchor, titoli e URL
keyword3Chi è 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 overview su un dominio che conosci. È gratuito.
  • Verifica che la tua chiave funzioni con una chiamata da 1 credito, come compare.
  • Leggi _credits nella 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.

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'
Un giardiniere che pota attentamente un bonsai con forbici specializzate che illustra regolazioni precise

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.

Una coppia di bilance d'epoca in ottone che bilanciano due pesi distinti che rappresentano diversi tipi di errore

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.

01

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.

02

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.

03

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.

04

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
Apri il checker

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
Ottieni $100 gratis

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.