Api Endpoint

ApiToll Reddit Subreddit Feed

Scrape subreddit posts — the latest Reddit posts from any subreddit (r/<name>), sorted hot, new, top, rising, or controversial with an optional time window. Each post comes with title, author, score, comment count, permalink, external link + domain, flair, NSFW flag, and timestamp. No login, no Reddit API key. A subreddit scraper for AI agents: monitor communities, track trending posts, and feed social signals into your pipeline.

Open interactive test console

Offering

Provider
reddit.apitoll.cloud
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Other
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://reddit.apitoll.cloud/v1/reddit/subreddit
MIME type
application/json
First seen
2026-10-25T21:27:26.481Z
Last seen
Tags
Reddit, reddit-scraper, subreddit, social-media, posts, social-data, community, apitoll

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: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0x667cc5A90ffA911279a5FBE377c1018DDF45373B"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "30000",
    "payTo": "8ce9pCUe913hpaP4oheeMPJt2uRkWAq5FsuNU6zSvTkw"
  }
]

Observed health

Status
Healthy
Latest latency
299 ms
Average latency
853 ms
HTTP status
402
Last checked
Reachability
100% over 6 checks

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

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "subreddit": {
          "type": "string",
          "description": "Subreddit name (with or without the r/ prefix), e.g. programming, wallstreetbets, technology. Case-sensitive — use the exact casing from the subreddit’s URL (AskReddit, not askreddit). Defaults to a demo subreddit if omitted."
        },
        "sort": {
          "type": "string",
          "description": "Feed sort order.",
          "enum": [
            "hot",
            "new",
            "top",
            "rising",
            "controversial"
          ]
        },
        "time": {
          "type": "string",
          "description": "Time window — only applies to top/controversial.",
          "enum": [
            "hour",
            "day",
            "week",
            "month",
            "year",
            "all"
          ]
        },
        "limit": {
          "type": "integer",
          "description": "Max posts to return (1-100).",
          "minimum": 1,
          "maximum": 100
        }
      },
      "required": [
        "subreddit"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "limit": {
              "description": "Max posts to return (1-100).",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            },
            "sort": {
              "description": "Feed sort order.",
              "enum": [
                "hot",
                "new",
                "top",
                "rising",
                "controversial"
              ],
              "type": "string"
            },
            "subreddit": {
              "description": "Subreddit name (with or without the r/ prefix), e.g. programming, wallstreetbets, technology. Case-sensitive — use the exact casing from the subreddit’s URL (AskReddit, not askreddit). Defaults to a demo subreddit if omitted.",
              "type": "string"
            },
            "time": {
              "description": "Time window — only applies to top/controversial.",
              "enum": [
                "hour",
                "day",
                "week",
                "month",
                "year",
                "all"
              ],
              "type": "string"
            }
          },
          "required": [
            "subreddit"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "asOf": {
              "type": "string"
            },
            "count": {
              "type": "number"
            },
            "posts": {
              "items": {
                "properties": {
                  "author": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string"
                  },
                  "domain": {
                    "type": "string"
                  },
                  "externalUrl": {
                    "type": "string"
                  },
                  "flair": {
                    "type": "string"
                  },
                  "fullId": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "isNsfw": {
                    "type": "boolean"
                  },
                  "isSelf": {
                    "type": "boolean"
                  },
                  "numComments": {
                    "type": "number"
                  },
                  "recordType": {
                    "type": "string"
                  },
                  "score": {
                    "type": "number"
                  },
                  "scrapedAt": {
                    "type": "string"
                  },
                  "subreddit": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "sort": {
              "type": "string"
            },
            "source": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "via": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "subreddit": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}