xdataapi: X (Twitter) data is an MCP server published by io.xdataapi, hosted at api.xdataapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 15 tools, including get_user, get_users, get_user_tweets, get_users_tweets, get_followers.
Read-only public X (Twitter) data: profiles, tweets, threads, followers, search. Pay per result.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Profile of one X user by handle or by numeric user id. Give one of the two. The id stays the same when the user changes the handle. 1 credit.
| Parameter | Type | Description |
|---|---|---|
| id | string | Numeric user id |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| handle | string | Handle, with or without @ |
{
"name": "get_user",
"title": "Profile",
"description": "Profile of one X user by handle or by numeric user id. Give one of the two. The id stays the same when the user changes the handle. 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Numeric user id"
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"handle": {
"type": "string",
"maxLength": 16,
"minLength": 1,
"description": "Handle, with or without @"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Profiles of up to 100 X users in one call, by handle (handles) or by numeric user id (ids). Give one of the two lists. 1 credit per profile found.
| Parameter | Type | Description |
|---|---|---|
| ids | array | 1 to 100 numeric user ids. Give this or handles, not both. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| handles | array | 1 to 100 handles, with or without @. Give this or ids, not both. |
{
"name": "get_users",
"title": "Profiles, batch",
"description": "Profiles of up to 100 X users in one call, by handle (handles) or by numeric user id (ids). Give one of the two lists. 1 credit per profile found.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{1,19}$"
},
"maxItems": 100,
"minItems": 1,
"description": "1 to 100 numeric user ids. Give this or handles, not both."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"handles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 16,
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "1 to 100 handles, with or without @. Give this or ids, not both."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Latest tweets of a user, newest first. 1 credit per tweet.
| Parameter | Type | Description |
|---|---|---|
| user * | string | Handle (with or without @) or numeric user id |
| count | integer | Page size, 1 to 100. Default 20. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_user_tweets",
"title": "User tweets",
"description": "Latest tweets of a user, newest first. 1 credit per tweet.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Handle (with or without @) or numeric user id"
},
"count": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, 1 to 100. Default 20."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Latest tweets of up to 50 X users in one call, by numeric user id: count tweets for each user, newest first. One entry per user, in input order. 1 credit per tweet. A user with no public tweets is an empty list and costs nothing. To read more of one user, pass the next_cursor of the entry to get_user_tweets.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | 1 to 50 numeric user ids. get_users gives the id of a handle. |
| count | integer | Tweets for each user, 1 to 20. Default 3. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
{
"name": "get_users_tweets",
"title": "User tweets, batch",
"description": "Latest tweets of up to 50 X users in one call, by numeric user id: count tweets for each user, newest first. One entry per user, in input order. 1 credit per tweet. A user with no public tweets is an empty list and costs nothing. To read more of one user, pass the next_cursor of the entry to get_user_tweets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{1,19}$"
},
"maxItems": 50,
"minItems": 1,
"description": "1 to 50 numeric user ids. get_users gives the id of a handle."
},
"count": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Tweets for each user, 1 to 20. Default 3."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Followers of a user. 0.1 credit per profile. Not every account tier can read this; a 403 is free.
| Parameter | Type | Description |
|---|---|---|
| user * | string | Handle (with or without @) or numeric user id |
| count | integer | Page size, 1 to 200. Default 50. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_followers",
"title": "Followers",
"description": "Followers of a user. 0.1 credit per profile. Not every account tier can read this; a 403 is free.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Handle (with or without @) or numeric user id"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Page size, 1 to 200. Default 50."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Numeric ids of the followers of a user, no profiles. 0.02 credit per id. Same page as get_followers, so a page read there is a cache hit here. A 403 is free.
| Parameter | Type | Description |
|---|---|---|
| user * | string | Handle (with or without @) or numeric user id |
| count | integer | Page size, 1 to 200. Default 200. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_follower_ids",
"title": "Follower ids",
"description": "Numeric ids of the followers of a user, no profiles. 0.02 credit per id. Same page as get_followers, so a page read there is a cache hit here. A 403 is free.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Handle (with or without @) or numeric user id"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Page size, 1 to 200. Default 200."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Accounts a user follows. 0.1 credit per profile. Not every account tier can read this; a 403 is free.
| Parameter | Type | Description |
|---|---|---|
| user * | string | Handle (with or without @) or numeric user id |
| count | integer | Page size, 1 to 200. Default 50. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_following",
"title": "Following",
"description": "Accounts a user follows. 0.1 credit per profile. Not every account tier can read this; a 403 is free.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Handle (with or without @) or numeric user id"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Page size, 1 to 200. Default 50."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}X advanced search. q takes the x.com operators. 1 credit per tweet or profile. product Latest is always available; Top may answer 403 (free).
| Parameter | Type | Description |
|---|---|---|
| q * | string | Query with x.com operators, e.g. "from:x since:2026-09-01 -filter:replies" |
| count | integer | Page size, 1 to 50. Default 20. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
| product | string | Default Latest. People returns profiles. |
{
"name": "search_tweets",
"title": "Search",
"description": "X advanced search. q takes the x.com operators. 1 credit per tweet or profile. product Latest is always available; Top may answer 403 (free).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Query with x.com operators, e.g. \"from:x since:2026-09-01 -filter:replies\""
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1 to 50. Default 20."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
},
"product": {
"enum": [
"Latest",
"Top",
"People",
"Photos",
"Videos"
],
"type": "string",
"description": "Default Latest. People returns profiles."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}One tweet by numeric id, with its author. 1 credit.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Numeric tweet id: the digits after /status/ in the tweet URL |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
{
"name": "get_tweet",
"title": "Tweet",
"description": "One tweet by numeric id, with its author. 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,25}$",
"description": "Numeric tweet id: the digits after /status/ in the tweet URL"
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Up to 100 tweets by numeric id in one call. 1 credit per tweet found.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | 1 to 100 numeric tweet ids |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
{
"name": "get_tweets",
"title": "Tweets, batch",
"description": "Up to 100 tweets by numeric id in one call. 1 credit per tweet found.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{1,25}$"
},
"maxItems": 100,
"minItems": 1,
"description": "1 to 100 numeric tweet ids"
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A tweet with its thread and replies; the focal tweet comes first. 1 credit per tweet returned.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Numeric tweet id: the digits after /status/ in the tweet URL |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_thread",
"title": "Thread",
"description": "A tweet with its thread and replies; the focal tweet comes first. 1 credit per tweet returned.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,25}$",
"description": "Numeric tweet id: the digits after /status/ in the tweet URL"
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Direct replies to a tweet, one page. 1 credit per reply.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Numeric tweet id: the digits after /status/ in the tweet URL |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_replies",
"title": "Replies",
"description": "Direct replies to a tweet, one page. 1 credit per reply.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,25}$",
"description": "Numeric tweet id: the digits after /status/ in the tweet URL"
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Tweets that quote a tweet, newest first. 1 credit per tweet.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Numeric tweet id: the digits after /status/ in the tweet URL |
| count | integer | Page size, 1 to 50. Default 20. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_quotes",
"title": "Quotes",
"description": "Tweets that quote a tweet, newest first. 1 credit per tweet.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,25}$",
"description": "Numeric tweet id: the digits after /status/ in the tweet URL"
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1 to 50. Default 20."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Accounts that retweeted a tweet. 0.5 credit per profile. Not every account tier can read this; a 403 is free.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Numeric tweet id: the digits after /status/ in the tweet URL |
| count | integer | Page size, 1 to 200. Default 50. |
| fresh | boolean | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. |
| cursor | string | next_cursor from the previous page |
{
"name": "get_retweeters",
"title": "Retweeters",
"description": "Accounts that retweeted a tweet. 0.5 credit per profile. Not every account tier can read this; a 403 is free.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,25}$",
"description": "Numeric tweet id: the digits after /status/ in the tweet URL"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Page size, 1 to 200. Default 50."
},
"fresh": {
"type": "boolean",
"description": "Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Credits left on this key and its rate limit. Free.
No parameters.
{
"name": "get_balance",
"title": "Balance",
"description": "Credits left on this key and its rate limit. Free.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}xdataapi.io: read-only public X (Twitter) data. Credits: one credit per tweet or profile returned; empty results and errors are free; a repeated read within the cache window costs half. Every result carries credits_charged and balance_remaining. Users can be given as a handle (with or without @) or a numeric id. Pages return next_cursor; pass it back as cursor. Search takes the x.com operators: from:, to:, since:, until:, min_faves:, lang:, "phrase", OR, -.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.