Twitter/X Profile Lookup

Setup

Read your credentials from ~/.gooseworks/credentials.json:

bash
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Get profile information, tweets, and engagement data for any Twitter/X account.

When to Use

• User asks about a Twitter/X account
• User wants to see someone's tweets
• User asks "who is @username on Twitter?"
• Research on a public figure or company
• Social media due diligence

How It Works

Uses the Scrape Creators API via Orthogonal to scrape Twitter/X profile data and tweets.

Usage

Get User Profile

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"scrapecreators","path":"/v1/twitter/profile","query":{"handle":"openai"}}'

Get User's Tweets

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"scrapecreators","path":"/v1/twitter/user-tweets","query":{"handle":"openai"}}'

<details> <summary>curl equivalent</summary>

bash
curl -X POST "https://api.orth.sh/v1/run" \

  -H "Content-Type: application/json" \
  -d '{"api":"scrapecreators","path":"/v1/twitter/user-tweets","query":{"handle":"openai"}}'

</details>

Parameters

Profile

• handle (required) - Twitter handle (without @)

Tweets

• handle (required) - Twitter handle (without @)
• trim (optional) - Set to "true" for a trimmed response

Response

Profile Response

• User display name and handle
• Bio/description
• Follower and following counts
• Tweet count
• Profile and banner image URLs
• Verified status
• Account creation date
• Location and website (if set)

Tweets Response

• Tweet text content
• Like, retweet, reply counts
• Media attachments (images, videos)
• Timestamp
• Engagement metrics

Examples

User: "What has OpenAI been posting on X?"

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"scrapecreators","path":"/v1/twitter/user-tweets","query":{"handle":"openai"}}'

User: "Show me Sam Altman's recent tweets"

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"scrapecreators","path":"/v1/twitter/user-tweets","query":{"handle":"sama"}}'

User: "What's Anthropic sharing on Twitter?"

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"scrapecreators","path":"/v1/twitter/user-tweets","query":{"handle":"AnthropicAI"}}'

Error Handling

• success: false — the API may temporarily be unable to access the profile; retry after a few seconds
• Protected/private accounts return errors — no workaround
• Rate limiting may cause failures on rapid sequential requests — add short delays between calls

Tips

• Remove @ from handles
• Protected/private accounts cannot be accessed
• Returns recent tweets (not full history)
• Rate limiting may apply for very frequent requests