https://data.decodo.com/v1
Endpoints
| Endpoint | What it does | Returns | Mode |
|---|---|---|---|
/scrape | Gets the content of a single page, or parsed data from a supported website such as Google or Amazon. | HTML, Markdown, JSON, screenshots, and more | Synchronous, asynchronous, or batch |
/search | Gets Google search results for a query in under a second. | Parsed organic results and top stories | Synchronous |
/crawl | Scrapes up to 10,000 pages from a site, starting from the URL you submit. | Markdown or HTML for each page | Asynchronous |
/map | Lists the URLs found on the page you submit and in the site’s top-level sitemap (up to 147K), without scraping page content. | A list of URLs | Synchronous |
Which endpoint should I use?
| You want to… | Use |
|---|---|
| Get the content of a page you already have the URL for | /scrape |
| Get structured data from Google, Amazon, Walmart, TikTok, or another supported website | /scrape with a target template |
| Scrape many URLs at once, or collect results later | /scrape with asynchronous or batch requests |
| Get Google search results for a query, fast | /search |
| Collect page content from a site or one of its sections (up to 10,000 pages) | /crawl |
| See what pages a website has before you scrape it | /map |
Authentication
Every endpoint uses the same API key. Copy it from the dashboard and send it in theAuthorization header:
Synchronous and asynchronous requests
- Synchronous endpoints -
/scrape,/searchand/map- return results in the same response. - Asynchronous endpoints return an ID straight away and do the work in the background.
/crawlis always asynchronous./scrapecan also run asynchronously through/task, which suits large volumes or slow pages. Check the status, fetch results when they’re ready, or provide a callback URL to be notified.
Quick start
- Sign up - activate the free plan or choose a paid plan in the dashboard.
- Copy your API key from the dashboard.
- Pick an endpoint from the table above.
- Send your first request - for example, scrape a single page:
Pricing
All endpoints are priced per 1K requests, and the rate gets lower on larger plans. Depending on the endpoint, the rate also depends on the proxy pool and whether JavaScript is rendered:| Endpoint | Proxy pool | JavaScript rendering |
|---|---|---|
/scrape | Standard or Premium | Optional |
/search | Single rate | - |
/crawl | Premium | Optional - only for pages that fail without it |
/map | Premium | Optional |
/scrape have a single rate of $1.50 per 1K requests on every plan.
You only pay for successful requests. See all rates on the Billing page.
You can monitor usage for every endpoint in the dashboard’s Statistics section, including success rates and traffic breakdowns by domain and time.
Usage policy
Web Data API is intended for collecting publicly accessible web data.We don’t support collecting:- Post-login or authenticated content
- Private user information
- Restricted or non-public data
Support
Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.
You can also reach us anytime via email at support@decodo.com.
Feedback
Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.
Have feedback? Share your thoughts on how we can improve.