# 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."

---

## All docs pages


**Get started**

- [Introduction](https://glim.sh/docs.md?page=introduction)
- [MCP quickstart](https://glim.sh/docs.md?page=quickstart)
- [REST API quickstart](https://glim.sh/docs.md?page=quickstart-rest)
- [JavaScript quickstart](https://glim.sh/docs.md?page=quickstart-js)
- [Python quickstart](https://glim.sh/docs.md?page=quickstart-python)
- [Payments & auth](https://glim.sh/docs.md?page=payments)

**Tools**

- [Twitter / X](https://glim.sh/docs.md?page=twitter)
- [Reddit](https://glim.sh/docs.md?page=reddit)
- [Web](https://glim.sh/docs.md?page=web)
- [GitHub](https://glim.sh/docs.md?page=github)
- [Amazon](https://glim.sh/docs.md?page=amazon)
- [YouTube](https://glim.sh/docs.md?page=youtube)
- [Telegram](https://glim.sh/docs.md?page=telegram)

**Reference**

- [Changelog](https://glim.sh/docs.md?page=changelog)
- [API reference](https://glim.sh/docs-openapi)
- [OpenAPI spec](https://glim.sh/openapi.json)