Online Search API

Search the public web and return normalized organic results for agent context, market research, and enrichment workflows.

GET /v2/search/online

Online Search

cURL

curl --request GET \
  --url https://api.polynode.dev/v2/search/online \
  --header 'x-api-key: <api-key>'

Beta. This endpoint is designed for low-volume context enrichment. Results are best-effort, cached, and may be partial when upstream search engines throttle or fail.

Endpoint

GET /v2/search/online

Search the public web and return normalized organic results. Responses are cached to keep the endpoint lightweight.

curl "https://api.polynode.dev/v2/search/online?q=Cavaliers%20Knicks%20injury%20news&max_results=5" \
  -H "x-api-key: YOUR_KEY"

Query parameters

Parameter	Description
q	Search query. Required.
max_results	Number of normalized organic results. Defaults to 10, capped at 20.
engines	Comma-separated engine adapters. Defaults to bing,duckduckgo. brave is available as an opt-in adapter.
language	Search language. Defaults to en-US.
time_range	Optional freshness filter when supported: day, week, month, year.
safe_search	Safe-search mode: 0, 1, or 2. Defaults to 0.
cache_ttl_seconds	Cache TTL for this query. Defaults to 600, capped at 3600.

Rate limit: 3 requests per 10 seconds per API key, in addition to your normal tier limit.

Response

{
  "query": "Cavaliers Knicks injury news",
  "source": "search_online",
  "adapter": "searxng",
  "status": "ok",
  "cached": false,
  "engines_requested": ["bing", "duckduckgo"],
  "unresponsive_engines": [],
  "result_count": 2,
  "results": [
    {
      "title": "Cleveland Cavaliers Injury Status - ESPN",
      "url": "https://www.espn.com/nba/team/injuries/_/name/cle/cleveland-cavaliers",
      "domain": "espn.com",
      "snippet": "Visit ESPN for the current injury situation...",
      "engines": ["duckduckgo"],
      "score": 1,
      "category": "general",
      "published_at": null
    }
  ],
  "answers": [],
  "suggestions": [],
  "fetched_at": "2026-05-25T11:10:00.000Z",
  "elapsed_ms": 1200
}

status may be partial when one engine fails but other engines still return results.

Authorizations

x-api-key · string · header · required

Query Parameters

q · string · required

Search query.

max_results · integer · default: 10

Number of normalized organic results. Defaults to 10, capped at 20.

Required range: 1 <= x <= 20

engines · string · default: bing,duckduckgo

Comma-separated engine adapters. Defaults to bing,duckduckgo. brave is available as an opt-in adapter.

language · string · default: en-US

Search language.

time_range · enum<string>

Optional freshness filter when supported.

Available options: day, week, month, year

safe_search · enum<integer> · default: 0

Safe-search mode.

Available options: 0, 1, 2

cache_ttl_seconds · integer · default: 600

Cache TTL for the query. Defaults to 600, capped at 3600.

Required range: 1 <= x <= 3600

Response

200

Online search results