Catalog
SocialGETlive

X tweet search

Search public X/Twitter tweets with keyword, account, hashtag, and date filters.

$0.005
per call
Success
100%
p50 latency
2.57s
p95 latency
2.88s
Calls (30d)
5

Provider contract

Call path
/routes/
glim-shdefault
/social/x-tweet-search
Method
GET
Selected provider
glim-shdefault
Provider price
$0.005
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl '/routes/glim-sh/social/x-tweet-search?query=x402+from%3Abase'
CLI
h402 call 'social/x-tweet-search' --provider 'glim-sh' --method GET --query '{"query":"x402 from:base"}'

Parameters & live test

pays real USDC
glim-shdefault$0.0050/call

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

querystringrequired

Provider-native X search query expression.

start_datestringoptional

Earliest tweet date, YYYY-MM-DD.

end_datestringoptional

Latest tweet date, YYYY-MM-DD.

cursorstringoptional

Provider-native pagination cursor.

GET/routes/glim-sh/social/x-tweet-search
Request query
{
  "query": "x402 from:base"
}

ResponseExample response
{
  "data": {
    "tweets": [
      {
        "id": "2049516182173061588",
        "url": "https://x.com/base/status/2049516182173061588",
        "text": "x402.",
        "created_at": "2026-04-29T15:48:30.000Z",
        "lang": "qst",
        "source": "Twitter for iPhone",
        "conversation_id": "2049516182173061588",
        "is_reply": false,
        "is_thread_start": true,
        "content_type": "original",
        "time_ago": "11w ago",
        "author": {
          "id": "1628067904083181570",
          "username": "base",
          "name": "Base",
          "location": "Onchain",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2060695832840556549/R0s33fMN_normal.jpg",
          "verified_type": "Business",
          "public_metrics": {
            "followers_count": 1407692,
            "following_count": 873,
            "tweet_count": 7937,
            "like_count": 6898,
            "media_count": 1945
          },
          "created_at": "2023-02-21T16:26:04.000Z"
        },
        "public_metrics": {
          "like_count": 857,
          "retweet_count": 82,
          "reply_count": 124,
          "quote_count": 39,
          "impression_count": 61265,
          "bookmark_count": 23
        },
        "referenced_tweets": [
          {
            "type": "quoted",
            "id": "2049494681789112713"
          }
        ],
        "engagement_rate": 0.0174,
        "quoted_tweet": {
          "id": "2049494681789112713",
          "url": "https://x.com/coinbase/status/2049494681789112713",
          "text": "x402. https://t.co/Tv5D7Jvuc5",
          "created_at": "2026-04-29T14:23:04.000Z",
          "lang": "und",
          "source": "Twitter for iPhone",
          "conversation_id": "2049494681789112713",
          "is_reply": false,
          "is_thread_start": true,
          "content_type": "media",
          "time_ago": "12w ago",
          "author": {
            "id": "574032254",
            "username": "coinbase",
            "name": "Coinbase 🛡️",
            "location": "Remote First",
            "profile_image_url": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png",
            "verified": true,
            "verified_type": "Business",
            "public_metrics": {
              "followers_count": 7054754,
              "following_count": 174,
              "tweet_count": 10096,
              "like_count": 5776,
              "media_count": 1866
            },
            "created_at": "2012-05-07T23:06:31.000Z"
          },
          "public_metrics": {
            "like_count": 687,
            "retweet_count": 97,
            "reply_count": 132,
            "quote_count": 37,
            "impression_count": 100496,
            "bookmark_count": 23
          },
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HHFEgsIaYAACnXE.jpg"
            }
          ],
          "engagement_rate": 0.0091
        }
      },
      {
        "id": "2060476097628926405",
        "url": "https://x.com/base/status/2060476097628926405",
        "text": "http://x.com/i/article/2060473610960330752",
        "created_at": "2026-05-29T21:39:18.000Z",
        "lang": "zxx",
        "source": "Twitter for iPhone",
        "conversation_id": "2060476097628926405",
        "is_reply": false,
        "is_thread_start": true,
        "content_type": "link_share",
        "time_ago": "7w ago",
        "author": {
          "id": "1628067904083181570",
          "username": "base",
          "name": "Base",
          "location": "Onchain",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2060695832840556549/R0s33fMN_normal.jpg",
          "verified_type": "Business",
          "public_metrics": {
            "followers_count": 1407692,
            "following_count": 873,
            "tweet_count": 7937,
            "like_count": 6898,
            "media_count": 1945
          },
          "created_at": "2023-02-21T16:26:04.000Z"
        },
        "public_metrics": {
          "like_count": 453,
          "retweet_count": 81,
          "reply_count": 73,
          "quote_count": 38,
          "impression_count": 73543,
          "bookmark_count": 24
        },
        "entities": {
          "urls": [
            {
              "url": "https://t.co/mdH6z88X04",
              "expanded_url": "http://x.com/i/article/2060473610960330752",
              "display_url": "x.com/i/article/2060…"
            }
          ]
        },
        "engagement_rate": 0.0083
      },
      {
        "id": "2054674245297586362",
        "url": "https://x.com/base/status/2054674245297586362",
        "text": "Over $50M has now been spent on services by agents using x402\n\nMore than 85% of it happened on Base https://t.co/AHHUEqptWb",
        "created_at": "2026-05-13T21:24:48.000Z",
        "lang": "en",
        "source": "Twitter for iPhone",
        "conversation_id": "2054674245297586362",
        "is_reply": false,
        "is_thread_start": true,
        "content_type": "media",
        "time_ago": "9w ago",
        "author": {
          "id": "1628067904083181570",
          "username": "base",
          "name": "Base",
          "location": "Onchain",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2060695832840556549/R0s33fMN_normal.jpg",
          "verified_type": "Business",
          "public_metrics": {
            "followers_count": 1407692,
            "following_count": 873,
            "tweet_count": 7937,
            "like_count": 6898,
            "media_count": 1945
          },
          "created_at": "2023-02-21T16:26:04.000Z"
        },
        "public_metrics": {
          "like_count": 706,
          "retweet_count": 116,
          "reply_count": 129,
          "quote_count": 40,
          "impression_count": 170118,
          "bookmark_count": 36
        },
        "media": [
          {
            "type": "photo",
            "url": "https://pbs.twimg.com/media/HIOrQKpaUAAzpYw.png"
          }
        ],
        "engagement_rate": 0.0056
      }
    ],
    "count": 19,
    "summary": {
      "total_likes": 19394,
      "total_retweets": 3807,
      "total_replies": 2969,
      "total_impressions": 2365171,
      "avg_likes": 1021,
      "avg_engagement_rate": 0.0129,
      "max_likes": 3113,
      "top_tweet_id": "2002407033514168819",
      "earliest_tweet_at": "2025-12-20T15:53:34.000Z",
      "latest_tweet_at": "2026-07-10T21:24:09.000Z",
      "time_span_hours": 4853.5
    },
    "topics": {
      "top_hashtags": [],
      "top_domains": [],
      "top_mentioned_users": [
        {
          "username": "baseapp",
          "count": 5
        },
        {
          "username": "avantisfi",
          "count": 2
        },
        {
          "username": "travalacom",
          "count": 1
        }
      ]
    },
    "has_more": true
  },
  "h402": {
    "routeId": "social/x-tweet-search",
    "provider": "glim-sh",
    "selectedCandidateId": "social/x-tweet-search/glim-sh",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

glim-shdefaultcheapest
x402mpp
100
Success
100%
p50
2.81s
Calls
2
100%
$0.005$0.0050/call
twit-sh
x402
100
Success
100%
p50
2.44s
Calls
3
100%
$0.006$0.0060/call
Last successful call: 6d ago· Aggregated by h402 — not the source provider