Run a scraper
GET or POST /api/v1/scrape/{platform}/{action}: inputs as query parameters or a JSON body, X-Request-Id idempotency, and the exact per-call price.
hproxy.com/api/v1/scrape/{platform}/{action}Run a scraper
Call a specific platform action (e.g. threads/search or tiktok/profile). Pass inputs as query parameters, or POST the same fields as a JSON body. Each scraper's exact inputs are in the catalog: profile actions take handle, page actions take url, search actions take query and, where supported, a start_date / end_date window. Boolean and integer inputs work in query strings too (trim=true is fine). Send an optional X-Request-Id header with a unique value and a retry of the same request replays the original result instead of running (and billing) again.
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string (query) | optional | Handle/username, for profile-style actions. |
url | string (query) | optional | Target URL, when the action scrapes a specific page. |
query | string (query) | optional | Search term, for search actions. |
start_date | string (query) | optional | YYYY-MM-DD. Search actions that support it return posts from this date onward. |
end_date | string (query) | optional | YYYY-MM-DD. Upper bound of the search window. |
X-Request-Id | string (header) | optional | Idempotency: a retry with the same value returns the original run's result and is never billed twice. |
curl "https://hproxy.com/api/v1/scrape/threads/search?query=coffee&start_date=2026-07-01&end_date=2026-07-22" \
-H "X-API-Key: hpx_your_key_here"The full list of every platform and action is in the Scraper catalog, or fetch it as JSON from GET https://hproxy.com/api/v1/scrapers (no key required).
Need a hand wiring this up? Email support@hproxy.com. A real person reads every message.