API

L’API exécute la même recherche que le site et renvoie les résultats sous forme de données : en JSON par défaut, ou en XML, CSV, TSV, NDJSON et texte brut. Tout se fait en lecture seule - rien ici ne crée ni ne modifie quoi que ce soit.

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

En une seule commande

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

Points de terminaison

Point de terminaisonMéthodesRôle
/v1/search GET, POST Lance une recherche. Paramètres, formats.
/v1/account GET Forfait, quota et limites. Ne consomme rien.
/mcp POST Le serveur MCP pour les assistants et agents IA : la même recherche sous forme d’outil, avec le même jeton.
/ GET L’API se décrit elle-même, codes d’erreur compris. Aucune clé requise.
/openapi.json GET La même chose sous forme de description OpenAPI 3.1, à importer dans Postman, n8n, Make, Power Automate et d’autres outils. Aucune clé requise.

Il n’existe pas de point de terminaison d’export distinct. Pour un export en masse, utilisez /v1/search avec un per_page élevé, qui peut atteindre un million de lignes avec un forfait payant ; la réponse est transmise en flux au fur et à mesure de sa production.

Nos engagements

  • Les résultats ne sont jamais réduits en silence. Lorsque le quota quotidien est épuisé dans un navigateur, le site revient discrètement aux limites de l’offre gratuite et affiche moins de résultats. Un script ne peut pas s’en apercevoir : ici, c’est donc une erreur - 429 quota_exceeded, et non une réponse tronquée qui semble complète.
  • Une réponse tronquée est signalée comme telle - truncated dans le corps et X-Truncated dans les en-têtes, quel que soit le format.
  • Les sites sans rang l’indiquent - rank: null et ranked: false, jamais une valeur interne qu’un client pourrait prendre pour un rang réel, très élevé.
  • Mieux vaut être prié d’attendre que d’être mis en attente. Si vous envoyez des requêtes trop vite, la réponse revient aussitôt avec un Retry-After, au lieu que la connexion reste ouverte.

Obtenir une clé

Générez un jeton dans votre profil, ou laissez une application en obtenir un pour vous via OAuth 2.1. Un forfait payant est requis ; consultez les tarifs. Les scripts existants qui appellent les anciennes URL ?export= continuent de fonctionner sans modification - voir les anciennes URL d’export.

Suivant Authentification