---
title: "SERP Web Search API"
method: GET
path: "/web"
tags: ["Web Search"]
---

# SERP Web Search API

`GET /web`

## Request

- Base URL: `https://api.desearch.ai`
- URL: `https://api.desearch.ai/web`
- Auth: API key in header `Authorization`

This API allows users to search for any information over the web. This replicates a typical search engine experience, where users can search for any information they need.

Billing metadata: successful billable responses include the `X-Desearch-Cost-Usd`, `X-Desearch-Usage-Count`, `X-Desearch-Service`, and `X-Desearch-Currency` headers. JSON object responses also include optional `cost_usd`, `usage_count`, `service`, and `currency` fields. For example, `usage_count=10` at `$0.015 / 1,000` resolves to `cost_usd=0.00015`. JSON arrays, text, and streaming responses keep their body shape and expose billing metadata only through headers.

## Query parameters

- `query` string, required: The search query string, e.g., 'latest news on AI'.
- `start` integer: How many results to skip. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).

## Response `201`

A JSON object mapping Web Search to its search results.

- WebSearchResultsResponse
  - `data` WebSearchResultItem[], required
    - `title` string, required: EXCLUSIVE Major coffee buyers face losses as Colombia ...
    - `snippet` string, required: Coffee farmers in Colombia, the world's No. 2 arabica producer, have failed to deliver up to 1 million bags of beans this year or nearly 10% ...
    - `link` string, uri, required: https://www.reuters.com/world/americas/exclusive-major-coffee-buyers-face-losses-colombia-farmers-fail-deliver-2021-10-11/
    - `highlights` string[], nullable: Key excerpts from the page. Returned unless the request sets `highlights: false`.
    - `text` string, nullable: Full page text. Returned only when the request sets `page_text: true`.

## Other responses

- `301`: Moved Permanently
- `304`: Not Modified
- `401`: Unauthorized
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/desearch/apis/desearch-api.md) · [All operations](https://skmtc.dev/desearch/apis/desearch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desearch/apis/desearch-api/revisions/c2d7648859bd?raw)