Web Search API | Unified Agent APIs

Overview

Search the web with SERP, AI synthesis, or both

Credits

SERP: 1, AI: 2, Deep: 3

Providers

SerperDevPerplexity

SDK Method

client.search(...)

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.

SERP

1 credit

Raw Google SERP results.

Links, snippets, knowledge graph. Fastest.

AI

2 credits

AI-synthesized answers with citations.

Coherent answer with source citations. 2-4s.

Deep

3 credits

SERP + AI synthesis combined.

Raw sources plus synthesized answer. 3-6s.

Parameters

queryRequired

string

The search query.

num_results

number (default: 10)

Maximum number of organic results.

country

string (default: us)

ISO country code.

freshness

select (default: any)

Time filter.

Any time

Past 24 hours

Past week

Past month

Example Response

{
  "success": true,
  "data": {
    "answer": "AI funding reached record levels in Q1 2026. OpenAI closed a $110B round at $730B valuation, Anthropic raised $30B Series G at $380B, and xAI secured $20B.",
    "citations": [],
    "organic_results": [
      {
        "url": "https://techcrunch.com/2026/04/01/ai-funding",
        "title": "AI Funding Hits Record in Q1",
        "snippet": "Venture capital investment in AI startups reached unprecedented levels...",
        "position": 1
      }
    ],
    "knowledge_graph": null,
    "featured_snippet": null
  },
  "metadata": {
    "provider_used": "perplexity",
    "providers_tried": [
      "perplexity"
    ],
    "mode_used": "ai",
    "response_time_ms": 7481,
    "request_id": "req_48a34515"
  },
  "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