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	AI 어시스턴트와 에이전트를 위한 MCP 서버입니다. 같은 검색을 같은 토큰으로 도구 형태로 제공합니다.
`/`	GET	오류 코드를 포함해 API 자체를 설명합니다. 키가 필요 없습니다.
`/openapi.json`	GET	같은 내용을 OpenAPI 3.1 명세로 제공합니다. Postman, n8n, Make, Power Automate 등의 도구로 가져올 수 있습니다. 키가 필요 없습니다.

별도의 내보내기 엔드포인트는 없습니다. 대량 조회는 /v1/search에 per_page를 크게 지정하면 되며, 유료 요금제에서는 최대 100만 행까지 가능합니다. 응답은 생성되는 대로 스트리밍됩니다.

API가 보장하는 것

결과를 몰래 줄이지 않습니다. 브라우저에서는 일일 할당량을 다 쓰면 웹사이트가 조용히 무료 요금제 한도로 돌아가 결과를 적게 보여 줍니다. 스크립트는 이를 알아챌 수 없으므로, API에서는 완전해 보이는 짧은 응답 대신 429 quota_exceeded 오류를 반환합니다.
잘린 응답은 잘렸다고 표시합니다. 모든 형식에서 본문에는 truncated, 헤더에는 X-Truncated가 들어갑니다.
순위가 없는 사이트는 없다고 알려 줍니다. rank: null과 ranked: false로 표시하며, 클라이언트가 실제의 매우 큰 순위로 착각할 수 있는 내부 자리 표시 값은 절대 반환하지 않습니다.
기다리게 하지 않고, 기다리라고 알려 줍니다. 요청이 너무 빠르면 연결을 붙잡아 두지 않고 Retry-After와 함께 즉시 응답합니다.

키 발급받기

프로필에서 토큰을 발급하거나, OAuth 2.1을 통해 애플리케이션이 대신 토큰을 받게 할 수 있습니다. 유료 요금제가 필요합니다. 요금제를 참고하세요. 기존 ?export= URL을 호출하는 스크립트는 변경 없이 그대로 작동합니다. 자세한 내용은 기존 내보내기 URL을 참고하세요.

다음 인증