# Stato dell'API: come verificare che funzioni

> Verifica se l'API SERP di SerpCrypto funziona: una chiamata gratuita ai crediti, cosa significa ogni stato HTTP e quali errori non vengono addebitati.

- URL: https://serpcrypto.com/it/status/
- Ultimo aggiornamento: 2026-10-22
- Editore: SerpCrypto (https://serpcrypto.com)

Su questa pagina non c'è nessun widget di stato che dichiari una percentuale di uptime. Al suo posto trovi un controllo che puoi eseguire tu stesso in una riga sola, e il modo per leggere la risposta.

**Risposta rapida — Come faccio a controllare se l'API SerpCrypto funziona?**

Chiama `GET https://serpcrypto.com/api/v1/credits` con la tua chiave: è gratuito e risponde in JSON con i crediti che ti restano. Un 200 significa che l'API e la tua chiave funzionano. Gli errori 502 e 504 derivano da una ricerca non riuscita e non vengono mai addebitati. **SerpCrypto** pubblica gli incidenti nel [changelog](https://serpcrypto.com/it/changelog/); non pubblica nessuna percentuale di uptime finché non è misurata.

*Controllo di stato gratuito (nessun credito usato)*

```bash
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"
```

## Cosa significa ogni risposta?

| Stato HTTP | Significato | Addebitato? | Cosa fare |
| --- | --- | --- | --- |
| 200 | L'API funziona; per una ricerca, i risultati sono nel body | 1 credito per una ricerca riuscita; il controllo dei crediti è gratuito | Niente |
| 401 `invalid_api_key` | La chiave è mancante, sbagliata o revocata | No | Copia di nuovo la chiave dalla dashboard |
| 402 `insufficient_credits` | Sul tuo account non restano crediti | No | Acquista un pack sulla [pagina dei prezzi](https://serpcrypto.com/it/pricing/) |
| 429 `concurrency_limit` | Troppe ricerche nello stesso momento | No | Riduci le richieste in parallelo, oppure chiedi un limite più alto |
| 502 `search_failed` | La ricerca non è riuscita a completarsi | No | Riprova dopo una breve attesa |
| 504 `search_timeout` | Nessuna risposta in tempo | No | Riprova dopo una breve attesa |

## Il problema è dalla mia parte, dalla vostra o del motore?

Esegui prima il controllo gratuito, poi una ricerca semplice, poi la tua richiesta reale. Ogni passaggio isola un livello.

1. **La chiamata ai crediti fallisce con 401:** il problema è la chiave. Controlla il formato dell'header: `Authorization: Bearer <key>`, con uno spazio.
2. **La chiamata ai crediti funziona ma ogni ricerca restituisce 502:** il livello di raccolta o il motore sta fallendo per tutti. Aspetta qualche minuto e riprova; nel frattempo non viene addebitato nulla.
3. **Una query semplice funziona ma la tua fallisce con 400:** un parametro non è tra i valori ammessi. La [reference della ricerca](https://serpcrypto.com/it/docs/search/) elenca ogni valore.
4. **I risultati sembrano diversi da quelli del tuo browser:** di solito dipende da posizione, lingua o dispositivo. Imposta `gl`, `hl`, `location` e `device` in modo che corrispondano a ciò con cui confronti; vedi [posizioni e lingue](https://serpcrypto.com/it/docs/locations/).

## Dove vengono pubblicati gli incidenti e le modifiche?

Nel [changelog](https://serpcrypto.com/it/changelog/). Ogni voce ha una data, cosa è stato interessato (un motore, un campo, l'area cliente o i pagamenti) e cosa è cambiato. Anche un campo aggiunto compare lì, così un parser può essere aggiornato prima che il campo gli serva.

Non gestiamo un sito di stato separato, e questa pagina non mostra nessuna luce verde che potrebbe essere obsoleta. Il controllo gratuito qui sopra ti dice lo stato reale dell'API per la tua chiave, nel momento in cui lo chiedi.

## Perché non c'è una percentuale di uptime qui?

Perché non ne abbiamo ancora misurata una con un metodo pubblicato. Una percentuale di uptime implica una probe definita, un periodo definito e un guasto definito. Quando l'avremo, comparirà qui con il suo metodo e la sua data. Fino ad allora, la promessa onesta è la regola di fatturazione: 1 credito = 1 richiesta di ricerca andata a buon fine, che restituisce una pagina di risultati su qualsiasi motore supportato. Una richiesta non riuscita non viene addebitata.

## Cosa devo inviare al supporto durante un incidente?

Scrivi a support@serpcrypto.com con l'ID della richiesta da `search_metadata.id` (o l'ora della richiesta se non c'è stata risposta), il motore, lo stato HTTP e il codice di errore. Non includere mai la tua chiave API. Risposte via email entro 12 ore, 7 giorni su 7, incluso il supporto per l'integrazione dell'API. La [pagina dei contatti](https://serpcrypto.com/it/contact/) elenca gli altri dettagli che velocizzano una risposta.

---

SerpCrypto: SerpCrypto è un'API SERP per sviluppatori e agenti AI che restituisce i risultati di ricerca di Google e Bing in JSON, con pagamento in criptovalute e senza caricare documenti d'identità. I crediti di ricerca prepagati a partire da 0,30 USD/1K ricerche non scadono mai. Senza KYC — niente documento, niente selfie, niente documenti. Paghi in criptovalute.