# Desearch AI

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

Last reviewed: 2026-05-31 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/desearch-api
- Pricing and billing: https://www.desearch.ai/docs/guide/apis/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

## What Desearch is best for

- AI agents that need fresh web and social context before reasoning, writing, or acting.
- Search products that need structured AI search, web search, X/Twitter retrieval, and social data APIs.
- Market, trend, and research workflows that monitor posts, profiles, comments, links, and source pages.
- Data enrichment pipelines that need normalized source URLs, posts, media, comments, 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 crawl output.
- 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.
- Numinous Forecasting — create a forecast job and poll forecast results.

## 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/crawl` — Crawl 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.

### Numinous Forecasting
- `POST /numinous/forecasts` — Create Forecast Job.
- `GET /numinous/forecasts/{prediction_id}` — Get Forecast Result.

## 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
  }'
```

## Billing metadata

Desearch is usage-based. Check Console pricing for the latest account-specific rates. 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: `usage_count=10` at `$0.015 / 1,000` reports `cost_usd=0.00015`.

## SDKs

- Python SDK: `pip install desearch-py`, then `from desearch_py import Desearch`.
- JavaScript SDK: `npm install desearch-js`, then `const { Desearch } = require("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.
- Forecast result polling uses the returned `prediction_id`; treat it as access-bearing data.