Api Endpoint

Twitter/X Trending Topics

Twitter/X trends right now — the ranked list of trending topics and hashtags on Twitter/X for any country by ISO code (US, GB, JP, worldwide) or a city by WOEID, each with post count, search query and related trends. For trend tracking, social listening and viral-topic discovery.

Open interactive test console

Offering

Provider
twitter.use.x402atlas.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://twitter.use.x402atlas.com/trends
MIME type
application/json
First seen
2026-10-16T01:50:10.647Z
Last seen
Tags
Twitter, x, Trending, trends, social-listening, hashtags, woeid, real-time

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.03 USDC
Atomic price: 30000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.03 USDC
Atomic price: 30000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3
0.03 USDC
Atomic price: 30000 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Payment option 4
0.03 USDC
Atomic price: 30000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "30000",
    "payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "30000",
    "payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "30000",
    "payTo": "3nXsChcZGke6xebDPmndNMCt8L3yi6xyN4Pd6q5cQrgv"
  }
]

Observed health

Status
Healthy
Latest latency
12 ms
Average latency
14 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "method": {
      "enum": [
        "GET"
      ],
      "type": "string"
    },
    "queryParams": {
      "properties": {
        "country": {
          "description": "ISO 3166-1 alpha-2 country code or worldwide; defaults to US when omitted",
          "enum": [
            "worldwide",
            "AE",
            "AR",
            "AT",
            "AU",
            "BE",
            "BH",
            "BR",
            "BY",
            "CA",
            "CH",
            "CL",
            "CO",
            "DE",
            "DK",
            "DO",
            "DZ",
            "EC",
            "EG",
            "ES",
            "FR",
            "GB",
            "GH",
            "GR",
            "GT",
            "ID",
            "IE",
            "IL",
            "IN",
            "IT",
            "JO",
            "JP",
            "KE",
            "KR",
            "KW",
            "LB",
            "LV",
            "MX",
            "MY",
            "NG",
            "NL",
            "NO",
            "NZ",
            "OM",
            "PA",
            "PE",
            "PH",
            "PK",
            "PL",
            "PR",
            "PT",
            "QA",
            "RU",
            "SA",
            "SE",
            "SG",
            "TH",
            "TR",
            "UA",
            "US",
            "VE",
            "VN",
            "ZA"
          ],
          "type": "string"
        },
        "woeid": {
          "description": "City scope from /locations; overrides country",
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "country"
      ],
      "type": "object"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "country": {
              "description": "ISO 3166-1 alpha-2 country code or worldwide; defaults to US when omitted",
              "enum": [
                "worldwide",
                "AE",
                "AR",
                "AT",
                "AU",
                "BE",
                "BH",
                "BR",
                "BY",
                "CA",
                "CH",
                "CL",
                "CO",
                "DE",
                "DK",
                "DO",
                "DZ",
                "EC",
                "EG",
                "ES",
                "FR",
                "GB",
                "GH",
                "GR",
                "GT",
                "ID",
                "IE",
                "IL",
                "IN",
                "IT",
                "JO",
                "JP",
                "KE",
                "KR",
                "KW",
                "LB",
                "LV",
                "MX",
                "MY",
                "NG",
                "NL",
                "NO",
                "NZ",
                "OM",
                "PA",
                "PE",
                "PH",
                "PK",
                "PL",
                "PR",
                "PT",
                "QA",
                "RU",
                "SA",
                "SE",
                "SG",
                "TH",
                "TR",
                "UA",
                "US",
                "VE",
                "VN",
                "ZA"
              ],
              "type": "string"
            },
            "woeid": {
              "description": "City scope from /locations; overrides country",
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "country"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "queried_at": {
              "format": "date-time",
              "type": "string"
            },
            "query": {
              "description": "Effective scope: country=US or woeid=2442047",
              "type": "string"
            },
            "trend_count": {
              "minimum": 0,
              "type": "integer"
            },
            "trends": {
              "items": {
                "properties": {
                  "context": {
                    "type": "string"
                  },
                  "grouped_trends": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "name": {
                    "type": "string"
                  },
                  "post_count": {
                    "minimum": 0,
                    "type": "integer"
                  },
                  "rank": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "search_query": {
                    "type": "string"
                  }
                },
                "required": [
                  "rank",
                  "name",
                  "search_query",
                  "grouped_trends"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "woeid": {
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "queried_at",
            "query",
            "woeid",
            "trend_count",
            "trends"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}