{
  "x402Version": 2,
  "id": 25758,
  "slug": "25758",
  "resource": "https://twitter.use.x402atlas.com/search",
  "description": "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.",
  "type": "http",
  "serviceName": "Twitter/X API",
  "resourceType": "Identity & Enrichment",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "5000",
      "amountUsd": 0.005,
      "maxTimeoutSeconds": 300
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "5000",
      "amountUsd": 0.005,
      "maxTimeoutSeconds": 300
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "5000",
      "amountUsd": 0.005,
      "maxTimeoutSeconds": 300
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "ASt6xvRyQ7ntERsmcYVMdLqZvz1GEN8Fzexzq62tXrNQ",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "5000",
      "amountUsd": 0.005,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "properties": {
          "cursor": {
            "description": "Pagination cursor for the next page, if any",
            "type": "string"
          },
          "queried_at": {
            "description": "UTC timestamp when this service 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"
  },
  "extensions": {
    "bazaar": {
      "category": "search",
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "words": "bitcoin"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "cursor": "DAACCgACHMe1FCaAJxAKAAMcx7UU…",
            "queried_at": "2026-07-05T12:00:00Z",
            "query": "from:@PancakeSwap filter:replies",
            "tweet_count": 1,
            "tweets": [
              {
                "author": {
                  "avatar": "https://pbs.twimg.com/profile_images/2004910939959967744/wr7-zpVh_normal.jpg",
                  "description": "Everyone's favorite DEX. Swap, trade, and earn across 10+ chains.",
                  "followers": 2132825,
                  "id": "1305349277422477313",
                  "name": "PancakeSwap",
                  "screen_name": "PancakeSwap",
                  "verified": true
                },
                "bookmarks": 0,
                "conversation_id": "2071965667491000381",
                "created_at": "2026-06-30T14:34:45Z",
                "id": "2071965671001608665",
                "is_quote": false,
                "lang": "en",
                "likes": 16,
                "quotes": 0,
                "replies": 1,
                "retweets": 2,
                "text": "Stack your tokenized assets ⬇️\nhttps://t.co/peohoKiMyQ",
                "urls": [
                  "https://pancakeswap.finance/stocks"
                ],
                "views": 3534
              }
            ],
            "type": "top"
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "any_words": {
                    "description": "Any of these words",
                    "example": "btc,eth",
                    "type": "string"
                  },
                  "cursor": {
                    "description": "Pagination cursor",
                    "maxLength": 2048,
                    "type": "string"
                  },
                  "filter": {
                    "description": "Content filters: replies, links, quote, media, images, videos",
                    "example": "media,images",
                    "pattern": "^(replies|links|quote|media|images|videos)([,\\s]+(replies|links|quote|media|images|videos))*$",
                    "type": "string"
                  },
                  "from": {
                    "description": "Tweets from this username",
                    "example": "elonmusk",
                    "type": "string"
                  },
                  "hashtags": {
                    "description": "Filter by hashtags",
                    "example": "bitcoin,eth",
                    "type": "string"
                  },
                  "max_id": {
                    "description": "Tweets at or before this tweet ID",
                    "pattern": "^[0-9]+$",
                    "type": "string"
                  },
                  "mentioning": {
                    "description": "Tweets mentioning this username",
                    "type": "string"
                  },
                  "min_likes": {
                    "description": "Minimum like count",
                    "type": "integer"
                  },
                  "min_replies": {
                    "description": "Minimum reply count",
                    "type": "integer"
                  },
                  "min_retweets": {
                    "description": "Minimum retweet count",
                    "type": "integer"
                  },
                  "near": {
                    "description": "Tweets near this location",
                    "type": "string"
                  },
                  "none_words": {
                    "description": "Exclude these words",
                    "example": "airdrop,giveaway",
                    "type": "string"
                  },
                  "phrase": {
                    "description": "Exact phrase match",
                    "type": "string"
                  },
                  "q": {
                    "description": "Short alias of search_query",
                    "maxLength": 512,
                    "type": "string"
                  },
                  "query": {
                    "description": "Alias of search_query",
                    "maxLength": 512,
                    "type": "string"
                  },
                  "search_query": {
                    "description": "Raw X advanced search query",
                    "maxLength": 512,
                    "type": "string"
                  },
                  "since": {
                    "description": "Start date (YYYY-MM-DD)",
                    "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
                    "type": "string"
                  },
                  "since_id": {
                    "description": "Tweets after this tweet ID",
                    "pattern": "^[0-9]+$",
                    "type": "string"
                  },
                  "to": {
                    "description": "Tweets replying to this username",
                    "type": "string"
                  },
                  "type": {
                    "default": "top",
                    "description": "Result mode: top, latest or media",
                    "enum": [
                      "top",
                      "latest",
                      "media"
                    ],
                    "type": "string"
                  },
                  "until": {
                    "description": "End date (YYYY-MM-DD)",
                    "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
                    "type": "string"
                  },
                  "within_time": {
                    "description": "Recent time window: digits plus s, m, h or d",
                    "pattern": "^[0-9]+[smhd]$",
                    "type": "string"
                  },
                  "words": {
                    "description": "All these words must appear",
                    "example": "bitcoin",
                    "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 service 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"
      },
      "tags": [
        "twitter",
        "x",
        "tweet-search",
        "twitter-scraper",
        "social-media",
        "advanced-search",
        "tweets",
        "social-listening",
        "twitter-api",
        "x-search"
      ]
    }
  },
  "tags": [
    "twitter",
    "x",
    "tweet-search",
    "twitter-scraper",
    "social-media",
    "bazaar"
  ],
  "sourceHost": "twitter.use.x402atlas.com",
  "lastUpdated": "2026-10-14T00:22:39.241Z",
  "quality": {
    "calls30d": 892,
    "uniquePayers30d": 28,
    "lastCalledAt": "2026-10-14T00:22:39.081Z"
  },
  "metadata": {
    "serviceName": "Twitter/X API",
    "extensions": {
      "bazaar": {
        "category": "search",
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "words": "bitcoin"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "cursor": "DAACCgACHMe1FCaAJxAKAAMcx7UU…",
              "queried_at": "2026-07-05T12:00:00Z",
              "query": "from:@PancakeSwap filter:replies",
              "tweet_count": 1,
              "tweets": [
                {
                  "author": {
                    "avatar": "https://pbs.twimg.com/profile_images/2004910939959967744/wr7-zpVh_normal.jpg",
                    "description": "Everyone's favorite DEX. Swap, trade, and earn across 10+ chains.",
                    "followers": 2132825,
                    "id": "1305349277422477313",
                    "name": "PancakeSwap",
                    "screen_name": "PancakeSwap",
                    "verified": true
                  },
                  "bookmarks": 0,
                  "conversation_id": "2071965667491000381",
                  "created_at": "2026-06-30T14:34:45Z",
                  "id": "2071965671001608665",
                  "is_quote": false,
                  "lang": "en",
                  "likes": 16,
                  "quotes": 0,
                  "replies": 1,
                  "retweets": 2,
                  "text": "Stack your tokenized assets ⬇️\nhttps://t.co/peohoKiMyQ",
                  "urls": [
                    "https://pancakeswap.finance/stocks"
                  ],
                  "views": 3534
                }
              ],
              "type": "top"
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "properties": {
                    "any_words": {
                      "description": "Any of these words",
                      "example": "btc,eth",
                      "type": "string"
                    },
                    "cursor": {
                      "description": "Pagination cursor",
                      "maxLength": 2048,
                      "type": "string"
                    },
                    "filter": {
                      "description": "Content filters: replies, links, quote, media, images, videos",
                      "example": "media,images",
                      "pattern": "^(replies|links|quote|media|images|videos)([,\\s]+(replies|links|quote|media|images|videos))*$",
                      "type": "string"
                    },
                    "from": {
                      "description": "Tweets from this username",
                      "example": "elonmusk",
                      "type": "string"
                    },
                    "hashtags": {
                      "description": "Filter by hashtags",
                      "example": "bitcoin,eth",
                      "type": "string"
                    },
                    "max_id": {
                      "description": "Tweets at or before this tweet ID",
                      "pattern": "^[0-9]+$",
                      "type": "string"
                    },
                    "mentioning": {
                      "description": "Tweets mentioning this username",
                      "type": "string"
                    },
                    "min_likes": {
                      "description": "Minimum like count",
                      "type": "integer"
                    },
                    "min_replies": {
                      "description": "Minimum reply count",
                      "type": "integer"
                    },
                    "min_retweets": {
                      "description": "Minimum retweet count",
                      "type": "integer"
                    },
                    "near": {
                      "description": "Tweets near this location",
                      "type": "string"
                    },
                    "none_words": {
                      "description": "Exclude these words",
                      "example": "airdrop,giveaway",
                      "type": "string"
                    },
                    "phrase": {
                      "description": "Exact phrase match",
                      "type": "string"
                    },
                    "q": {
                      "description": "Short alias of search_query",
                      "maxLength": 512,
                      "type": "string"
                    },
                    "query": {
                      "description": "Alias of search_query",
                      "maxLength": 512,
                      "type": "string"
                    },
                    "search_query": {
                      "description": "Raw X advanced search query",
                      "maxLength": 512,
                      "type": "string"
                    },
                    "since": {
                      "description": "Start date (YYYY-MM-DD)",
                      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
                      "type": "string"
                    },
                    "since_id": {
                      "description": "Tweets after this tweet ID",
                      "pattern": "^[0-9]+$",
                      "type": "string"
                    },
                    "to": {
                      "description": "Tweets replying to this username",
                      "type": "string"
                    },
                    "type": {
                      "default": "top",
                      "description": "Result mode: top, latest or media",
                      "enum": [
                        "top",
                        "latest",
                        "media"
                      ],
                      "type": "string"
                    },
                    "until": {
                      "description": "End date (YYYY-MM-DD)",
                      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
                      "type": "string"
                    },
                    "within_time": {
                      "description": "Recent time window: digits plus s, m, h or d",
                      "pattern": "^[0-9]+[smhd]$",
                      "type": "string"
                    },
                    "words": {
                      "description": "All these words must appear",
                      "example": "bitcoin",
                      "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 service 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"
        },
        "tags": [
          "twitter",
          "x",
          "tweet-search",
          "twitter-scraper",
          "social-media",
          "advanced-search",
          "tweets",
          "social-listening",
          "twitter-api",
          "x-search"
        ]
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "twitter.use.x402atlas.com",
    "manifest_name": "twitter.use.x402atlas.com",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {
      "cursor": "string",
      "queried_at": "2026-01-01T00:00:00Z",
      "query": "string",
      "tweet_count": 0,
      "tweets": [
        {
          "author": {
            "avatar": "string",
            "description": "string",
            "followers": 0,
            "id": "string",
            "name": "string",
            "screen_name": "string",
            "verified": true
          },
          "bookmarks": 0,
          "conversation_id": "string",
          "created_at": "2026-01-01T00:00:00Z",
          "id": "string",
          "in_reply_to_id": "string",
          "in_reply_to_user": "string",
          "is_quote": true,
          "lang": "string",
          "likes": 0,
          "quotes": 0,
          "replies": 0,
          "retweets": 0,
          "text": "string",
          "urls": [
            "string"
          ],
          "views": 0
        }
      ],
      "type": "top"
    },
    "type": "string"
  }
}