API

La API ejecuta la misma búsqueda que el sitio web y devuelve los resultados como datos: JSON por defecto, o XML, CSV, TSV, NDJSON y texto plano. Todo es de lectura: nada de lo que hay aquí crea ni modifica nada.

URL base https://api.publicwww.com

En 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 }
  ]
}

Endpoints

Endpoint	Métodos	Qué hace
`/v1/search`	GET, POST	Ejecuta una búsqueda. Parámetros, formatos.
`/v1/account`	GET	Plan, cuota y límites. No consume nada.
`/mcp`	POST	El servidor MCP para asistentes y agentes de IA: la misma búsqueda como herramienta, con el mismo token.
`/`	GET	La API se describe a sí misma, incluidos los códigos de error. No necesita clave.
`/openapi.json`	GET	Lo mismo como descripción OpenAPI 3.1, para importarla en Postman, n8n, Make, Power Automate y otras herramientas. No necesita clave.

No hay un endpoint de exportación aparte. Para grandes volúmenes se usa /v1/search con un per_page grande, que en un plan de pago llega hasta un millón de filas; la respuesta se transmite a medida que se genera.

Lo que garantiza

Los resultados nunca se reducen sin avisar. Cuando se agota la cuota diaria de un navegador, el sitio web pasa discretamente a los límites del plan gratuito y muestra menos. Un script no puede darse cuenta de eso, así que aquí es un error: 429 quota_exceeded, no una respuesta recortada que parece completa.
Una respuesta recortada se marca como tal: truncated en el cuerpo y X-Truncated en los encabezados, en todos los formatos.
Los sitios sin posición lo indican: rank: null y ranked: false, nunca un valor interno de relleno que un cliente podría confundir con una posición real muy alta.
Mejor que te digan que esperes que hacerte esperar. Si llegas demasiado rápido, la respuesta vuelve al instante con un Retry-After, en lugar de mantener la conexión abierta.

Obtener una clave

Crea un token en tu perfil, o deja que una aplicación lo obtenga por ti mediante OAuth 2.1. Se necesita un plan de pago; consulta los precios. Los scripts existentes que usan las antiguas URL con ?export= siguen funcionando sin cambios; consulta las antiguas URL de exportación.

Siguiente Autenticación