API

L'API esegue la stessa ricerca del sito web e restituisce i risultati come dati: JSON per impostazione predefinita, oppure XML, CSV, TSV, NDJSON e testo semplice. È tutto in sola lettura: niente di ciò che trovi qui crea o modifica qualcosa.

URL di base https://api.publicwww.com

In un solo comando

curl -H "Authorization: Bearer $KEY" \
     "https://api.publicwww.com/v1/search?query=%22angular.min.js%22&per_page=3"

{
  "query": "\"angular.min.js\"",
  "page": 1,
  "per_page": 3,
  "total": 278,
  "total_pages": 93,
  "returned": 3,
  "truncated": false,
  "took_ms": 2,
  "results": [
    { "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4187, "ranked": true }
  ]
}

Endpoint

Endpoint	Metodi	Cosa fa
`/v1/search`	GET, POST	Esegue una ricerca. Parametri, formati.
`/v1/account`	GET	Piano, quota e limiti. Non consuma nulla.
`/v1/clusters`	GET, POST	Elenchi salvati di siti web: creali da una ricerca o da un elenco, combinali, estrai contatti e ID dal codice sorgente delle pagine. Cluster.
`/mcp`	POST	Il server MCP per assistenti e agenti AI: ricerca e cluster come strumenti, con lo stesso token.
`/`	GET	L'API che descrive se stessa, codici di errore compresi. Non richiede chiave.
`/openapi.json`	GET	La stessa cosa come descrizione OpenAPI 3.1, da importare in Postman, n8n, Make, Power Automate e altri strumenti. Non richiede chiave.

Non esiste un endpoint di esportazione separato. Per i grandi volumi si usa /v1/search con un per_page elevato, che con un piano a pagamento arriva fino a un milione di righe; la risposta arriva in streaming man mano che viene prodotta.

Cosa garantisce

I risultati non vengono mai ridotti di nascosto. Quando la quota giornaliera di un browser si esaurisce, il sito torna silenziosamente ai limiti del piano gratuito e mostra meno risultati. Uno script non può accorgersene, quindi qui diventa un errore: 429 quota_exceeded, non una risposta ridotta che sembra completa.
Una risposta incompleta è segnalata come tale: truncated nel corpo e X-Truncated negli header, in ogni formato.
I siti senza posizione lo dichiarano: rank: null e ranked: false, mai un segnaposto interno che un client potrebbe scambiare per una posizione reale, molto alta.
Meglio sentirsi dire di aspettare che essere fatti aspettare. Se le richieste arrivano troppo in fretta, la risposta torna subito con un Retry-After, invece di tenere aperta la connessione.

Ottenere una chiave

Crea un token nel tuo profilo, oppure lascia che un'applicazione lo ottenga per te tramite OAuth 2.1. Serve un piano a pagamento; vedi i prezzi. Gli script esistenti che usano i vecchi URL ?export= continuano a funzionare senza modifiche: vedi i vecchi URL di esportazione.

Successivo Autenticazione