Basic Web Search - Developer Guide

Web Search returns web results for a query without requiring an AI summary. Use it for search result pages, enrichment pipelines, rank tracking, and fast source discovery.

Endpoint

text

GET https://api.desearch.ai/web

Example request

bash

curl --request GET 'https://api.desearch.ai/web?query=latest%20AI%20search%20news&num=10&start=0' \
  --header 'Authorization: $DESEARCH_API_KEY'

Python example

python

import os
import requests

response = requests.get(
    "https://api.desearch.ai/web",
    params={"query": "latest AI search news", "num": 10, "start": 0},
    headers={"Authorization": os.environ["DESEARCH_API_KEY"]},
    timeout=60,
)
response.raise_for_status()
print(response.json())
print(response.headers.get("X-Desearch-Cost-Usd"))

JavaScript example

const url = new URL("https://api.desearch.ai/web");
url.searchParams.set("query", "latest AI search news");
url.searchParams.set("num", "10");
url.searchParams.set("start", "0");

const response = await fetch(url, {
  headers: { Authorization: process.env.DESEARCH_API_KEY },
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
console.log(response.headers.get("X-Desearch-Cost-Usd"));

Parameters

Parameter	Type	Notes
`query`	string	Search query.
`num`	integer	Number of results to return.
`start`	integer	Starting offset for pagination.

For endpoint-specific schemas and limits, use the API Reference.