llama-index-tools-xdataapi

LlamaIndex tool spec for xdataapi.io: read-only public X (Twitter) data. Profiles, posts, threads, replies, quotes, reposters, followers, and search with the x.com operators.

Read-only by design. No posting, no likes, no direct messages, no private data. Not affiliated with X Corp.

pip install llama-index-tools-xdataapi

Use

from llama_index.tools.xdataapi import XdataapiToolSpec

# Reads XDATAAPI_KEY from the environment.
tool_spec = XdataapiToolSpec()
tools = tool_spec.to_tool_list()

With an agent:

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.anthropic import Anthropic
from llama_index.tools.xdataapi import XdataapiToolSpec

agent = FunctionAgent(
    tools=XdataapiToolSpec(max_results=25).to_tool_list(),
    llm=Anthropic(model="claude-opus-5"),
)
print(await agent.run("What is @vercel posting about this week?"))

One call on its own:

XdataapiToolSpec().search_tweets(q="from:vercel since:2026-09-01", count=10)

Tools

Empty results and failed requests cost nothing. A repeated read inside the cache window costs half. Every response carries credits_charged and balance_remaining, so the model can watch the budget and stop on its own.

Spending guards

max_results caps the page size of every paging tool:

tool_spec = XdataapiToolSpec(max_results=25)

Narrow the surface with the LlamaIndex argument:

tools = XdataapiToolSpec().to_tool_list(spec_functions=["search_tweets", "get_user", "get_balance"])

Errors

A failure the model can act on — no credits, not found, a search product X refused — comes back as a dict with error.code, so the model can change plan. None of those are charged. A missing or revoked key raises XdataapiAuthError, because no model can repair it. Rate limits and upstream faults raise XdataapiError.

MCP instead

An agent that speaks MCP needs no package. The hosted server is at https://api.xdataapi.io/mcp (Streamable HTTP, OAuth or x-api-key), on the official MCP Registry as io.xdataapi/xdataapi.

Keys and pricing

Get a key at xdataapi.io/dashboard. 5,000 credits to start, no card. Prepaid packs from $10; credits never expire. Live status: xdataapi.io/status.

MIT licensed.