HProxy Reddit scraper API
The Reddit scraper API API from HProxy — 5 operation(s) for reddit scraper api.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hproxy-com:hproxy-com-reddit-scraper-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: HProxy Reddit scraper API
version: 1.0.0
description: 'Buy and manage proxies from a prepaid wallet, run the Scraper API, or use the free no-key APIs: a live proxy list, a proxy checker and an IP lookup. JSON in, JSON out. Money is always integer cents (120 = $1.20), never floats.'
contact:
url: https://hproxy.com/contact
license:
name: Proprietary
servers:
- url: https://hproxy.com
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Reddit scraper API
paths:
/api/v1/scrape/reddit/subreddit:
get:
operationId: subreddit
summary: Reddit Subreddit Details
description: Returns structured JSON for **Reddit Subreddit Details**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- Reddit scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: subreddit
in: query
required: true
description: Subreddit name, without the r/ prefix. Send this **or** `url`.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video). Send this **or** `subreddit`.
schema:
type: string
- name: cache_max_age
in: query
required: false
description: 'Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/reddit/subreddit-posts:
get:
operationId: subreddit-posts
summary: Reddit Subreddit Posts
description: Returns structured JSON for **Reddit Subreddit Posts**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- Reddit scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: subreddit
in: query
required: true
description: Subreddit name, without the r/ prefix.
schema:
type: string
- name: timeframe
in: query
required: false
description: 'Filter by date, as YYYY-MM-DD. Allowed values: `all`, `day`, `week`, `month`, `year`.'
schema:
type: string
- name: sort
in: query
required: false
description: 'Ordering to apply to the results. Allowed values: `best`, `hot`, `new`, `top`, `rising`.'
schema:
type: string
- name: after
in: query
required: false
description: The after parameter.
schema:
type: string
- name: trim
in: query
required: false
description: Return a slimmed-down payload (drops verbose fields).
schema:
type: boolean
- name: cache_max_age
in: query
required: false
description: 'Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/reddit/comments:
get:
operationId: scrapeRedditComments
summary: Reddit Post Comments
description: Returns structured JSON for **Reddit Post Comments**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- Reddit scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video).
schema:
type: string
- name: cursor
in: query
required: false
description: Pagination token from the previous response.
schema:
type: string
- name: trim
in: query
required: false
description: Return a slimmed-down payload (drops verbose fields).
schema:
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/reddit/search:
get:
operationId: scrapeRedditSearch
summary: Reddit Search
description: Returns structured JSON for **Reddit Search**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- Reddit scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: query
in: query
required: true
description: Search term or keyword.
schema:
type: string
- name: sort
in: query
required: false
description: 'Ordering to apply to the results. Allowed values: `relevance`, `new`, `top`, `comment_count`.'
schema:
type: string
- name: timeframe
in: query
required: false
description: 'Filter by date, as YYYY-MM-DD. Allowed values: `all`, `day`, `week`, `month`, `year`.'
schema:
type: string
- name: after
in: query
required: false
description: The after parameter.
schema:
type: string
- name: trim
in: query
required: false
description: Return a slimmed-down payload (drops verbose fields).
schema:
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/reddit/subreddit-search:
get:
operationId: subreddit-search
summary: Reddit Subreddit Search
description: Returns structured JSON for **Reddit Subreddit Search**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- Reddit scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: subreddit
in: query
required: true
description: Subreddit name, without the r/ prefix.
schema:
type: string
- name: query
in: query
required: false
description: Search term or keyword.
schema:
type: string
- name: sort
in: query
required: false
description: 'Ordering to apply to the results. Allowed values: `relevance`, `hot`, `top`, `new`, `comments`.'
schema:
type: string
- name: timeframe
in: query
required: false
description: 'Filter by date, as YYYY-MM-DD. Allowed values: `all`, `year`, `month`, `week`, `day`, `hour`.'
schema:
type: string
- name: cursor
in: query
required: false
description: Pagination token from the previous response.
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Your API key. Free keyless endpoints ignore it.
x-endpoint-count: 163
x-generated-from: https://hproxy.com/docs
x-llms: https://hproxy.com/llms-full.txt