SocialFetch

Search X posts or people by query.

Resource: api.socialfetch.dev/v1/twitter/search

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043

Payment methods: — · Last validation: 2026-10-15 11:52:01.975+00

{
  "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). Requests cannot ask for more than 20 posts; the actual page size may be smaller. Use the response cursor for subsequent pages."
          },
          "query": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1,
            "description": "Search query for public posts on X. Supported post-type operators include `include:nativeretweets`, `filter:nativeretweets`, and `filter:retweets`; `is:retweet` is not supported."
          },
          "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"
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
        "amount": "14000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "14000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.