Web Search API | Unified Agent APIs

Overview

Your agent calls one search API. We route to the optimal provider based on parameters. Supports raw SERP results, AI-synthesized answers, or both combined. The agent never needs to know which provider handled the request.

Modes

The mode parameter is a preset that configures optimal provider routing for common use cases. You can also set individual parameters directly for fine-grained control.

AI

2 credits

AI-synthesized answers with inline citations via Perplexity.

Best for research queries that need a coherent answer. Returns a synthesized response with source citations. Response time: 2-4s.

SERP

1 credit

Raw Google SERP results via SerperDev.

Returns links, snippets, knowledge graph, and featured snippets. No AI synthesis. Fastest option at under 1s response time.

Deep

3 credits

SERP results combined with AI synthesis for full coverage.

Gets raw sources plus a synthesized answer. Most comprehensive option, combining both providers. Response time: 3-6s.

Parameters

query

Required

string

The search query. Natural language works best for AI mode, keywords work best for SERP mode.

num_results

number (default: 10)

Maximum number of organic results to return. Only applies to serp and deep modes.

country

string (default: us)

ISO country code for localized results. Affects SERP ranking and content language.

freshness

select (default: any)

Time filter for result recency. Use 'day' for breaking news, 'any' for evergreen research.

Any time

Past 24 hours

Past week

Past month

Example Response

{
  "success": true,
  "data": {
    "answer": "In Q1 2026, AI funding reached $4.2B across 320 deals...",
    "citations": [
      { "url": "https://techcrunch.com/...", "title": "AI Funding Report Q1 2026" }
    ],
    "organic_results": [
      { "url": "https://...", "title": "...", "snippet": "...", "position": 1 }
    ],
    "knowledge_graph": null,
    "featured_snippet": null
  },
  "metadata": {
    "provider_used": "perplexity",
    "providers_tried": ["perplexity"],
    "mode_used": "ai",
    "response_time_ms": 2340,
    "request_id": "req_abc123"
  },
  "credits_used": 2
}

Get Started

Use this API through the O-mega platform. Create an API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try Web Search

Test Web Search in the interactive playground. No setup required.

Open Playground