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.
GET
/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"No proxies, no captchas, no infrastructure. The call price includes our proxy network, captcha handling and parsing. You only ever send the request above.
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 [email protected]. A real person reads every message.