DocumentationAPI Reference
    Get API keyOpenAPI specPython SDKJavaScript SDK
    API StatusGitHubDiscord

    X API

    The X API returns posts and related metadata from X/Twitter: keyword search, a user's posts, replies, retweeters, and trends.

    Search posts

    text
    GET https://api.desearch.ai/twitter
    bash
    curl --request GET 'https://api.desearch.ai/twitter?query=Bittensor&sort=Top&count=20' \ --header "Authorization: $DESEARCH_API_KEY"

    The query string supports X's full operator syntax: from:, to:, since:, min_faves:, exact phrases, and boolean logic. The complete list is in X query syntax.

    Everything else on X

    EndpointReturns
    GET /twitter/postA single post by ID.
    GET /twitter/user/postsA user's recent posts.
    GET /twitter/replies · /twitter/replies/postReplies, by user or by post.
    GET /twitter/post/retweetersWho retweeted a post.
    GET /twitter/urlsPosts linking to a URL.
    GET /twitter/trendsCurrent trends.

    For semantic search over posts with AI ranking, use the Search API with "tools": ["twitter"] instead. It answers a prompt, while these endpoints match queries exactly.

    Parameters and response schemas are in the API Reference.