# L'API di ricerca funziona?

> Verifica l'API di ricerca web LLMWebSearch in pochi secondi con la chiamata sui crediti gratuiti e scopri dove vengono registrati gli incidenti.

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

Questa pagina non ha un indicatore di uptime né una cronologia inventata. Ti offre un controllo che puoi eseguire da solo, spiega come distinguere i nostri problemi dal rifiuto di un sito web e indica dove vengono annotati gli incidenti.

**Risposta rapida — Come faccio a controllare che LLMWebSearch funzioni?**

Chiama `GET https://llmwebsearch.com/api/v1/credits` con la tua chiave. È gratuito, non tocca nessun sito web e una normale risposta JSON dimostra che l'API **LLMWebSearch**, la tua chiave e il tuo account funzionano. Poi esegui una ricerca, che costa 1 credito da un pack a partire da 1,20 USD/1K ricerche. Gli errori dalla nostra parte non vengono mai addebitati, e gli incidenti sono datati nel [changelog](https://llmwebsearch.com/it/changelog/).

## Qual è il controllo di stato più rapido?

L'endpoint dei crediti. Risponde solo dalla nostra parte: autenticazione, API e il tuo account. Se restituisce i tuoi crediti residui, il servizio è attivo per te. Se restituisce `401`, la chiave è sbagliata o revocata; creane una nuova nella dashboard.

*curl: controllo di stato (gratuito) e crediti residui*

```bash
curl -s https://llmwebsearch.com/api/v1/credits \
  -H "Authorization: Bearer $LLMWEBSEARCH_API_KEY"

```

*Python: lo stesso controllo dentro uno script di monitoraggio*

```python
import os
import sys

import requests

resp = requests.get(
    "https://llmwebsearch.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['LLMWEBSEARCH_API_KEY']}"},
    timeout=10,
)
if resp.status_code != 200:
    print("API check failed:", resp.status_code, resp.text[:200])
    sys.exit(1)
print("API up, credits left:", resp.json()["credits_remaining"])

```

## Come distinguo un nostro errore dal rifiuto di un sito web?

Guarda dove appare il problema nella risposta.

- **Un errore HTTP sull'intera chiamata** (`502 search_failed`, `504 search_timeout`) è dalla nostra parte o a monte. Non costa nulla; aspetta un po' e riprova con un'attesa crescente.
- **Una chiamata riuscita con alcuni risultati privi di contenuto** riguarda quelle pagine. Ogni risultato porta un `content_status`: `blocked_by_robots`, `blocked_by_site_policy`, `target_refused`, `fetch_failed` o `fetch_timeout`. La ricerca in sé ha funzionato.

Il secondo caso è normale sul web aperto e non è un incidente. La [pagina degli errori](https://llmwebsearch.com/it/docs/errors/) elenca ogni codice.

## Dove vengono registrati gli incidenti?

Nel [changelog](https://llmwebsearch.com/it/changelog/). Un incidente che coinvolge molti account riceve una voce datata: cosa è fallito, da quando a quando e cosa è cambiato dopo. Le chiamate fallite durante un incidente non sono state addebitate, quindi non c'è nulla da recuperare.

Non pubblichiamo una percentuale di uptime né un valore di latenza. Preferiamo darti un controllo che puoi eseguire piuttosto che un numero che non puoi verificare.

## Cosa deve fare il mio agente quando una chiamata fallisce?

Riprova solo ciò che può riuscire più tardi. Un `429 rate_limited`, `502 search_failed` o `504 search_timeout` merita un nuovo tentativo dopo una breve attesa che raddoppia ogni volta. Un `401` o `402` richiede una persona: una nuova chiave o più crediti. Una pagina rifiutata dal suo sito web non va ritentata affatto; usa invece gli altri risultati della stessa ricerca.

## Domande sullo stato

### La chiamata sui crediti consuma qualche credito?

No. `GET https://llmwebsearch.com/api/v1/credits` è gratuita, quindi un job di monitoraggio può eseguirla tutte le volte che il tuo limite al minuto consente.

### La mia ricerca ha funzionato ma un risultato non ha contenuto. È un'interruzione del servizio?

No. Quella pagina non è stata letta: il suo `content_status` ne spiega il motivo. Il nostro reader rispetta robots.txt: si presenta come LLMWebSearch, segue le regole che un sito scrive per lui o per tutti i robot, e lascia fuori il contenuto di qualsiasi pagina che non gli è permesso leggere.

### A chi segnalo un problema che il controllo di stato non mostra?

Al supporto a support@llmwebsearch.com, con l'ora, l'endpoint e una risposta fallita completa. Una persona risponde entro 12 ore.

---

LLMWebSearch: LLMWebSearch è un'API di ricerca web per agenti AI che restituisce risultati classificati con il contenuto delle pagine principali in Markdown, pagata in criptovalute senza caricare documenti d'identità. I crediti prepagati da 1,20 USD/1K ricerche non scadono mai. Senza KYC — niente documento, niente selfie, niente documenti. Paghi in criptovalute.