Roundhouse

SocialFetch

Search X posts or people by query.

SearchLiveeip155:8453Exactvia cdp
https://api.socialfetch.dev/v1/twitter/search
TwitterSocial-data
Calls · 30d
22↑ 6.8%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far.
$20.34
Verified settled volume
1,259 settlements proven x402 by their on-chain EIP-3009 marker.
$0.014
Listed price
As published in the catalog. Always read the live 402 before paying.
22
Calls · 30d
Upstream's own call count for this endpoint, not ours.
3
Unique payers · 30d
Last called 2026-09-22 15:01Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043

The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.

Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Provider

The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "error": {
    "code": "payment_required",
    "message": "Missing API key. Include a valid x-api-key header to bill credits. See https://www.socialfetch.dev/docs/quickstart.",
    "requestId": "req_abb700db-cfb1-478c-9155-b159d4fb0d44"
  }
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

0.014USDC≈ $0.014 USD
on Base · exact scheme

Pay 0.014 USDC on Base to 0x02C2…83043. The signed payment is good for 5 minutes.

Paid to
0x02C2…83043
USD Coin contract
0x8335…02913
Payment window
5 minutes
As published
14000 smallest units
The catalog’s raw entry
[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
    "amount": "14000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "query": "what to watch this weekend"
        }
      },
      "output": {
        "type": "json",
        "example": {
          "data": {
            "page": {
              "hasMore": true,
              "nextCursor": "eyJ2IjoxLCJjIjoiREFBRERBQUJDZ0FCSFI0ZDNfLVhzYVVLQUFJZEhoeXlSWm9BaGdBSUFBSUFBQUFDQ0FBREFBQUFBQWdBQkFBQUFBQUtBQVVkSGgzbU9…"
            },
            "people": [],
            "tweets": [
              {
                "id": "2098147324304273829",
                "url": "https://x.com/azraphbelzie/status/2098147324304273829",
                "text": "@Necro_Ch_ NASA did nothing wrong !",
                "author": {
                  "handle": null,
                  "verified": null,
                  "avatarUrl": null,
                  "profileUrl": null,
                  "displayName": null,
                  "blueVerified": null,
                  "platformUserId": null
                },
                "language": "en",
                "createdAt": "2026-09-10T20:31:18.000Z",
                "_truncated": true,
                "createdAtUnix": 1789072278,
                "conversationId": "2098097636234440883",
                "createdAtLabel": null,
                "quotedStatusId": null,
                "retweetTweetId": null,
                "inReplyToStatusId": "2098097636234440883"
              }
            ]
          },
          "meta": {
            "version": "v1",
            "requestId": "req_example_twitter_search",
            "creditsCharged": 1
          }
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method"
          ],
          "properties": {
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "type": "object",
              "required": [
                "query"
              ],
              "properties": {
                "limit": {
                  "type": "integer",
                  "maximum": 20,
                  "minimum": 1,
                  "description": "Optional page size (1–20). Best-effort; the actual page size may differ."
                },
                "query": {
                  "type": "string",
                  "maxLength": 512,
                  "minLength": 1,
                  "description": "Search query for public posts on X."
                },
                "cursor": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Opaque pagination cursor returned by a previous response."
                },
                "endDate": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "description": "Optional end date filter in YYYY-MM-DD format."
                },
                "section": {
                  "enum": [
                    "top",
                    "latest",
                    "people",
                    "photos",
                    "videos"
                  ],
                  "type": "string",
                  "default": "top",
                  "description": "Search section: `top` (default), `latest`, `people`, `photos`, or `videos`."
                },
                "language": {
                  "enum": [
                    "en",
                    "es",
                    "fr",
                    "de",
                    "it",
                    "pt",
                    "ru",
                    "zh",
                    "ja",
                    "ko",
                    "ar",
                    "bg",
                    "hr",
                    "cs",
                    "da",
                    "nl",
                    "et",
                    "fi",
                    "el",
                    "hu",
                    "id",
                    "ga",
                    "lv",
                    "lt",
                    "no",
                    "pl",
                    "ro",
                    "sk",
                    "sl",
                    "sv",
                    "tr",
                    "uk",
                    "vi",
                    "cy",
                    "zu"
                  ],
                  "type": "string",
                  "description": "Optional language filter."
                },
                "minLikes": {
                  "type": "integer",
                  "maximum": 9007199254740991,
                  "minimum": 0,
                  "description": "Optional minimum like count filter."
                },
                "startDate": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "description": "Optional start date filter in YYYY-MM-DD format."
                },
                "minReplies": {
                  "type": "integer",
                  "maximum": 9007199254740991,
                  "minimum": 0,
                  "description": "Optional minimum reply count filter."
                },
                "minRetweets": {
                  "type": "integer",
                  "maximum": 9007199254740991,
                  "minimum": 0,
                  "description": "Optional minimum retweet count filter."
                }
              }
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    }
  },
  "payment-identifier": {
    "info": {
      "required": false
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "required"
      ],
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9_-]+$",
          "maxLength": 128,
          "minLength": 16
        },
        "required": {
          "type": "boolean"
        }
      }
    }
  }
}

Provenance

Seen in the source catalog
2026-09-22 15:01Z
Last indexed by Roundhouse
2026-09-24 10:00Z
Last enriched (probe, favicon, geo)
2026-09-10 08:45Z
x402 version
2
Max timeout
300s
Liveness probe
HTTP 402
Report

Hand this page to an agent

Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.

GET api.roundhouseai.io/v0/endpoints

This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.

Open skill.md
Show the prompt
Using Roundhouse, look up the x402 service SocialFetch and tell me whether it is
worth paying: what a call costs, whether the endpoint answered when last probed, and what
its payment record actually shows.

curl -s 'https://api.roundhouseai.io/v0/endpoints?q=SocialFetch'
curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>'

Then call it: read the price from the live 402 at https://api.socialfetch.dev/v1/twitter/search, never from
a cached figure, and pay with an x402 client.

The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except
/v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402,
or use an organization key from https://roundhouseai.io/dashboard/team.

If you do not have Roundhouse tools or skills installed, read
https://roundhouseai.io/skill.md first — it is the whole procedure.