# Light Search (Bulk)

> Light Search (Bulk) 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).

Performs real-time web searches for up to 100 queries in a single POST request, returning ranked organic search results for each query.

## Facts

- Endpoint: POST https://agents.openwebninja.com/realtime-web-search/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-light-search-bulk-df66b214
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cta13c_xT089d5TWT7rA9

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-light-search-bulk-df66b214 -d '<json body>'
```

Example prompt: Search the web for these 5 topics at once — 'best CRM software 2024', 'Salesforce pricing', 'HubSpot vs Salesforce', 'open source CRM tools', and 'CRM for small business' — and give me the top 10 results for each in English.

## When to prefer this

Use this endpoint when you need to search the web for multiple distinct queries simultaneously, especially when efficiency matters and you want to avoid making many sequential single-query requests. It is ideal for SEO research, competitive analysis, content gap auditing, market monitoring, or any workflow that needs real-time organic search results for a batch of keywords. Prefer this over a single-query endpoint when you have 2–100 queries to run and want to minimize latency and API call overhead.

## Known failure modes

- Exceeds 100-query limit per request — server enforces a maximum of 100 items in the queries array
- Individual query exceeds 5000 characters — trimmed or rejected
- Invalid or unsupported geo code (gl) or language code (hl) — may fall back to defaults or return an error
- Duplicate queries are silently de-duplicated server-side, so response count may be fewer than submitted
- Rate limiting or credit exhaustion — returns a 402 or quota error
- Empty queries array — returns a validation error

## How this service works

Perform real-time web searches for up to 100 queries in a single request (each query is counted/charged as a request credit).

## Output

Returns a JSON object with a status string, a unique request_id, and a data array containing one entry per submitted query. Each entry includes the original query string and a results array of ranked organic web search results, each with a title, URL, domain, snippet, and 1-based position index.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "queries"
 ],
 "properties": {
  "gl": {
   "type": "string",
   "default": "us",
   "example": "us",
   "description": "Geo/region code (lowercased)."
  },
  "hl": {
   "type": "string",
   "default": "en",
   "example": "en",
   "description": "Language code (lowercased)."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "example": 10,
   "maximum": 300,
   "minimum": 1,
   "description": "Number of results to return (1–300; capped at 300)."
  },
  "query": {
   "type": "string"
  },
  "queries": {
   "oneOf": [
    {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 5000
     },
     "example": [
      "chatgpt",
      "build a website"
     ],
     "maxItems": 100
    }
   ],
   "description": "Query or list of queries to search (max 100 items; each trimmed; each ≤ 5000 chars; duplicates removed server-side)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "query",
     "results"
    ],
    "properties": {
     "query": {
      "type": "string",
      "description": "The query that produced this result set."
     },
     "results": {
      "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)."
        }
       }
      },
      "description": "Organic web search results for this query."
     }
    }
   },
   "description": "One entry per submitted query, in the order they were processed."
  },
  "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-light-search-bulk-df66b214/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)