One API key for TikTok, X, Instagram and Reddit data. TikTok and X are live now.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Check this API key's plan, credits remaining and trial status (trial end date, days left, whether the trial has started). Free — costs 0 credits. Use it before a batch of calls if you are unsure what the key has left.
This tool takes no arguments.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http social-data-api https://social-data-api-mcp.chideraezeudu2.workers.dev/mcp
Check this API key's plan, credits remaining and trial status (trial end date, days left, whether the trial has started). Free — costs 0 credits. Use it before a batch of calls if you are unsure what the key has left.
No arguments.
{
"type": "object",
"properties": {}
}Get the comments on a TikTok video. One call returns up to 20 comments (up to 50 with count): text, author, likes and reply counts. Use this to read buying-intent signals in the buyers' own words, e.g. 'where can I buy this'. Costs 1 credit.
| Argument | Type | Description |
|---|---|---|
| count | integer | Comments to return, 1-50. Default 20. |
| cursor | integer | Pagination cursor. |
| aweme_id* | string | Numeric TikTok video id. |
{
"type": "object",
"required": [
"aweme_id"
],
"properties": {
"count": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Comments to return, 1-50. Default 20."
},
"cursor": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Pagination cursor."
},
"aweme_id": {
"type": "string",
"description": "Numeric TikTok video id."
}
}
}Get a TikTok creator's public profile: follower and following counts, total likes, bio, avatar and verified status. One call returns one profile. Costs 1 credit.
| Argument | Type | Description |
|---|---|---|
| secUid | string | TikTok secUid (stable creator id). Use this if you already have it from a previous call. |
| uniqueId | string | TikTok username, without @ (e.g. 'tiktok'). |
{
"type": "object",
"anyOf": [
{
"required": [
"uniqueId"
]
},
{
"required": [
"secUid"
]
}
],
"properties": {
"secUid": {
"type": "string",
"description": "TikTok secUid (stable creator id). Use this if you already have it from a previous call."
},
"uniqueId": {
"type": "string",
"description": "TikTok username, without @ (e.g. 'tiktok')."
}
}
}Search TikTok videos by keyword. One call returns up to 20 videos (up to 50 with count): views, likes, comments, shares, author, caption and hashtags. Costs 1 credit.
| Argument | Type | Description |
|---|---|---|
| count | integer | Videos to return, 1-50. Default 20. |
| offset | integer | Pagination offset. |
| keyword* | string | Search term, e.g. 'dear person behind me hoodie'. |
| sort_type | integer | Sort order (0, 1 or 2). Default 0. |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"count": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Videos to return, 1-50. Default 20."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Pagination offset."
},
"keyword": {
"type": "string",
"description": "Search term, e.g. 'dear person behind me hoodie'."
},
"sort_type": {
"type": "integer",
"default": 0,
"maximum": 2,
"minimum": 0,
"description": "Sort order (0, 1 or 2). Default 0."
}
}
}List a TikTok creator's videos, newest first. One call returns up to 20 videos (up to 50 with count). By username costs 2 credits (one extra profile lookup to resolve the username); by secUid costs 1 credit.
| Argument | Type | Description |
|---|---|---|
| count | integer | Videos to return, 1-50. Default 20. |
| cursor | integer | Pagination cursor. |
| secUid | string | TikTok secUid. Costs 1 credit. |
| uniqueId | string | TikTok username, without @. Costs 2 credits (includes the profile lookup). |
{
"type": "object",
"anyOf": [
{
"required": [
"uniqueId"
]
},
{
"required": [
"secUid"
]
}
],
"properties": {
"count": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Videos to return, 1-50. Default 20."
},
"cursor": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Pagination cursor."
},
"secUid": {
"type": "string",
"description": "TikTok secUid. Costs 1 credit."
},
"uniqueId": {
"type": "string",
"description": "TikTok username, without @. Costs 2 credits (includes the profile lookup)."
}
}
}Get the replies to an X post. One call returns up to 20 replies: text, author and engagement. Costs 1 credit. Paid plans and pay-as-you-go only — trial keys get an error (the trial is TikTok only).
| Argument | Type | Description |
|---|---|---|
| cursor | string | Pagination cursor from a previous call. |
| tweet_id* | string | Numeric tweet id. |
{
"type": "object",
"required": [
"tweet_id"
],
"properties": {
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous call."
},
"tweet_id": {
"type": "string",
"description": "Numeric tweet id."
}
}
}List an X user's posts, newest first. One call returns up to 20 posts. Costs 1 credit. Paid plans and pay-as-you-go only — trial keys get an error (the trial is TikTok only).
| Argument | Type | Description |
|---|---|---|
| cursor | string | Pagination cursor from a previous call. |
| user_id | string | Numeric X user id. |
| username | string | X handle, without @ (e.g. 'elonmusk'). |
{
"type": "object",
"anyOf": [
{
"required": [
"username"
]
},
{
"required": [
"user_id"
]
}
],
"properties": {
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous call."
},
"user_id": {
"type": "string",
"description": "Numeric X user id."
},
"username": {
"type": "string",
"description": "X handle, without @ (e.g. 'elonmusk')."
}
}
}Get an X (Twitter) user's public profile: followers, following, bio and verified status. One call returns one profile. Costs 1 credit. Paid plans and pay-as-you-go only — trial keys get an error (the trial is TikTok only).
| Argument | Type | Description |
|---|---|---|
| user_id | string | Numeric X user id. |
| username | string | X handle, without @ (e.g. 'elonmusk'). |
{
"type": "object",
"anyOf": [
{
"required": [
"username"
]
},
{
"required": [
"user_id"
]
}
],
"properties": {
"user_id": {
"type": "string",
"description": "Numeric X user id."
},
"username": {
"type": "string",
"description": "X handle, without @ (e.g. 'elonmusk')."
}
}
}Search X posts by keyword. One call returns up to 20 posts: text, author, likes, reposts, replies and timestamps. Costs 1 credit. Paid plans and pay-as-you-go only — trial keys get an error (the trial is TikTok only).
| Argument | Type | Description |
|---|---|---|
| query* | string | Search term, e.g. 'dear person behind me hoodie'. |
| cursor | string | Pagination cursor from a previous call. |
| search_type | string | Result type, e.g. 'Top' or 'Latest'. Default 'Top'. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search term, e.g. 'dear person behind me hoodie'."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous call."
},
"search_type": {
"type": "string",
"default": "Top",
"description": "Result type, e.g. 'Top' or 'Latest'. Default 'Top'."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 9, 2026.