Documentazione dell'API IndexJump

Integra l'indicizzazione rapida nel tuo flusso di lavoro con la nostra potente API REST

IndexJump fornisce servizi di indicizzazione rapida per Google, Bing e altri motori di ricerca. L'API è accessibile tramite quattro endpoint, consentendoti di gestire la coda di indicizzazione e monitorare i progressi in tempo reale.

Autenticazione

Tutte le richieste API richiedono un parametro «token» per l'autenticazione. Includi il tuo token API in ogni richiesta come parametro di query o nel corpo della richiesta.

Il tuo token è unico per il tuo account e deve essere mantenuto riservato. Non condividerlo mai pubblicamente né affidarlo al controllo della versione.

Accedi o crea un account per visualizzare il tuo token API.

Inizia

Endpoint API

GET

Ottieni equilibrio

https://api.indexjump.com/balance

Recupera il numero di URL disponibili nel tuo account per l'indicizzazione.

Parametri

token Necessario Il tuo token di autenticazione API

Richiesta di esempio

curl -X GET "https://api.indexjump.com/balance?token=YOUR_TOKEN"

Risposta positiva (200)

{
  "err": null,
  "res": {
    "balance": 74
  }
}
POST

Invia URL per l'indicizzazione

https://api.indexjump.com/index

Invia un singolo URL affinché venga indicizzato dai motori di ricerca.

Parametri

url Necessario L'URL da indicizzare
token Necessario Il tuo token di autenticazione API
bot Opzionale Target del motore di ricerca: 0 (GoogleBot), 1 (OpenAIBot), 2 (BingBot). Impostazione predefinita: 0

Richiesta di esempio

curl -X GET "https://api.indexjump.com/index?url=https%3A%2F%2Fexample.com&token=YOUR_TOKEN"

Risposta positiva (200)

{
  "err": null,
  "res": {
    "success": true
  }
}
POST

Invio collettivo di URL per l'indicizzazione

https://api.indexjump.com/index/bulk

Invia più URL in un'unica richiesta per l'indicizzazione batch.

Intestazioni

Content-Type application/json

Parametri del corpo

urls Necessario Matrice di URL da indicizzare
token Necessario Il tuo token di autenticazione API
bot Opzionale Target del motore di ricerca: 0 (GoogleBot), 1 (OpenAIBot), 2 (BingBot). Impostazione predefinita: 0

Richiesta di esempio

curl -X POST "https://api.indexjump.com/index/bulk?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example1.com",
      "https://example2.com"
    ]
  }'

Risposta positiva (200)

{
  "err": null,
  "res": {
    "success": true
  }
}
GET

Controlla lo stato dell'indicizzazione

https://api.indexjump.com/index/status

Controlla lo stato di indicizzazione corrente e visualizza i log del crawler per un URL inviato.

Parametri

url Necessario L'URL per cui verificare lo stato di indicizzazione
token Necessario Il tuo token di autenticazione API
bot Opzionale Target del motore di ricerca: 0 (GoogleBot), 1 (OpenAIBot), 2 (BingBot). Impostazione predefinita: 0

Richiesta di esempio

curl -X GET "https://api.indexjump.com/index/status?url=https%3A%2F%2Fexample.com&token=YOUR_TOKEN"

Risposta positiva (200)

{
  "err": null,
  "res": {
    "success": true,
    "status": "Delivered",
    "log_visit": "September 3, 2024, 11:25 am (UTC +0) --- GET --- 66.249.78.3"
  }
}

Valori di stato

  • Delivered - Il bot è stato consegnato; L'URL verrà indicizzato a breve
  • In progress - Consegna del bot attualmente in corso
  • In queue - URL in coda per la consegna del bot
  • Not found - URL non trovato nel tuo account

Codici di stato HTTP

200

OK

Richiesta riuscita

400

Brutta richiesta

Parametri non validi o richiesta non valida

401

Non autorizzato

Token API mancante o non valido

429

Troppe richieste

Limite di velocità superato. Si prega di riprovare dopo un po'

Domande frequenti sull'API

C'è un limite di tariffa?

Sì, gli endpoint API hanno limiti di velocità per garantire un utilizzo corretto. I limiti standard sono 100 richieste al minuto per token. Contatta l'assistenza per limiti più alti.

Quanto tempo occorre affinché un URL venga indicizzato?

Dopo l'invio, i bot dei motori di ricerca in genere visitano il sito entro 24-48 ore. L'indicizzazione finale nell'indice primario richiede in media 1-3 settimane, a seconda della qualità del contenuto e dell'autorità del sito.

Posso utilizzare l'API con i webhook?

Attualmente l'API non supporta i webhook. Utilizza l'endpoint di stato per eseguire il polling degli aggiornamenti o controllare la dashboard per il monitoraggio in tempo reale.

Cosa succede se un URL fallisce?

Se l'indicizzazione non riesce, controlla l'endpoint di stato per informazioni dettagliate sull'errore. I problemi più comuni includono URL non validi, direttive noindex o errori del server. Il nostro team di supporto può aiutare a diagnosticare i problemi.

L'accesso API è disponibile sui piani gratuiti?

Sì, l'accesso API è incluso nel piano gratuito. Il piano gratuito include 100 URL per l'indicizzazione.

Come gestisco gli errori?

Tutte le risposte includono un campo «err». Se «err» è nullo, la richiesta è riuscita. Altrimenti, controlla i dettagli del messaggio di errore e riprova in modo appropriato.

Pronto ad automatizzare la tua indicizzazione?

Inizia a utilizzare l'API oggi stesso con la tua prova gratuita di 100 URL. Nessuna carta di credito richiesta.

Ottieni il tuo token API