Available now

Search API v1

Read-only HTTP access to the same catalog search you get on SearchGhor: titles, URLs, snippets, and ranking. Authenticate with an API key; no write operations.

Endpoint

GEThttps://searchghor.com/api/v1/search

Query parameters

  • q (required) — search terms.
  • page — page number (default 1).
  • per_page — page size, 1–50 (default 10).

Authentication

Send your secret in Authorization: Bearer <key> (preferred), or as api_key in the query string. Create and revoke keys in the dashboard → API after you sign in.

Example

curl -sS \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://searchghor.com/api/v1/search?q=coffee&page=1&per_page=10"

Response

JSON with query, total, page, per_page, results (hits with snippet and metadata — no full page body), and rate_limit (per-minute quota or unlimited for premium accounts).

Rate limits

Standard accounts: 60 successful search requests per minute per API key (rolling clock minute). Responses include X-RateLimit-Limit and X-RateLimit-Remaining. Over the limit returns HTTP 429 with Retry-After. Premium accounts (flag on your profile) are not minute-capped.

CORS

The search endpoint allows browser GET from any origin for the allowed headers and methods.

Questions? Contact us.