Extracto API

Web data, ready for your code.

Send parser input as JSON, run it in the background and retrieve the result with your API key. The same parsers are available in the Playground.

Get an API key Read the quickstart

Authentication

One API key header

Pass your Extracto key in X-API-KEY. Create and revoke keys in your account console.

Execution

Queue longer runs

Submit a run, store its ID and poll for completion or receive a result webhook. Use synchronous execution when you can keep the connection open.

Usage

One credit balance

Live runs use your account credits. Your workspace shows separate limits for parser launches, status checks and cost estimates.

Your first queued request

This example uses Instagram Scraper. Examples are shown for reference; sending a live request spends credits.

cURL · submit a run

curl --request POST 'https://extracto.cloud/api/v1/parsers/instagram-posts/queue' \
  --header 'X-API-KEY: ext_your_api_key' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data-binary @- <<'JSON'
{
  "input": {
    "resultsType": "posts",
    "directUrls": [
      "https://www.instagram.com/nike/"
    ],
    "resultsLimit": 100,
    "searchType": "hashtag",
    "searchLimit": 10,
    "addParentData": false
  }
}
JSON

See the response and retrieve your result →

API endpoints

Method	Path	Purpose
POST	`/api/v1/parsers/{tool}/estimate`	Estimate cost and get a confirmation token. See budget confirmation.
POST	`/api/v1/parsers/{tool}/queue`	Start a background run.
GET	`/api/v1/parser-runs/{uuid}`	Read your run status and completed result.
POST	`/api/v1/parsers/{tool}`	Run a parser and wait for a JSON result.
POST	`/api/v1/parser-runs/{uuid}/cancel`	Request cancellation. Queued tasks refund their reservation; running tasks await provider confirmation and usage calculation.
POST	`/api/v1/parser-runs/{uuid}/webhook/retry`	Retry a failed result delivery without rerunning the parser. See result webhooks.
POST	`/api/v1/preview`	Get illustrative demo data. This endpoint does not perform live scraping or spend credits.

Parser reference

Each published parser has its own input schema, example request and output reference.

Find a parser

POST · JSON

Web data, ready for your code.

One API key header

Queue longer runs

One credit balance

Your first queued request

API endpoints

Parser reference

Amazon Product Scraper

Booking Reviews Scraper

Glassdoor Jobs Scraper

Google Maps Scraper

Google Maps Reviews Scraper

Google Search Scraper

Indeed Jobs Scraper

Instagram Scraper

LinkedIn Company Scraper

LinkedIn Jobs Scraper

Shopify Product Scraper

TikTok Scraper

Tripadvisor Reviews

Tripadvisor Reviews Scraper

Trustpilot Reviews Scraper

Website Contact Extractor

Yelp Reviews Scraper

YouTube Scraper

Zillow Property Scraper