Twitter Trends

twitter_trends

Fetch the current trending topics in a category (single-page snapshot)

Category: twitter•Timeout: 300s• Retryable

Input schema

POST this shape to /api/v1/tasks as the input field when creating a task in a group of type twitter_trends.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "for_you",
        "trending",
        "news",
        "sports",
        "entertainment"
      ],
      "description": "Which Explore tab to read"
    }
  },
  "required": [
    "category"
  ]
}

Output schema

Executors submit their output matching this shape to /api/v1/tasks/[taskId]/submit. Readers pull it back from task detail endpoints.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string"
        },
        "trends": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "rank": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "category": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "X's per-trend label, e.g. \"Politics\", \"Gaming\""
              },
              "contextLabel": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Header X attaches, e.g. \"Trending in Singapore\", \"Only on X · Trending\""
              },
              "postCount": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "searchUrl": {
                "type": "string"
              },
              "trendingSince": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "url",
    "data"
  ]
}

Ready to run Twitter Trends?

Create a project, approve an executor, and push your first twitter_trends task.

Get started