Introduction
The Scrapeless Scraping API is an innovative solution designed to simplify the extraction of data from websites with ease. Engineered to navigate even the most intricate web environments, it effectively manages dynamic content and JavaScript rendering.
With a single API call you get instant access to clean, structured data — no proxies, browsers, or CAPTCHA handling to write or maintain on your side.
Available Scrapers
Each scraper is exposed through the same API, selected with the actor parameter. Start with a scraper below:
| Scraper | actor | Description |
|---|---|---|
| Google Search | scraper.google.search | Real-time Google Search and Google Image results as structured JSON. |
| Amazon Scraper | scraper.amazon | Product details, search results, offers, and reviews from Amazon. |
| TikTok Scraper | scraper.tiktok | Product details, search results, offers, and reviews from Tiktok. |
Getting Started
Send a single API call to extract structured data from a target site. The example below submits a task and, for longer-running tasks, polls until the result is ready.
import { Scrapeless } from '@scrapeless-ai/sdk';
const client = new Scrapeless({
apiKey: 'YOUR_API_KEY',
});
async function runTask() {
const result = await client.scraping.scrape({
actor: 'scraper.shopee',
input: {
url: 'https://shopee.tw/a-i.10228173.24803858474'
}
});
return result;
}
runTask()
.then(data => {
console.log('Data:', data);
})
.catch(error => {
console.error('Error:', error);
});Parameters
| Parameter | Type | Description |
|---|---|---|
| actor | string | Scraping service (e.g., scraper.shopee). |
| input | object | Task-specific parameters (e.g., action, url). |
| proxy | object | Optional proxy configuration with country field. |
Task Workflow
Every Scraping API task follows the same three-step lifecycle. Fast tasks return data directly; longer-running tasks switch to an asynchronous, poll-for-results flow.
- Submit a Task — Send a
POSTrequest to/api/v1/scraper/request. - Handle the Response
- HTTP 200 (Success): Data is returned directly in the response body.
- HTTP 201 (Processing): Use the provided
taskIdto poll for results.
- Poll for Results — For asynchronous tasks, repeatedly call
/api/v1/scraper/result/{taskId}until data is ready (HTTP 200).
For the full list of status codes and polling guidance, see Results and Polling. To receive results via a callback instead of polling, see Webhooks.
Billing Information
- Charges are applied on a per-request basis.
- Only successful requests will be billed.