Reddit Post Lookup

reddit_post_lookup

Fetch Reddit posts by id, each exactly as Reddit's post JSON has it

Category: reddit•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 reddit_post_lookup.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "uniqueItems": true,
      "description": "Post fullnames (\"t3_…\"), up to 100",
      "items": {
        "type": "string",
        "pattern": "^t3_[a-z0-9]+$"
      }
    }
  },
  "required": [
    "ids"
  ]
}

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": {
    "posts": {
      "type": "array",
      "description": "One entry per id, in the order asked for",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "t3_<id>"
          },
          "status": {
            "type": "string",
            "enum": [
              "found",
              "not_found",
              "forbidden"
            ],
            "description": "found; not_found (Reddit has no such post); forbidden (its community is private, banned, quarantined, …)"
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reddit's reason for forbidden (private, quarantined, …); null otherwise"
          },
          "post": {
            "type": [
              "object",
              "null"
            ],
            "description": "Reddit's own post object (the `data` of a t3, as `raw_json=1` returns it); null unless found"
          }
        },
        "required": [
          "id",
          "status",
          "reason",
          "post"
        ]
      }
    }
  },
  "required": [
    "posts"
  ]
}

Ready to run Reddit Post Lookup?

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

Get started