Twitter/X tools for LangChain agents – TwittrAPI

langchain-twittrapi is a set of LangChain tools for TwittrAPI, a REST API for public Twitter/X data. LangChain and LangGraph agents can read tweets, profiles, followers, search results, lists, communities and trends. Pay as you go from $0.065 per 1,000 calls, no X developer account. Not affiliated with X Corp.

Get an API key: twittrapi.com/start · Pricing · Docs · Status · also available on RapidAPI

SDKs and integrations: Python · Node.js · Go · MCP server · n8n · Make · Apify · LlamaIndex · Agent skill · Examples

All tools are read-only. They are built on the official twittrapi Python SDK.

Install

pip install -U langchain-twittrapi

Python 3.10 or newer. Works with langchain-core 1.x.

Authentication

Use either a direct TwittrAPI key or a RapidAPI key.

export TWITTRAPI_API_KEY="your-twittrapi-key"   # direct API
# or
export RAPIDAPI_KEY="your-rapidapi-key"         # RapidAPI

Or pass the key in code:

from langchain_twittrapi import TwittrAPIToolkit

toolkit = TwittrAPIToolkit(api_key="your-twittrapi-key")     # direct API
toolkit = TwittrAPIToolkit(rapidapi_key="your-rapidapi-key") # RapidAPI

If both environment variables are set, TWITTRAPI_API_KEY wins.

Quickstart

Use one tool

from langchain_twittrapi import GetUserByUsernameTool

tool = GetUserByUsernameTool()
print(tool.invoke({"username": "jack"}))

Give an agent all the tools

pip install -U langchain "langchain[anthropic]"

from langchain.agents import create_agent
from langchain_twittrapi import TwittrAPIToolkit

tools = TwittrAPIToolkit().get_tools()

agent = create_agent(
    "anthropic:claude-opus-5-5",
    tools=tools,
    system_prompt="You research X (Twitter) with the tools you have. Cite tweet IDs.",
)

result = agent.invoke(
    {"messages": [{"role": "user", "content": "What has @jack posted this week? Summarize it."}]}
)
print(result["messages"][-1].content)

Any chat model that supports tool calling works. To pick a subset of tools:

tools = TwittrAPIToolkit().get_tools(["search_tweets", "get_tweet"])

Async

Every tool supports ainvoke. The toolkit creates one AsyncTwittrAPI client for async calls, so async agents do not block on HTTP.

result = await agent.ainvoke({"messages": [{"role": "user", "content": "Trending in the US?"}]})

Tools

What the tools return

The tools return the API's simple format as compact JSON text: flat, camelCase tweets and users with a fixed schema (id, text, author, counts, media, ...). It uses far fewer tokens than X's raw JSON. Lists come as {"data": [...], "nextCursor": ..., "previousCursor": ..., "hasNextPage": ...}, single objects as {"data": {...}}.

For X's raw JSON (every field X sends: cards, polls, edit history, ...), opt out per toolkit or per tool:

TwittrAPIToolkit(api_response_format="raw")
GetTweetTool(api_response_format="raw")

(The option is named api_response_format because LangChain tools already have a response_format field.)

Responses can be large, so each result is cut at max_chars characters (default 20,000). When that happens the text ends with a [TRUNCATED: ...] marker that says how much was cut.

Paginated tools print the next-page cursor on the first line, before the JSON, so it is never lost to truncation:

next_cursor: DAABCgABF...
Pass next_cursor as `cursor` to get the next page.

{"data":[...],"nextCursor":"DAABCgABF...","previousCursor":"...","hasNextPage":true}

On the last page (hasNextPage is false) the first line says so instead.

Change the limit per toolkit or per tool:

TwittrAPIToolkit(max_chars=8_000)
GetTweetTool(max_chars=50_000)

Errors

API errors (bad key, no balance, not found, rate limit) and invalid arguments are returned to the model as the tool result, starting with TwittrAPI error: or Invalid arguments:. When the tool runs from a tool call, the ToolMessage has status="error". To raise instead, pass handle_tool_error=False.

Requests that fail with 429, 5xx or a network error are retried by the SDK.

Bring your own client

To change timeouts or retries, build the SDK clients yourself and pass them in:

from twittrapi import AsyncTwittrAPI, TwittrAPI
from langchain_twittrapi import TwittrAPIToolkit

toolkit = TwittrAPIToolkit(
    client=TwittrAPI(api_key="...", timeout=30, max_retries=4),
    async_client=AsyncTwittrAPI(api_key="...", timeout=30, max_retries=4),
)

If you pass only client, async calls run it in a worker thread.

Development

python -m venv .venv && source .venv/bin/activate
pip install -e . pytest pytest-asyncio langchain-tests
pytest

Support

Questions, bugs or billing: support@twittrapi.com. Issues with this package: GitHub issues.

License

MIT. See LICENSE.

Not affiliated with X Corp.