Server definition
- Hash
- sha256:bbdee92e3addf4c2cfafcc12ecdc7d973211da2279e67440951570f52d179be8
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": "Social Data API is one API key for TikTok, X, Instagram and Reddit data. TikTok and X are live now; Instagram and Reddit are not available yet and have no tools here. Every data call costs 1 credit, except looking up a TikTok creator's videos by username, which costs 2 credits (one extra profile lookup to resolve the username). One call returns up to 20 items by default (up to 50 with count). Trial keys cover TikTok only (100 calls, 3 days). Pay-as-you-go is $0.003 per call for TikTok and X. Monthly plans are $29 for 10,000 calls and $99 for 50,000 calls. Use check_balance first if you are unsure how many credits the key has left. Get a key at https://socialdataapi.site (3-day free trial on Basic).",
"tools": [
{
"description": "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.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "check_balance",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"aweme_id": {
"description": "Numeric TikTok video id.",
"type": "string"
},
"count": {
"default": 20,
"description": "Comments to return, 1-50. Default 20.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"cursor": {
"default": 0,
"description": "Pagination cursor.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"aweme_id"
],
"type": "object"
},
"name": "tiktok_comments",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"anyOf": [
{
"required": [
"uniqueId"
]
},
{
"required": [
"secUid"
]
}
],
"properties": {
"secUid": {
"description": "TikTok secUid (stable creator id). Use this if you already have it from a previous call.",
"type": "string"
},
"uniqueId": {
"description": "TikTok username, without @ (e.g. 'tiktok').",
"type": "string"
}
},
"type": "object"
},
"name": "tiktok_profile",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"count": {
"default": 20,
"description": "Videos to return, 1-50. Default 20.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"keyword": {
"description": "Search term, e.g. 'dear person behind me hoodie'.",
"type": "string"
},
"offset": {
"default": 0,
"description": "Pagination offset.",
"minimum": 0,
"type": "integer"
},
"sort_type": {
"default": 0,
"description": "Sort order (0, 1 or 2). Default 0.",
"maximum": 2,
"minimum": 0,
"type": "integer"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "tiktok_search",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"anyOf": [
{
"required": [
"uniqueId"
]
},
{
"required": [
"secUid"
]
}
],
"properties": {
"count": {
"default": 20,
"description": "Videos to return, 1-50. Default 20.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"cursor": {
"default": 0,
"description": "Pagination cursor.",
"minimum": 0,
"type": "integer"
},
"secUid": {
"description": "TikTok secUid. Costs 1 credit.",
"type": "string"
},
"uniqueId": {
"description": "TikTok username, without @. Costs 2 credits (includes the profile lookup).",
"type": "string"
}
},
"type": "object"
},
"name": "tiktok_videos",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"properties": {
"cursor": {
"description": "Pagination cursor from a previous call.",
"type": "string"
},
"tweet_id": {
"description": "Numeric tweet id.",
"type": "string"
}
},
"required": [
"tweet_id"
],
"type": "object"
},
"name": "x_comments",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"anyOf": [
{
"required": [
"username"
]
},
{
"required": [
"user_id"
]
}
],
"properties": {
"cursor": {
"description": "Pagination cursor from a previous call.",
"type": "string"
},
"user_id": {
"description": "Numeric X user id.",
"type": "string"
},
"username": {
"description": "X handle, without @ (e.g. 'elonmusk').",
"type": "string"
}
},
"type": "object"
},
"name": "x_posts",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"anyOf": [
{
"required": [
"username"
]
},
{
"required": [
"user_id"
]
}
],
"properties": {
"user_id": {
"description": "Numeric X user id.",
"type": "string"
},
"username": {
"description": "X handle, without @ (e.g. 'elonmusk').",
"type": "string"
}
},
"type": "object"
},
"name": "x_profile",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"properties": {
"cursor": {
"description": "Pagination cursor from a previous call.",
"type": "string"
},
"query": {
"description": "Search term, e.g. 'dear person behind me hoodie'.",
"type": "string"
},
"search_type": {
"default": "Top",
"description": "Result type, e.g. 'Top' or 'Latest'. Default 'Top'.",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "x_search",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:bbdee92e3addf4c2cfafcc12ecdc7d973211da2279e67440951570f52d179be8 | sha256sum