# Search Forums

> Search Forums 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).

Searches discussions and forums across the web using Google's Forums tab, returning ranked results with titles, snippets, and source URLs.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-forums-search/search?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-forums-a50a4b5f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PNySI574tJTseCx7NAbMP

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-forums-a50a4b5f
```

Example prompt: Search Google's Forums tab for discussions about 'best mechanical keyboard switches for gaming' from the past month in the US and give me the top results.

## When to prefer this

Choose this endpoint when you specifically need results from discussion forums, community boards, or Q&A sites (like Reddit, Quora, Stack Exchange, etc.) rather than general web pages or news articles. It is ideal for gathering community opinions, troubleshooting threads, or user-generated discussions on any topic, and supports filtering by recency and locale for targeted results.

## Known failure modes

- Empty results array if no forum discussions match the query
- Invalid country code returns an error or falls back to default
- Invalid time range enum value causes a request error
- Pagination offset beyond available results returns empty data array
- Rate limiting or quota exhaustion may return a payment/402 error

## How this service works

Search in Discussions and Forums across the web. This endpoint returns the results returned when using the Forums tab on Google Search.

## Output

Returns an array of forum search results, each containing the URL, title, snippet, source name, rank, and position. Also includes the status of the response, the original query parameters, and a unique request ID for tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "time": {
   "enum": [
    "any",
    "hour",
    "day",
    "week",
    "month",
    "year"
   ],
   "type": "string",
   "default": "any",
   "description": "Return results published in a specific time range."
  },
  "query": {
   "type": "string",
   "description": "Search query"
  },
  "start": {
   "type": "integer",
   "default": 0,
   "description": "Number of results to skip (for pagination)."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "The country / region for which to make the query (Google's gl parameter). Allowed values: 2-letter country code, see ISO 3166-1 alpha-2."
  },
  "language": {
   "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "url": {
      "type": "string",
      "description": "The URL of the search result"
     },
     "rank": {
      "type": "integer",
      "description": "The rank of the search result"
     },
     "title": {
      "type": "string",
      "description": "The title of the search result"
     },
     "source": {
      "type": "string",
      "description": "The source of the search result"
     },
     "snippet": {
      "type": "string",
      "description": "A short snippet from the search result"
     },
     "position": {
      "type": "integer",
      "description": "The position of the search result in the list"
     }
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the response"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "query": {
     "type": "string",
     "description": "The search query string"
    },
    "start": {
     "type": "integer",
     "description": "The starting index of the search results"
    }
   }
  },
  "request_id": {
   "type": "string",
   "description": "A unique identifier for the request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-search-forums-a50a4b5f/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)