glimglim.shdocs
Tools

Twitter / X

Search tweets with full advanced-operator syntax, fetch a tweet with its whole thread, or pull a user profile with recent timeline — enriched with engagement summaries and topic rollups.

Tools & pricing

  • glim_twitter_search / POST /api/v1/twitter/search — $0.005 per call. query supports operators like from:, min_faves:, since:; cursor paginates.
  • glim_twitter_get / POST /api/v1/twitter/get — $0.005 per call. One ref accepts a tweet URL, bare tweet id, or profile URL; returns the tweet with thread context, or the user with ~20 recent tweets.

Example

request
curl -X POST https://glim.sh/api/v1/twitter/search \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"x402 payments"}'
response (real call, trimmed to 1 of 20 tweets)
{
  "tweets": [
    {
      "id": "2065371619040657462",
      "url": "https://x.com/Jonathanwilsoon/status/2065371619040657462",
      "text": "Gasless transactions via EIP-3009 payment authorization\n\nStandardized payment flows across web services…",
      "created_at": "2026-06-12T09:52:21.000Z",
      "author": {
        "username": "Jonathanwilsoon",
        "name": "Joπathaπ Wilsoπ",
        "verified": true,
        "public_metrics": { "followers_count": 124, "tweet_count": 2078 }
      }
    }
  ],
  "count": 20,
  "summary": {
    "total_likes": 378, "total_impressions": 35178,
    "avg_engagement_rate": 0.0484, "top_tweet_id": "2065345280757891245",
    "time_span_hours": 5.4
  },
  "topics": {
    "top_hashtags": [{ "tag": "x402", "count": 2 }],
    "top_mentioned_users": [{ "username": "coinbase", "count": 3 }]
  },
  "has_more": true,
  "next_cursor": "…"
}

Good to know

  • Search returns ~20 tweets per page with a summary (engagement totals/averages) and topics (hashtags, domains, mentions) rollup — pass next_cursor back as cursor for more.
  • Invalid refs return 400 with a suggestion; a missing tweet or user returns 404; upstream issues return 502 and are never charged.
  • Failed calls are not billed — only successful responses settle.

Prompts to try

  • "What are people on X saying about x402 this week? Summarize sentiment and pull the top tweets."
  • "Fetch this tweet and its whole thread, then summarize the debate."