Twitter

Twitter / X Reader (SocialData)

Fetch a SPECIFIC tweet, article, thread, profile, or timeline by URL/id.

Search / discovery / radar / "what's viral" → use the x-research skill (Grok Live Search), NOT this one. This skill is fetch-by-url/id only.

What handles what

Setup

# SocialData API key (register at https://socialdata.tools)
echo 'your-key' > ~/.claude-lab/shared/secrets/socialdata-api-key
SOCIALDATA_API_KEY=$(cat ~/.claude-lab/shared/secrets/socialdata-api-key)

Single Tweet

# https://x.com/elonmusk/status/1234567890  -> tweet_id = 1234567890
curl -sS "https://api.socialdata.tools/twitter/tweets/1234567890" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY"

User Profile

curl -sS "https://api.socialdata.tools/twitter/user/elonmusk" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY"

Thread

curl -sS "https://api.socialdata.tools/twitter/thread/TWEET_ID" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY"

X Article (long-form)

# 1. Get the tweet, find article_id in entities.urls (x.com/i/article/{article_id})
# 2. Fetch the article:
curl -sS "https://api.socialdata.tools/twitter/article/ARTICLE_ID" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY"

User Timeline (needs user_id, not username)

USER_ID=$(curl -sS "https://api.socialdata.tools/twitter/user/elonmusk" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY" | python3 -c "import json,sys;print(json.load(sys.stdin)['id'])")
curl -sS "https://api.socialdata.tools/twitter/user/$USER_ID/tweets" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY"

Search (prefer x-research)

For search/discovery use the x-research skill (Grok). SocialData search is kept only for precise Advanced-Search-operator queries that need a raw tweet list:

curl -sS "https://api.socialdata.tools/twitter/search" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY" \
  -G -d "query=from:elonmusk AI agents" -d "type=Latest"

Comments on a tweet

curl -sS "https://api.socialdata.tools/twitter/tweets/TWEET_ID/comments" \
  -H "Authorization: Bearer $SOCIALDATA_API_KEY"

Error Handling