Web Start Batch Scrape API
Scrape Web Start Batch Scrape data with one API call. Starts an async batch scrape job for multiple URLs and returns a SocialCrawl job id (job_...). Poll or cancel it via GET/DELETE /v1/web/jobs/{job_id}.
Last updated July 2026
Searching 44 platforms in parallel
What can you do with the Start Batch Scrape API?
The Start Batch Scrape endpoint gives you structured Web data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/web/batch-scrape?urls=https%3A%2F%2Fexample.com%2Fa%2Chttps%3A%2F%2Fexample.com%2Fb"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/web/batch-scrape",
params={
'urls': 'https://example.com/a,https://example.com/b',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/web/batch-scrape?urls=https%3A%2F%2Fexample.com%2Fa%2Chttps%3A%2F%2Fexample.com%2Fb",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| urls | Yes | Array or comma-separated list of public URLs to scrape. |
| ignore_invalid_urls | No | Skip invalid URLs instead of failing the job. |
| formats | No | |
| only_main_content | No | |
| proxy | No | (basic | auto | enhanced) |
| webhook_url | No |
What does the Web Start Batch Scrape API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "web",
"endpoint": "/v1/web/batch-scrape",
"data": {
"job_id": "job_7t2m4c9x5",
"kind": "batch_scrape",
"resource": "batch-scrape",
"status": "queued",
"progress": null,
"invalid_urls": null,
"result_ref": null,
"result": null,
"error": null,
"credits_hold": 2,
"credits_charged": 0,
"created_at": "2026-07-09T09:30:00.000Z",
"updated_at": "2026-07-09T09:30:00.000Z",
"expires_at": "2026-07-16T09:30:00.000Z"
},
"credits_used": 2,
"credits_remaining": 998,
"request_id": "req-a1b2c3d4e5f6",
"cached": false
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Web Start Batch Scrape API work?
Send a GET request with your API key and get back clean, structured JSON. Every response follows our unified schema with computed fields.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 44 platforms covering 10B+ monthly active users.
One schema, every platform
Query 44 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.
See your data before you code
Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape Web Start Batch Scrape data?
Get your API key and start pulling Web data in under 60 seconds.
