← API Overview
POST
/scrape (SERP)
service=serpExtract search results from Google, Bing & DuckDuckGo. Organic results, ads, featured snippets, People Also Ask, related searches. 1 credit per query.
Request Body
{
"service": "serp",
"queries": ["best restaurants NYC", "coffee shops Manhattan"],
"search_engine": "google",
"search_type": "text",
"country": "us",
"language": "en",
"max_results": 10,
"pages": 1,
"include_paa": true,
"include_related": true
}
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| service | string | Yes | Must be serp |
| queries | array or string | Yes | Search queries — array or newline-separated (1–50 per job) |
| search_engine | string | No | google, bing, duckduckgo (default: google) |
| search_type | string | No | text, images, news, videos, shopping, maps (default: text) |
| country | string | No | ISO country code (default: us) |
| language | string | No | Language code (default: en) |
| max_results | integer | No | Results per query (10–100, default: 10) |
| pages | integer | No | Pages per query (1–5, default: 1) |
| include_paa | boolean | No | People Also Ask (default: true) |
| include_related | boolean | No | Related searches (default: true) |
| include_ads | boolean | No | Paid ads (default: false) |
| include_local_pack | boolean | No | Local pack (default: false) |
💡 Pricing: 1 credit per query. Use
GET /job-status to poll; GET /jobs/:id/download returns one SERP object per query.
Response
{
"success": true,
"job_id": 42,
"status": "running",
"service": "serp",
"query_count": 2,
"estimated_credits": 2
}
Example (Python)
import requests response = requests.post( "https://sitepry.com/api/v1/scrape", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={ "service": "serp", "queries": ["best restaurants NYC", "coffee shops Manhattan"], "search_engine": "google", "country": "us" } ) print(response.json())
Data Fields
Each SERP result includes: query, engine, organic (rank, title, url, snippet), ads, featuredSnippet, peopleAlsoAsk, relatedSearches, localPack.
See shared endpoints (balance, jobs, download) →Get 500 free credits for just $1
Get Started →