Skip to main content

​
SERP API

Extract search engine results pages (SERPs) with high accuracy and comprehensive data parsing.

​
Supported Search Engines

  • Google - Web, Images, News, Shopping, Videos
  • Bing - Web search results
  • DuckDuckGo - Privacy-focused search
  • Yandex - Russian search engine
  • Baidu - Chinese search engine

​
Basic SERP Request

​
Endpoint

POST https://api.nimbleway.com/v1/serp

​
Google Search Example

curl -X POST "https://api.nimbleway.com/v1/serp" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "engine": "google",
    "query": "web scraping tools",
    "location": "United States"
  }'

​
Response

{
  "status": "success",
  "engine": "google",
  "query": "web scraping tools",
  "location": "United States",
  "results": {
    "organic": [
      {
        "position": 1,
        "title": "Best Web Scraping Tools - 2024 Guide",
        "url": "https://example.com/scraping-tools",
        "description": "Comprehensive guide to web scraping tools...",
        "displayed_url": "example.com/scraping-tools"
      }
    ],
    "ads": [
      {
        "position": 1,
        "title": "Professional Web Scraping Service",
        "url": "https://ads.example.com",
        "description": "Get reliable data extraction..."
      }
    ],
    "people_also_ask": [
      {
        "question": "What are the best web scraping tools?",
        "answer": "The best web scraping tools include..."
      }
    ]
  },
  "pagination": {
    "current_page": 1,
    "total_pages": 10,
    "results_per_page": 10
  }
}

​
Parameters

​
Required Parameters

ParameterTypeDescription
enginestringSearch engine: google, bing, duckduckgo, yandex, baidu
querystringSearch query

​
Optional Parameters

ParameterTypeDefaultDescription
locationstringUnited StatesGeographic location for results
languagestringenLanguage code (e.g., en, es, fr)
pageinteger1Results page number
num_resultsinteger10Number of results per page
safe_searchstringmoderateSafe search: off, moderate, strict
time_rangestringanyTime filter: hour, day, week, month, year

​
Search Engine Specific Features

​
Google Features

{
  "engine": "google",
  "search_type": "images", 
  "query": "mountain landscapes",
  "image_size": "large",
  "image_type": "photo"
}

{
  "engine": "google",
  "search_type": "news",
  "query": "artificial intelligence",
  "time_range": "week",
  "sort_by": "relevance"
}

{
  "engine": "google", 
  "search_type": "shopping",
  "query": "wireless headphones",
  "min_price": 50,
  "max_price": 200
}

​
Bing Features

{
  "engine": "bing",
  "query": "machine learning",
  "location": "United Kingdom",
  "freshness": "week"
}

​
Location Targeting

​
By Country

{
  "engine": "google",
  "query": "restaurants nearby", 
  "location": "France"
}

​
By City

{
  "engine": "google",
  "query": "weather forecast",
  "location": "New York, NY, United States"
}

​
By Coordinates

{
  "engine": "google",
  "query": "coffee shops",
  "location": {
    "lat": 40.7128,
    "lng": -74.0060,
    "radius": "10km"
  }
}

​
Response Data Structure

​
Organic Results

{
  "organic": [
    {
      "position": 1,
      "title": "Page Title",
      "url": "https://example.com",
      "description": "Meta description or snippet",
      "displayed_url": "example.com",
      "rich_snippets": {
        "rating": {
          "stars": 4.5,
          "reviews": 128
        },
        "price": "$29.99"
      }
    }
  ]
}

​
Knowledge Graph

{
  "knowledge_graph": {
    "title": "Company Name",
    "description": "Company description...",
    "website": "https://company.com",
    "stock_ticker": "COMP",
    "founded": "2010",
    "headquarters": "San Francisco, CA"
  }
}

{
  "featured_snippet": {
    "type": "paragraph",
    "question": "What is web scraping?",
    "answer": "Web scraping is the process of...",
    "source": {
      "title": "Web Scraping Guide",
      "url": "https://example.com/guide"
    }
  }
}

​
Use Cases

​
SEO Monitoring

Track keyword rankings for your website: 
{
  "engine": "google",
  "query": "your target keyword",
  "location": "United States",
  "page": 1,
  "num_results": 100
}

​
Competitor Analysis

Monitor competitor search visibility: 
{
  "engine": "google", 
  "query": "industry competitor keywords",
  "location": "target market location"
}

​
Market Research

Analyze search trends and user intent: 
{
  "engine": "google",
  "query": "product category research",
  "search_type": "images",
  "time_range": "month"
}

​
SDK Examples

​
Node.js

const results = await client.serp({
  engine: 'google',
  query: 'web scraping tools',
  location: 'United States',
  num_results: 20
});

console.log(results.organic);

​
Python

results = client.serp({
    'engine': 'google',
    'query': 'web scraping tools', 
    'location': 'United States',
    'num_results': 20
})

print(results['organic'])

​
Rate Limits

PlanRequests/HourConcurrent
Free1001
Starter1,0005
Professional10,00020
EnterpriseCustomCustom

​
Pricing

  • Google/Bing: $0.001 per request
  • DuckDuckGo: $0.0005 per request
  • Yandex/Baidu: $0.002 per request

​
Error Handling

​
Invalid Search Engine

{
  "status": "error",
  "error": "INVALID_ENGINE",
  "message": "Supported engines: google, bing, duckduckgo, yandex, baidu"
}

​
No Results Found

{
  "status": "success",
  "results": {
    "organic": [],
    "total_results": 0
  },
  "message": "No results found for query"
}

​
Best Practices

  • Use specific queries for better result quality
  • Set appropriate locations for geo-targeted results
  • Handle pagination for comprehensive data collection
  • Respect rate limits to avoid account suspension
  • Cache results to reduce API costs

​
Next Steps