Google Search Scraping API

Extract Google search results at scale for SEO research, competitor analysis, and market research.

🚀 Key Features

• Global Targeting - Search from 190+ countries with localized results
• Multi-Language - 14+ languages including English, Spanish, French, German
• Advanced Filters - Time-based filters (hour, day, week, month, year)
• High Volume - Up to 100 results per request with pagination
• Structured Data - Clean JSON with title, description, URL, metadata
• Real-Time - Fresh search results with minimal delay
• 99%+ Success Rate - Automatic retries to achieve 99%+ uptime

📋 Endpoint

POST requests only - All Google search requests must use the POST method:

POST https://scrapingapi.qoest.com/v1/google-search

🔑 Authentication

All requests must include your API token in the Authorization header using Bearer authentication:

Authorization: Bearer YOUR_API_TOKEN

📊 Parameters

Parameter	Required	Type	Description
query	Yes	string	Search query
country	No	string	Country code (default: us)
language	No	string	Language code (default: en)
page	No	integer	Page number (min: 1, default: 1)
per_page	No	integer	Results per page: 10-100 (default: 10)
time_range	No	string	Time filter: hour, day, week, month, year

Supported Countries

We support 190+ countries. Popular options include:

Code	Country	Code	Country	Code	Country
us	United States	gb	United Kingdom	ca	Canada
au	Australia	de	Germany	fr	France
it	Italy	es	Spain	jp	Japan
kr	South Korea	cn	China	in	India
br	Brazil	mx	Mexico	ru	Russia

Supported Languages

Code	Language	Code	Language
en	English	es	Spanish
fr	French	de	German
it	Italian	pt	Portuguese
ja	Japanese	ko	Korean
zh	Chinese	ar	Arabic
hi	Hindi	ru	Russian
tr	Turkish	ur	Urdu

💰 Pricing

Monthly Subscription Tiers

Plan	Price	Credits	Cost per Credit
Tier 1	$10/month	10,000 credits	$0.001
Tier 2	$50/month	55,000 credits	$0.0009
Tier 3	$100/month	115,000 credits	$0.00087
Tier 4	$500/month	600,000 credits	$0.00083
Tier 5	$1,000/month	1,250,000 credits	$0.0008

Credit Usage

Dynamic Credit Calculation: Credits are calculated based on results requested:

• Formula: max(3, round(per_page / 3)) credits per request
• Minimum: 3 credits per request (regardless of results count)
• Examples:
  • 10 results = 3 credits (minimum)
  • 15 results = 5 credits
  • 20 results = 7 credits
  • 30 results = 10 credits
  • 50 results = 17 credits
  • 100 results = 33 credits

Usage Examples

• Tier 1 ($10): 3,333 searches (10 results each)
• Tier 2 ($50): 18,333 searches (10 results each)
• Tier 3 ($100): 38,333 searches (10 results each)

📝 Examples

Basic Search

curl "https://scrapingapi.qoest.com/v1/google-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "best laptops 2024", "country": "us"}'

With Filters

curl "https://scrapingapi.qoest.com/v1/google-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "AI news",
    "time_range": "week",
    "per_page": 20
  }'

Multi-Language

curl "https://scrapingapi.qoest.com/v1/google-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "recetas fáciles",
    "country": "es",
    "language": "es"
  }'

📤 Response Format

Successful Response

{
    "response": [
        {
            "title": "Imran Khan",
            "description": "a Pakistani politician, philanthropist, and former cricketer who served as the 19th prime minister of Pakistan from August 2018 until April 2022.",
            "meta_data": "https://en.wikipedia.org › wiki › Imran_Khan https://en.wikipedia.org › wiki › Imran_Khan",
            "url": "https://en.wikipedia.org/wiki/Imran_Khan"
        },
        {
            "title": "Imran Khan - Cricket Player Pakistan",
            "description": "Imran Khan was the finest cricketer Pakistan has produced, nor that he was the most famous, the most inspirational captain, and the biggest heartthrob.",
            "meta_data": "https://www.espncricinfo.com › imran-khan-40560 https://www.espncricinfo.com › imran-khan-40560",
            "url": "https://www.espncricinfo.com/cricketers/imran-khan-40560"
        },
        {
            "title": "Imran Khan (@ImranKhanPTI) / X",
            "description": "Chairman Pakistan Tehreek-e-Insaf & former Prime Minister of Islamic Republic of Pakistan.",
            "meta_data": "21.3M+ followers 21.3M+ followers",
            "url": "https://x.com/imrankhanpti"
        },
        {
            "title": "Imran Khan (@imrankhan) • Instagram photos and videos",
            "description": "ImranKhan, the most loved actor of the 2000s, speaks from his heart about his films, growing up in a film family & being a single parent.",
            "meta_data": "920.5K+ followers 920.5K+ followers",
            "url": "https://www.instagram.com/imrankhan/?hl=en"
        },
        {
            "title": "Imran Khan",
            "description": "Official YouTube Channel of Founder Chairman Pakistan Tehreek-e-Insaf & Former Prime Minister of Pakistan ''Imran Khan'' ...more",
            "meta_data": "2.3M+ followers 2.3M+ followers",
            "url": "https://www.youtube.com/channel/UC6EgwYuYThiGPv7neS9DKqw"
        },
    ]
}

Error Responses

General Error (Server Issues)

{
  "message": "No results found!"
}

Validation Error (422)

{
  "message": "The given data was invalid.",
  "errors": {
    "query": ["The query field is required."],
    "country": ["The selected country is invalid."],
    "page": ["The page must be at least 1."],
    "per_page": ["The per page must be between 10 and 100."],
    "time_range": ["The selected time range is invalid."],
    "language": ["The selected language is invalid."]
  }
}

Insufficient Credits (403)

{
  "message": "You do not have enough credits to perform this action."
}

Authentication Required (401)

{
  "message": "Unauthenticated."
}

⚠️ Validation Rules

Query Requirements

• Required field: Must be a non-empty string
• No length restrictions, but very long queries may not return optimal results

Country & Language

• Country: Must be from supported country list (see above)
• Language: Must be from supported language list (see above)
• Both parameters are case-sensitive

Pagination

• Page: Must be integer ≥ 1
• Per Page: Must be integer between 10-100 (inclusive)

Time Range

• Valid values: hour, day, week, month, year
• Case-sensitive (must be lowercase)

🚨 Common Issues

• No Results: Try broader search terms, check spelling, verify country/language settings
• Validation Errors: Ensure all parameters meet format requirements
• Insufficient Credits: Check credit balance before making requests
• Rate Limiting: Implement delays between requests (1-2 seconds) for better success rates
• Inconsistent Results: Use specific country/language settings for consistent geo-targeting
• Authentication: Ensure Bearer token is correctly formatted and valid

🎯 Use Cases

SEO Research & Keyword Analysis

Track keyword rankings, analyze SERP features, and monitor competitors.

curl "https://scrapingapi.qoest.com/v1/google-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "best laptop 2024", "country": "us", "per_page": 50}'

Market Research & Competitor Analysis

Discover market trends, competitor content, and business opportunities.

curl "https://scrapingapi.qoest.com/v1/google-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "fintech startups", "time_range": "month", "per_page": 30}'

Content Research & Topic Discovery

Find trending topics, content ideas, and authoritative sources.

curl "https://scrapingapi.qoest.com/v1/google-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "artificial intelligence trends", "time_range": "week"}'

Local Business Research

Research local businesses, services, and market opportunities.

curl "https://scrapingapi.qoest.com/v1/google-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "restaurants near me", "country": "us", "language": "en"}'

📚 Related APIs

• Web Scraping - Extract website data
• Reddit Scraping - Extract social media data
• Twitter/X Scraping - Extract social media data
• YouTube Scraping - Extract video data
• Image OCR - Extract text from images
• PDF OCR - Extract text from PDFs