X Posts Search - Developer Guide

X Posts Search uses AI Search over X/Twitter posts. Use it when you need a prompt-driven X search workflow rather than raw keyword search.

Endpoint

text

POST https://api.desearch.ai/desearch/ai/search/links/twitter

Example request

bash

curl --request POST 'https://api.desearch.ai/desearch/ai/search/links/twitter' \
  --header 'Authorization: $DESEARCH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "recent posts about Bittensor subnet 22",
    "date_filter": "PAST_WEEK",
    "count": 10
  }'

Python example

python

import os
import requests

response = requests.post(
    "https://api.desearch.ai/desearch/ai/search/links/twitter",
    json={"prompt": "recent posts about Bittensor subnet 22", "date_filter": "PAST_WEEK", "count": 10},
    headers={"Authorization": os.environ["DESEARCH_API_KEY"], "Content-Type": "application/json"},
    timeout=60,
)
response.raise_for_status()
print(response.json())

When to use this vs X Search

Use case	Recommended endpoint
Prompt-based X search with AI ranking/context	`POST /desearch/ai/search/links/twitter`
Raw keyword search over X posts	`GET /twitter`
Retrieve a known post, profile, replies, or retweeters	Specific X retrieval endpoint in API Reference