Web Search By Desearch

Real-time web search returning structured SERP-style results with titles, links, and snippets.

Quick Start

1. Get an API key from https://console.desearch.ai
2. Set environment variable: export DESEARCH_API_KEY='your-key-here'

Usage

# Basic web search
desearch.py web "quantum computing"

# Paginated results
desearch.py web "quantum computing" --start 10

Options

Option	Description
--start	Pagination offset (default: 0). Use to get the next page of results.

Response

Example

desearch.py web "best sights in Georgia"

{
  "data": [
    {
      "title": "Cool places and fun things to do in Georgia ? : r/solotravel",
      "snippet": "I was in Georgia earlier this month. My favorite place was Mtirala National Park in Adjara. The mountains and forest were absolutely beautiful ...",
      "link": "https://www.reddit.com/r/solotravel/comments/py4wls/cool_places_and_fun_things_to_do_in_georgia/",
    },
  ]
}

Notes

• Returns up to 10 results per page. Use --start to paginate.

Errors

Status 401, Unauthorized (e.g., missing/invalid API key)

{
  "detail": "Invalid or missing API key"
}

Status 402, Payment Required (e.g., balance depleted)

{
  "detail": "Insufficient balance, please add funds to your account to continue using the service."
}

Resources

• API Reference
• Desearch Console