← API Overview
POST

/scrape (SERP)

service=serp

Extract 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

NameTypeRequiredDescription
servicestringYesMust be serp
queriesarray or stringYesSearch queries — array or newline-separated (1–50 per job)
search_enginestringNogoogle, bing, duckduckgo (default: google)
search_typestringNotext, images, news, videos, shopping, maps (default: text)
countrystringNoISO country code (default: us)
languagestringNoLanguage code (default: en)
max_resultsintegerNoResults per query (10–100, default: 10)
pagesintegerNoPages per query (1–5, default: 1)
include_paabooleanNoPeople Also Ask (default: true)
include_relatedbooleanNoRelated searches (default: true)
include_adsbooleanNoPaid ads (default: false)
include_local_packbooleanNoLocal 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 →