FETCH402
← Protocol index

Resource / 407

healthy

Unnamed resource.

GET https://x402.twit.sh/users/search ↗

Search Twitter/X for user accounts matching a keyword or phrase. Returns up to 20 matching user profiles per page with pagination support. Useful for discovering users by topic, name, or keyword. Query params: query (string, required) - search keyword or phrase; next_token (string, optional) - pagination cursor from previous response, e.g. GET /users/search?query=bitcoin. Returns X v2 API-compatible JSON.

Eligibility
probeable
Failures
0
Last quote
2026-08-13 00:15:02 UTC
Last probe
2026-08-13 00:15:02 UTC
Payment requirements / accepts[] 1 options
State Network Scheme Atomic amount Asset payTo / untrusted
active eip155:8453 exact 10000 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8

All advertised payment options are stored. Base (`eip155:8453`) is the operational network for ranking and canaries; non-Base options remain visible for transparency.

Probe evidence 1 recent
healthy 2026-08-13 00:15:02 UTC GET · HTTP 402 · 99ms · accepts 1 · base 1 ok
Request
GET https://x402.twit.sh/users/search
Robots
error
Note
robots_error:{:robots_http_status, 404};http_402;accepts=1;base=1
Accepts fingerprint
7a7cbe75932cdf333c20a5b49f727ab8f7847450910a37e27a3d4e709e113c02

Accepts snapshot

[
  {
    "amount": "10000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "assetTransferMethod": null,
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "maxTimeoutSeconds": 300,
    "network": "eip155:8453",
    "payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
    "paymentFlow": null,
    "raw": {
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "maxTimeoutSeconds": 300,
      "max_timeout_seconds": 300,
      "network": "eip155:8453",
      "payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
      "pay_to": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
      "scheme": "exact"
    },
    "scheme": "exact"
  }
]

PaymentRequired raw 

{
  "accepts": [
    {
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "maxTimeoutSeconds": 300,
      "network": "eip155:8453",
      "payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
      "scheme": "exact"
    }
  ],
  "error": "Payment required",
  "extensions": {
    "bazaar": {
      "category": "api",
      "discoverable": true,
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "query": "bitcoin"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "data": [
              {
                "description": "Running bitcoin.",
                "id": "9253672",
                "name": "Hal Finney",
                "public_metrics": {
                  "followers_count": 134000,
                  "following_count": 200,
                  "like_count": 300,
                  "tweet_count": 600
                },
                "username": "halfin",
                "verified": false
              }
            ],
            "meta": {
              "next_token": "abc123"
            }
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "next_token": {
                    "description": "Pagination cursor from previous response",
                    "type": "string"
                  },
                  "query": {
                    "description": "Search keyword or phrase",
                    "type": "string"
                  }
                },
                "required": [
                  "query"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      },
      "tags": [
        "twitter",
        "x",
        "social",
        "user",
        "search",
        "discovery",
        "keyword",
        "paginated",
        "agent",
        "x402"
      ]
    },
    "builder-code": {
      "info": {
        "a": "bc_qobj93ib"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "a": {
            "description": "App builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "s": {
            "description": "Service builder codes",
            "items": {
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "type": "array"
          },
          "w": {
            "description": "Wallet builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          }
        },
        "type": "object"
      }
    }
  },
  "resource": {
    "description": "Search Twitter/X for user accounts matching a keyword or phrase. Returns up to 20 matching user profiles per page with pagination support. Useful for discovering users by topic, name, or keyword. Query params: query (string, required) - search keyword or phrase; next_token (string, optional) - pagination cursor from previous response, e.g. GET /users/search?query=bitcoin. Returns X v2 API-compatible JSON.",
    "mimeType": "application/json",
    "url": "https://x402.twit.sh/users/search"
  },
  "x402Version": 2
}

Response headers

{
  "access-control-allow-origin": "*",
  "access-control-expose-headers": "PAYMENT-REQUIRED,PAYMENT-RESPONSE,X-PAYMENT-RESPONSE",
  "connection": "keep-alive",
  "content-length": "2",
  "content-type": "application/json; charset=utf-8",
  "date": "Thu, 13 Aug 2026 00:15:02 GMT",
  "etag": "W/\"2-vyGp6PvFo4RvsFtPoIWeCReyIC8\"",
  "payment-required": "eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly94NDAyLnR3aXQuc2gvdXNlcnMvc2VhcmNoIiwiZGVzY3JpcHRpb24iOiJTZWFyY2ggVHdpdHRlci9YIGZvciB1c2VyIGFjY291bnRzIG1hdGNoaW5nIGEga2V5d29yZCBvciBwaHJhc2UuIFJldHVybnMgdXAgdG8gMjAgbWF0Y2hpbmcgdXNlciBwcm9maWxlcyBwZXIgcGFnZSB3aXRoIHBhZ2luYXRpb24gc3VwcG9ydC4gVXNlZnVsIGZvciBkaXNjb3ZlcmluZyB1c2VycyBieSB0b3BpYywgbmFtZSwgb3Iga2V5d29yZC4gUXVlcnkgcGFyYW1zOiBxdWVyeSAoc3RyaW5nLCByZXF1aXJlZCkgLSBzZWFyY2gga2V5d29yZCBvciBwaHJhc2U7IG5leHRfdG9rZW4gKHN0cmluZywgb3B0aW9uYWwpIC0gcGFnaW5hdGlvbiBjdXJzb3IgZnJvbSBwcmV2aW91cyByZXNwb25zZSwgZS5nLiBHRVQgL3VzZXJzL3NlYXJjaD9xdWVyeT1iaXRjb2luLiBSZXR1cm5zIFggdjIgQVBJLWNvbXBhdGlibGUgSlNPTi4iLCJtaW1lVHlwZSI6ImFwcGxpY2F0aW9uL2pzb24ifSwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJhbW91bnQiOiIxMDAwMCIsImFzc2V0IjoiMHg4MzM1ODlmQ0Q2ZURiNkUwOGY0YzdDMzJENGY3MWI1NGJkQTAyOTEzIiwicGF5VG8iOiIweDlkQkE0MTQ2MzdjNjExYTE2QkVhNmYwNzk2QkZjYmNCZGM0MTBkZjgiLCJtYXhUaW1lb3V0U2Vjb25kcyI6MzAwLCJleHRyYSI6eyJuYW1lIjoiVVNEIENvaW4iLCJ2ZXJzaW9uIjoiMiJ9fV0sImV4dGVuc2lvbnMiOnsiYmF6YWFyIjp7ImRpc2NvdmVyYWJsZSI6dHJ1ZSwiY2F0ZWdvcnkiOiJhcGkiLCJ0YWdzIjpbInR3aXR0ZXIiLCJ4Iiwic29jaWFsIiwidXNlciIsInNlYXJjaCIsImRpc2NvdmVyeSIsImtleXdvcmQiLCJwYWdpbmF0ZWQiLCJhZ2VudCIsIng0MDIiXSwiaW5mbyI6eyJpbnB1dCI6eyJ0eXBlIjoiaHR0cCIsInF1ZXJ5UGFyYW1zIjp7InF1ZXJ5IjoiYml0Y29pbiJ9LCJtZXRob2QiOiJHRVQifSwib3V0cHV0Ijp7InR5cGUiOiJqc29uIiwiZXhhbXBsZSI6eyJkYXRhIjpbeyJpZCI6IjkyNTM2NzIiLCJuYW1lIjoiSGFsIEZpbm5leSIsInVzZXJuYW1lIjoiaGFsZmluIiwiZGVzY3JpcHRpb24iOiJSdW5uaW5nIGJpdGNvaW4uIiwidmVyaWZpZWQiOmZhbHNlLCJwdWJsaWNfbWV0cmljcyI6eyJmb2xsb3dlcnNfY291bnQiOjEzNDAwMCwiZm9sbG93aW5nX2NvdW50IjoyMDAsInR3ZWV0X2NvdW50Ijo2MDAsImxpa2VfY291bnQiOjMwMH19XSwibWV0YSI6eyJuZXh0X3Rva2VuIjoiYWJjMTIzIn19fX0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpbnB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmciLCJjb25zdCI6Imh0dHAifSwibWV0aG9kIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIkdFVCJdfSwicXVlcnlQYXJhbXMiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsicXVlcnkiOnsidHlwZSI6InN0cmluZyIsImRlc2NyaXB0aW9uIjoiU2VhcmNoIGtleXdvcmQgb3IgcGhyYXNlIn0sIm5leHRfdG9rZW4iOnsidHlwZSI6InN0cmluZyIsImRlc2NyaXB0aW9uIjoiUGFnaW5hdGlvbiBjdXJzb3IgZnJvbSBwcmV2aW91cyByZXNwb25zZSJ9fSwicmVxdWlyZWQiOlsicXVlcnkiXX19LCJyZXF1aXJlZCI6WyJ0eXBlIiwibWV0aG9kIl0sImFkZGl0aW9uYWxQcm9wZXJ0aWVzIjpmYWxzZX0sIm91dHB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmcifSwiZXhhbXBsZSI6eyJ0eXBlIjoib2JqZWN0In19LCJyZXF1aXJlZCI6WyJ0eXBlIl19fSwicmVxdWlyZWQiOlsiaW5wdXQiXX19LCJidWlsZGVyLWNvZGUiOnsiaW5mbyI6eyJhIjoiYmNfcW9iajkzaWIifSwic2NoZW1hIjp7IiRzY2hlbWEiOiJodHRwczovL2pzb24tc2NoZW1hLm9yZy9kcmFmdC8yMDIwLTEyL3NjaGVtYSIsInR5cGUiOiJvYmplY3QiLCJwcm9wZXJ0aWVzIjp7ImEiOnsidHlwZSI6InN0cmluZyIsInBhdHRlcm4iOiJeW2EtejAtOV9dezEsMzJ9JCIsImRlc2NyaXB0aW9uIjoiQXBwIGJ1aWxkZXIgY29kZSJ9LCJ3Ijp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXlthLXowLTlfXXsxLDMyfSQiLCJkZXNjcmlwdGlvbiI6IldhbGxldCBidWlsZGVyIGNvZGUifSwicyI6eyJ0eXBlIjoiYXJyYXkiLCJpdGVtcyI6eyJ0eXBlIjoic3RyaW5nIiwicGF0dGVybiI6Il5bYS16MC05X117MSwzMn0kIn0sImRlc2NyaXB0aW9uIjoiU2VydmljZSBidWlsZGVyIGNvZGVzIn19LCJhZGRpdGlvbmFsUHJvcGVydGllcyI6ZmFsc2V9fX19",
  "server": "railway-hikari",
  "x-hikari-trace": "iad1.fp5t",
  "x-powered-by": "Express",
  "x-railway-edge": "iad1",
  "x-railway-request-id": "iRVA7FeERXCQhYYN55So4g"
}

Response body 

{}

Request headers

{
  "accept": "*/*",
  "user-agent": "Fetch402Bot/0.1 (+https://fetch402.com/crawler; contact: crawler@fetch402.com)"
}

Machine contract

Schemas.

InputJSON
{}
OutputJSON
{}