API

API виконує той самий пошук, що й сайт, і повертає результати як дані: за замовчуванням у JSON, а також у XML, CSV, TSV, NDJSON і звичайним текстом. Усі операції - лише читання: тут нічого не створюється й не змінюється.

Базовий URL https://api.publicwww.com

Однією командою

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

Ендпоінти

Ендпоінт	Методи	Що робить
`/v1/search`	GET, POST	Виконує пошук. Параметри, формати.
`/v1/account`	GET	Тариф, денні ліміти й обмеження. Нічого не витрачає.
`/mcp`	POST	MCP-сервер для ШІ-асистентів і агентів: той самий пошук як інструмент, із тим самим токеном.
`/`	GET	Опис API, складений самим API, включно з кодами помилок. Ключ не потрібен.
`/openapi.json`	GET	Те саме у вигляді опису OpenAPI 3.1 для імпорту в Postman, n8n, Make, Power Automate та інші інструменти. Ключ не потрібен.

Окремого ендпоінта для експорту немає. Масове завантаження - це /v1/search з великим per_page, який на платному тарифі сягає мільйона рядків; відповідь передається потоком, у міру формування.

Що гарантує API

Результати ніколи не урізаються мовчки. Коли в браузері вичерпано денний ліміт, сайт непомітно переходить на ліміти безкоштовного тарифу й показує менше. Скрипт цього не побачить, тому тут це помилка - 429 quota_exceeded, а не коротка відповідь, яка виглядає повною.
Коротка відповідь позначена як коротка - truncated у тілі й X-Truncated у заголовках, у кожному форматі.
Сайти без рейтингу так і позначено - rank: null і ranked: false, а не внутрішнє значення-заглушка, яке клієнт може сплутати зі справжнім, дуже великим місцем у рейтингу.
Краще попросити зачекати, ніж змушувати чекати. Якщо запити надходять надто часто, відповідь приходить одразу із заголовком Retry-After, а не тримає з’єднання відкритим.

Як отримати ключ

Створіть токен у своєму профілі або дозвольте застосунку отримати його для вас через OAuth 2.1. Потрібен платний тариф; див. тарифи. Наявні скрипти, що звертаються до старих URL з ?export=, і далі працюють без змін - див. старі URL експорту.

Далі Автентифікація