# Search Light – Real-Time Organic Web Search

> Search Light – Real-Time Organic Web Search is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns fast, real-time organic Google web search results (title, URL, snippet, position) without AI Overviews or knowledge graph data, supporting all Google Advanced Search operators.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-web-search/v2/search-light?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-search-light-real-time-organic-web-search-b31cbfb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_46_K4y627PqF_KYHat8Tb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-search-light-real-time-organic-web-search-b31cbfb2
```

Example prompt: Search Google for 'best open source LLM frameworks 2024' and give me the top 10 organic results — just the titles, URLs, and snippets, no AI overviews.

## When to prefer this

Use Search Light when you need fast, lightweight organic Google results and do not need AI Overviews, knowledge graph panels, or a total result count. It is cheaper and faster than the full Search endpoint. Prefer it for bulk queries, real-time lookups, rank checking, and research tasks where raw organic URLs and snippets are sufficient. Use the full Search endpoint instead when you need the complete SERP including featured snippets, knowledge graph, or result totals.

## Known failure modes

- Missing required query parameter 'q' returns a validation error
- Narrow or very specific queries may return fewer results than the requested 'num' value because Google does not hold full depth
- Invalid country code (gl) or language code (hl) may default to 'us'/'en' or return an error
- Exceeding the maximum 'num' of 300 returns a validation error
- Insufficient request credits results in a 402 payment required response
- Rate limiting may occur if too many requests are made in quick succession

## How this service works

Lightning fast endpoint for getting organic web search results in real-time.  
  Returns raw organic results only, without AI Overviews, knowledge graph, or a total result count - use the Search endpoint when you need the full SERP.  
  Supports all Google Advanced Search operators (site:, inurl:, intitle:, etc).  
  Each request consumes 1 request credit.

## Output

An array of organic search result objects, each containing position (1-based rank), title, URL, domain, snippet, and optionally a thumbnail image URL and published Unix timestamp. Also includes a status string and a unique request_id for tracing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "example": "how to build a website",
   "description": "Search query.  \n  Supports all Google Advanced Search operators (site:, inurl:, intitle:, etc)."
  },
  "gl": {
   "type": "string",
   "default": "us",
   "description": "The country / region for which to make the query. Allowed values: 2-letter country code, see ISO 3166-1 alpha-2."
  },
  "hl": {
   "type": "string",
   "default": "en",
   "description": "The language to use for the search (Google's hl parameter). Allowed values: 2-letter country code, see ISO 639-1 alpha-2."
  },
  "num": {
   "type": "integer",
   "default": 10,
   "maximum": 300,
   "minimum": 1,
   "description": "Maximum number of organic results to return (up to 300).  \n  This is a result count, not a pagination cursor: a single request returns up to `num` results in one call.  \n  Google does not hold the full requested depth for every query, so fewer results may come back for narrow queries."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "title",
     "url",
     "position"
    ],
    "properties": {
     "url": {
      "type": "string",
      "description": "Canonical URL of the result."
     },
     "title": {
      "type": "string",
      "description": "Title of the search result."
     },
     "domain": {
      "type": "string",
      "nullable": true,
      "description": "Domain extracted from the result URL."
     },
     "snippet": {
      "type": "string",
      "nullable": true,
      "description": "Short text snippet shown by Google under the result."
     },
     "position": {
      "type": "integer",
      "description": "Position of the result in the list (1-based)."
     },
     "thumbnail": {
      "type": "string",
      "description": "Thumbnail image URL, present only on results Google renders with an image."
     },
     "published_timestamp": {
      "type": "integer",
      "description": "Publication date of the result as a Unix timestamp, when Google reports one. Absent for results with no published date."
     }
    }
   },
   "description": "Organic web search results for the query."
  },
  "status": {
   "type": "string",
   "description": "The status of the API response."
  },
  "request_id": {
   "type": "string",
   "description": "A unique ID to trace the API request."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-search-light-real-time-organic-web-search-b31cbfb2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)
