# Desearch AI

> Live AI, web, and X search APIs for agents, search products, research tools, dashboards, and data workflows. Built on Bittensor Subnet 22.

Last reviewed: 2026-09-21 UTC
Primary API base URL: `https://api.desearch.ai`
Authentication: pass the API key in the `Authorization` header, for example `Authorization: $DESEARCH_API_KEY`.

## Canonical links

- Website: https://www.desearch.ai/
- Console and API keys: https://console.desearch.ai/
- Guide: https://www.desearch.ai/docs/guide/introduction/desearch-ai
- API overview: https://www.desearch.ai/docs/guide/apis/search-api
- Pricing and billing: https://www.desearch.ai/docs/guide/introduction/pricing-and-billing
- API reference: https://www.desearch.ai/docs/api-reference
- Runtime OpenAPI: https://api.desearch.ai/openapi.json
- Website OpenAPI mirror: https://www.desearch.ai/openapi.json
- Full LLM context: https://www.desearch.ai/llms-full.txt
- API status: https://status.desearch.ai/
- GitHub: https://github.com/desearch-ai
- Discord: https://discord.com/invite/eb6DTZNMF5

## Company

- Desearch was co-founded by Giga Chkhikvadze (CEO) and Mirian Okradze (CTO).
- About: https://www.desearch.ai/about

## What Desearch is best for

- AI agents that need fresh web and X context before reasoning, writing, or acting.
- Search products that need structured AI search, web search, and X/Twitter retrieval.
- Market, trend, and research workflows that monitor posts, links, and source pages.
- Data enrichment pipelines that need normalized source URLs, posts, summaries, and usage metadata.

## Current API families

- AI Search — multi-source AI-assisted search, web-link discovery, and X post search.
- Web Search — SERP-style web results and extracted page content.
- X Search — X/Twitter search, post lookup, URL lookup, user posts, replies, retweeters, and trends.
- TikTok Search — public TikTok search, post/profile lookup, profile posts, comments, hashtags, and trending posts.
- Facebook Search — public Meta/Facebook search plus public post, profile/page, page posts, comments, and hashtag-style records.
- Instagram Search — public Instagram profile/media/search, profile posts, comments, and hashtag media.

## Endpoint overview

### AI Search
- `POST /desearch/ai/search` — AI Contextual Search.
- `POST /desearch/ai/search/links/twitter` — AI X Posts Search.
- `POST /desearch/ai/search/links/web` — AI Web Search.

### Web Search
- `GET /web` — SERP Web Search API.
- `GET /web/extract` — Extract API.
- `GET /web/crawl` — deprecated compatibility alias for Extract API.

### X Search
- `GET /twitter` — X Search API.
- `GET /twitter/post` — Retrieve Post by ID.
- `GET /twitter/post/retweeters` — Get Retweeters of a Post.
- `GET /twitter/post/user` — Search X Posts by User.
- `GET /twitter/replies` — Fetch User's Tweets and Replies.
- `GET /twitter/replies/post` — Retrieve Replies for a Post.
- `GET /twitter/trends` — Get X Trends.
- `GET /twitter/urls` — Fetch Posts by URLs.
- `GET /twitter/user/posts` — Get X Posts by Username.

### TikTok Search
- `GET /desearch/tiktok/comments/{video_id}` — Retrieve TikTok Comments.
- `GET /desearch/tiktok/hashtag/{tag}` — Retrieve TikTok Hashtag Posts.
- `GET /desearch/tiktok/post/{id}` — Retrieve TikTok Post by ID.
- `GET /desearch/tiktok/profile/{username}` — Retrieve TikTok Profile.
- `GET /desearch/tiktok/profile/{username}/posts` — Retrieve TikTok Profile Posts.
- `POST /desearch/tiktok/search` — TikTok Search API.
- `GET /desearch/tiktok/trending` — Retrieve TikTok Trending Posts.

### Facebook Search
- `GET /desearch/facebook/comments/{post_id}` — Retrieve Facebook Comments.
- `GET /desearch/facebook/hashtag/{tag}` — Retrieve Facebook Hashtag Posts.
- `GET /desearch/facebook/post/{id}` — Retrieve Facebook Post by ID.
- `GET /desearch/facebook/profile/{profile_id}` — Retrieve Facebook Profile or Page.
- `GET /desearch/facebook/profile/{profile_id}/posts` — Retrieve Facebook Profile/Page Posts.
- `POST /desearch/facebook/search` — Facebook Search API.

### Instagram Search
- `GET /desearch/instagram/comments/{media_id}` — Retrieve Instagram Comments.
- `GET /desearch/instagram/hashtag/{tag}` — Retrieve Instagram Hashtag Media.
- `GET /desearch/instagram/media/{id}` — Retrieve Instagram Media by ID.
- `GET /desearch/instagram/profile/{username}` — Retrieve Instagram Profile.
- `GET /desearch/instagram/profile/{username}/posts` — Retrieve Instagram Profile Posts.
- `POST /desearch/instagram/search` — Instagram Search API.

## Quick start

```bash
curl --request POST 'https://api.desearch.ai/desearch/ai/search' \
  --header "Authorization: $DESEARCH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "latest Bittensor subnet 22 updates",
    "tools": ["web", "twitter", "reddit"],
    "date_filter": "PAST_WEEK",
    "count": 10,
    "streaming": false
  }'
```

## Pricing

Desearch is usage-based. Reference rates as of 7 May 2026, in USD (see https://www.desearch.ai/pricing; Console shows account-specific rates):

- AI Search (`POST /desearch/ai/search`): $0.40 per 1,000 items.
- Web Search (`GET /web`): $1.00 per 1,000 searches, metered as $0.10 per 100 searches.
- Extract (`GET /web/extract`): $0.50 per 1,000 pages.
- X Search (`GET /twitter`): $0.15 per 1,000 posts. X profile lookups: $0.15 per 1,000 users.
- New accounts receive $5 in API credits when they attach a card in Console; usage is pay-as-you-go after that.

## Billing metadata

Billable responses expose cost metadata in USD:

- Headers: `X-Desearch-Cost-Usd`, `X-Desearch-Usage-Count`, `X-Desearch-Service`, `X-Desearch-Currency`.
- JSON object bodies may also include `cost_usd`, `usage_count`, `service`, and `currency`.
- JSON arrays, text responses, and streaming/SSE responses preserve their body shape and expose billing metadata through headers.
- Example math: an AI Search response with `usage_count=10` at $0.40 per 1,000 items reports `cost_usd=0.004`.

## SDKs

- Python SDK: `pip install desearch-py`, then `from desearch_py import Desearch`.
- JavaScript SDK (Node.js 20.18.1 or later): `npm install desearch-js`, then `const { Desearch } = require("desearch-js")` or `import { Desearch } from "desearch-js"`.
- Keep production API keys in environment variables or a secret manager. Do not expose keys in browser bundles.

## Scope notes for social APIs

- Facebook endpoints focus on public Meta Ad Library and normalized public Facebook surfaces. Private/account-authenticated surfaces, messaging, and publishing are not exposed.
- Instagram endpoints focus on public profile, media, comments, and hashtag media. Login, posting, messaging, and private surfaces are not exposed.
- TikTok endpoints focus on public search and normalized public post/profile/comment/hashtag/trending data. Download-only or no-watermark media surfaces are not exposed.

## Security and compliance

- [Security at Desearch](https://www.desearch.ai/security): SOC 2 Type II report (shared under NDA), GDPR, Data Processing Agreement, zero data retention, controls aligned with the HIPAA Security Rule, and vulnerability reporting.
- [Security and compliance docs](https://www.desearch.ai/docs/guide/introduction/security-and-compliance): how to request documents, enable zero data retention, and report a vulnerability.