Skip to main content
Images & Search

Web Search API

Search the live web through a single endpoint with a normalised result shape. From ₹1 per search.

Overview

One endpoint for live web search. Pick a mode, or name a search provider explicitly. We route the query, fail over to another provider if one is down, and return the same normalised response shape whichever provider answered.

Endpoint: POST /v1/search

Auth: Authorization: Bearer cm_your_key — the key must have the search permission (or *).

Cost: 1 credit (= ₹1) per successful search. Searches answered by exa add 0.1 credit for each result above 10 (so num_results: 50 on exa costs 5 credits). Failed upstream calls are not charged.

  1. 1

    Your app

    Send a + to

  2. 2

    CallMissed gateway

    Check the permission and pick the provider for the mode

  3. 3

    Search provider

    Picked from or , with automatic failover

  4. 4

    Your app

    Receive a normalized result list; you are charged only on success

Basic Usage

import httpx

r = httpx.post(
    "https://api.callmissed.com/v1/search",
    headers={"Authorization": "Bearer cm_your_key"},
    json={
        "query": "latest Indian AI startups raising funding",
        "mode": "shorter",       # or "detailed" / "auto"
        "num_results": 10,
    },
    timeout=15,
)
print(r.json()["results"][:3])

Modes

modeProviderDefault search_type
shorterfirecrawl (titles and snippets)search
detailedfirecrawl (also fetches each result's page text into content)auto
auto (default)your account's default mode if one is set, otherwise firecrawl—

Set provider to serper, exa, firecrawl or linkup to choose directly; when both mode and provider are set, provider wins. If the chosen provider fails, the request is retried on another provider your key allows, in the order firecrawl, serper, linkup, exa, so the provider field in the response may differ from the one you asked for. All providers return the same normalised shape.

Operators can set the tenant default from Settings → Web search default.

Request Body

FieldTypeDefaultNotes
querystring(required)1–2000 chars
modestring"auto"auto / shorter / detailed
providerstring—Optional raw override: serper / exa / firecrawl / linkup. Wins over mode
num_resultsint101–50
search_typestringmode defaultexa: auto/fast/instant/deep-lite/deep. serper: search/news/images. Ignored by linkup
include_domainsstring[]—Up to 50. Honoured by exa and linkup
exclude_domainsstring[]—Up to 50. Honoured by exa and linkup
start_published_dateYYYY-MM-DD—Honoured by exa and linkup. Any other format returns 422
end_published_dateYYYY-MM-DD—Honoured by exa and linkup. Any other format returns 422
include_contentboolfalseFetch page text into content. Honoured by exa and firecrawl (firecrawl also does this in detailed mode)
glstring—Country code (e.g. in, us). Honoured by serper
hlstring—Language code. Honoured by serper
tbsstring—Time filter, e.g. qdr:d (past day). Honoured by serper

A filter the serving provider does not honour is ignored, not rejected. Name the provider explicitly when a filter must apply.

Response Shape

Responses are normalised across providers — same keys regardless of which backend ran the query.

{
  "query": "latest Indian AI startups raising funding",
  "mode": "shorter",
  "provider": "serper",
  "results": [
    {
      "title": "Acme AI raises $...",
      "url": "https://example.com/article",
      "snippet": "Acme AI announced a funding round led by...",
      "content": "Full text if include_content=true, else null",
      "published_date": "2026-04-10T00:00:00.000Z",
      "score": 0.92,
      "source": "example.com"
    }
  ],
  "answer": "Optional grounded answer (provider-dependent)",
  "images": null,
  "credits_used": 1,
  "balance": 495.0,
  "request_id": "search-a3f8c1d2e0b9",
  "latency_ms": 920
}

Pricing & Credits

  • Base rate: 1 credit per successful search. 1 credit = ₹1.
  • exa surcharge: +0.1 credit per result above 10, charged on the provider that actually served the search.
  • Failed requests (upstream 5xx, rate limits, etc.) are not charged.
  • The charge is visible immediately in the credits_used + balance fields on the response, and in your credit history in the dashboard.
  • Per-key budget caps and the account's monthly budget cap both apply — hitting either returns HTTP 402.

Permissions

API keys must have search (or *) in their service permissions. Edit a key in your dashboard (↳ Profile → API Keys → Edit) and tick the Search chip.

You can also restrict which search providers a single key may call by editing Allowed web-search providers on the same edit panel. A request that names a provider the key does not allow (for example provider: "exa" on a key restricted to serper) returns HTTP 403 search_provider_not_allowed before any upstream request is made. Requests that use mode or auto are served by the first allowed provider in the failover order.

Errors

Error envelope matches the rest of /v1:

{ "error": { "message": "...", "type": "...", "code": "..." } }
StatusCodeMeaning
401invalid_api_keyBad or revoked key
402insufficient_creditsBalance < 1 credit or monthly budget exhausted
403permission_deniedKey lacks search permission
403search_provider_not_allowedYou named a provider the key does not allow, or no provider the key allows is available
422—Validation failed: query length, num_results outside 1–50, an unknown provider, a malformed date
429rate_limit_exceededPer-key RPM exceeded
503provider_errorNo search provider could answer. Retry shortly

On this page