DocumentationAPI Reference
    Desearch AI

    Desearch AI

    Set up Desearch in your coding agent

    Connect over MCP (hosted HTTP) with your Desearch API key. Endpoint: https://mcp.desearch.ai/mcp. See live tools/list.

    claude mcp add --transport http desearch https://mcp.desearch.ai/mcp

    Desearch is one API for web, social, and AI-assisted search. Use it when your product or agent needs current information from the web, X, TikTok, Facebook, Instagram, and other supported sources instead of stale training data.

    Desearch is available through:

    • Desearch Console: create API keys, test requests in the playground, monitor usage, and manage billing.
    • REST API: call search and retrieval endpoints directly from your backend.
    • SDKs and integrations: Python, JavaScript, MCP, OpenAI-style workflows, function calling, and RAG examples.

    What Desearch is for

    • AI agents that need fresh context: retrieve current web and social results before an agent writes, reasons, or acts.
    • Search products: build AI search, web search, and social search with structured API responses.
    • Market and trend intelligence: monitor discussions, posts, comments, profiles, and links across major sources.
    • Data enrichment: retrieve source URLs, posts, profiles, media, comments, and summaries for downstream pipelines.

    Main API families

    API familyUse it for
    AI SearchMulti-source AI search with links and summaries.
    Web SearchSERP-style web results and extracted page content.
    X SearchX/Twitter search, post lookup, users, replies, retweeters, and trends.
    TikTok SearchTikTok search, post/profile lookup, profile posts, comments, hashtags, and trending posts.
    Facebook SearchFacebook search, post lookup, profile/page lookup, page posts, comments, and hashtags.
    Instagram SearchInstagram search, media/profile lookup, profile posts, comments, and hashtag media.

    For Numinous subnet operator wiring, see Numinous SN6 × Desearch Integration.

    Quick start

    1. Create an account in Desearch Console.
    2. Generate an API key from API Keys.
    3. Call the REST API with your key in the Authorization header.
    4. Check Pricing and Billing for usage, request-cost metadata, and balance management.
    5. Use the API Reference for endpoint-specific parameters and responses.
    bash
    curl --request POST 'https://api.desearch.ai/desearch/ai/search' \ --header "Authorization: $DESEARCH_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "prompt": "latest AI search API benchmarks", "tools": ["web", "reddit", "arxiv"], "date_filter": "PAST_WEEK", "count": 10, "streaming": false }'

    Keep API keys server-side. Do not expose production keys in browser code, public repos, screenshots, or support messages.