ToolAssay

Search Twitter/X with structured filters or raw advanced-search syntax

Search Twitter/X with structured filters or raw advanced-search syntax. Returns up to 20 normalized tweets with full text, author details, engagement metrics and a pagination cursor.

Answeringour last check, 2026-09-24
1 of 1checks answered this week
757 msmedian answer time
$0.006listed price per call
$0.006price it asked us

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://twitter.use.x402atlas.com/search

CategorySearch and research
Provider hosttwitter.use.x402atlas.com
Networkseip155:137, eip155:42161, eip155:8453
Payment schemesexact
Self-reported calls, 30 days359 from 16 payers (the provider's figure, not ours)

Our checks, last 30 days

DayResultHTTPAskedTime
2026-09-24 valid payment request 402$0.006 757 ms

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "words": "bitcoin"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "words": {
              "description": "Tweets containing all these words",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "cursor": {
              "description": "Pagination cursor for the next page, if any",
              "type": "string"
            },
            "queried_at": {
              "description": "UTC timestamp when this bridge ran the search",
              "format": "date-time",
              "type": "string"
            },
            "query": {
              "description": "The assembled X advanced-search query string sent upstream",
              "type": "string"
            },
            "tweet_count": {
              "description": "Number of tweets in this page",
              "type": "integer"
            },
            "tweets": {
              "items": {
                "properties": {
                  "author": {
                    "properties": {
                      "avatar": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "followers": {
                        "type": "integer"
                      },
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "screen_name": {
                        "type": "string"
                      },
                      "verified": {
                        "description": "Blue-check verification status",
                        "type": "boolean"
                      }
                    },
                    "type": "object"
                  },
                  "bookmarks": {
                    "type": "integer"
                  },
                  "conversation_id": {
                    "type": "string"
                  },
                  "created_at": {
                    "format": "date-time",
                    "type": "string"
                  },
                  "id": {
                    "description": "Tweet ID",
                    "type": "string"
                  },
                  "in_reply_to_id": {
                    "description": "Parent tweet ID, if this is a reply",
                    "type": "string"
                  },
                  "in_reply_to_user": {
                    "description": "Parent tweet's author screen name, if this is a reply",
                    "type": "string"
                  },
                  "is_quote": {
                    "type": "boolean"
                  },
                  "lang": {
                    "description": "BCP-47 language code",
                    "type": "string"
                  },
                  "likes": {
                    "type": "integer"
                  },
                  "quotes": {
                    "type": "integer"
                  },
                  "replies": {
                    "type": "integer"
                  },
                  "retweets": {
                    "type": "integer"
                  },
                  "text": {
                    "type": "string"
                  },
                  "urls": {
                    "description": "Expanded URLs linked in the tweet",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "views": {
                    "type": "integer"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "type": {
              "description": "Result ranking used for this page",
              "enum": [
                "top",
                "latest",
                "media"
              ],
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON