X (Twitter)

X data, one key, agent-ready

Unified access to tweets, user profiles, followers, search, and hashtag streams. Built for LLMs and automation — not one-off scraping.

Quickstart

3 options

Choose how you want to integrate the X (Twitter) API.

Register X (Twitter) tools natively in your agent's tool registry via a code plugin.

1

Install the plugin:

openclaw plugins install @agntdata/openclaw-x
2

Configure your API key in openclaw.json:

{
  "plugins": {
    "entries": {
      "agntdata-x": {
        "enabled": true,
        "config": {
          "apiKey": "${AGNTDATA_API_KEY}"
        }
      }
    }
  }
}
3

Restart OpenClaw — X (Twitter) tools are now available to your agent.

Want all 7 APIs at once?

Install the master plugin for unified access to every platform.

clawhub install agnt-data
openclaw plugins install @agntdata/openclaw-agnt-data
Endpoints

52

Cost / request

$0.01

Response format

JSON

OpenAPI version

1.0.0

Overview

The agntdata X API wraps X surface areas into a single integration. Instead of managing multiple keys, proxies, and rate limits yourself, you call agntdata with one credential and consume structured JSON optimized for downstream AI and analytics. Whether you are building a social listening agent, a content research pipeline, or a creator-intelligence product, this API gives you consistent access to tweets, user profiles, followers, search, and hashtag streams with predictable billing and operational simplicity.

Key features

Structured JSON responses for X resources
Single API key and unified credit balance across agntdata
Designed for agent workflows, batch jobs, and real-time tools
Composable with other agntdata providers in one stack
OpenAPI-documented endpoints for codegen and testing

Endpoints

52 endpoints across 8 categories. Click any row for detailed documentation.

52 total

User

23

User endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
getContinuation User's Media

AI agents that need X data in structured form

postContinuation User's Media

AI agents that need X data in structured form

getUser's Media

AI agents that need X data in structured form

postUser's Media

AI agents that need X data in structured form

getContinuation User's Likes

AI agents that need X data in structured form

postContinuation User's Likes

AI agents that need X data in structured form

getUser's Likes

AI agents that need X data in structured form

postUser's Likes

AI agents that need X data in structured form

getContinuation User's Followers

AI agents that need X data in structured form

postContinuation User's Followers

AI agents that need X data in structured form

getUser's Followers

AI agents that need X data in structured form

postUser's Followers

AI agents that need X data in structured form

getUser's Following Continuation

AI agents that need X data in structured form

postUser's Following Continuation

AI agents that need X data in structured form

getUser's Tweets

AI agents that need X data in structured form

postUser's Tweets

AI agents that need X data in structured form

getUser's Tweets Continuation

AI agents that need X data in structured form

postUser's Tweets Continuation

AI agents that need X data in structured form

getUser Details

AI agents that need X data in structured form

postUser Details

AI agents that need X data in structured form

getUser About

AI agents that need X data in structured form

getUser's Following

AI agents that need X data in structured form

postUser's Following

AI agents that need X data in structured form

Tweet

10

Tweet endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
getTweet Replies Continuation

AI agents that need X data in structured form

postTweet Replies Continuation

AI agents that need X data in structured form

getTweet User Favoriters Continuation

AI agents that need X data in structured form

getTweet User Retweets Continuation

AI agents that need X data in structured form

getTweet Details

AI agents that need X data in structured form

postTweet Details

AI agents that need X data in structured form

getTweet User Favoriters

AI agents that need X data in structured form

getTweet User Retweets

AI agents that need X data in structured form

getTweet Replies

AI agents that need X data in structured form

postTweet Replies

AI agents that need X data in structured form

Lists

3

Lists endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
getLists Tweets Continuation

AI agents that need X data in structured form

getLists Tweets

AI agents that need X data in structured form

getLists Details

AI agents that need X data in structured form

Search

5

Search endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
getSearch Continuation

AI agents that need X data in structured form

postSearch Continuation

AI agents that need X data in structured form

getGeo Search (Beta)

AI agents that need X data in structured form

getSearch

AI agents that need X data in structured form

postSearch

AI agents that need X data in structured form

AI

3

AI endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
getTopic Classification

AI agents that need X data in structured form

getNamed Entity Recognition

AI agents that need X data in structured form

getSentiment Analysis

AI agents that need X data in structured form

Translation

2

Translation endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
postDetect

AI agents that need X data in structured form

postTranslate

AI agents that need X data in structured form

Trends

2

Trends endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
getAvailable Locations (Beta)

AI agents that need X data in structured form

getGet trends near a location (Beta)

AI agents that need X data in structured form

Hashtag

4

Hashtag endpoints for X — programmatic access to tweets, user profiles, followers, search, and hashtag streams.

MethodEndpoint
getHashtag

AI agents that need X data in structured form

postHashtag

AI agents that need X data in structured form

getHashtag Continuation

AI agents that need X data in structured form

postHashtag Continuation

AI agents that need X data in structured form

Use cases

Social and creator intelligence agents using X
Marketing and research teams monitoring accounts and content
Product teams building alerts, digests, and dashboards
Developers prototyping LLM tools that need live network data
Data teams joining X signals with CRM or warehouse data

Ready to integrate?

Generate your API key in seconds and start calling 52 endpoints with a single credential. Free tier available with transparent pricing.

Frequently asked questions

X APIX data APIX for AI agentsunified social data APIagent-ready APIMCP data sourcestructured JSON API