Name: Real-time Google SERP API: Get Search Results with SerpLib
Brand: serplib
SKU: api-serplib-serp
Availability: InStock
Author: API Market

İbrahim YAVUZ

# SerpLib - Google SERP API

## Overview
SerpLib is a powerful Google Search Results API that delivers real-time, structured JSON data from Google's search engine. With a single POST request, you can access 7 different search types — all through one unified API.

## Endpoints
- **Web Search** — Organic results, knowledge graph, featured snippets, People Also Ask
- **Image Search** — Image URLs, dimensions, thumbnails, source info
- **News Search** — Latest headlines and articles from Google News
- **Maps & Places** — Local businesses, ratings, addresses, contact info
- **Video Search** — YouTube and web videos with thumbnails and metadata
- **Shopping** — Product listings, prices, ratings, merchant data
- **Autocomplete** — Google search suggestions in real-time

## Why SerpLib?
- ⚡ Average response time under 2 seconds
- 🌍 Country & language targeting (gl, hl parameters)
- 📄 Pagination support for deep result retrieval
- 💰 Affordable pricing starting at $0.004 per query
- 🔑 Simple authentication with a single API key header
- 📊 Usage tracking and analytics via dashboard

## Use Cases
- SEO tools & rank tracking
- AI/LLM grounding & RAG pipelines
- Market research & competitor analysis
- Price monitoring & comparison
- Lead generation & data enrichment
- Content research & automation

## Quick Start
1. Get your API key (100 free credits included)
2. Send a POST request with your query
3. Receive structured JSON results instantly

Each API call costs just 1 credit. No rate surprises, no hidden fees.

## API Documentation

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/magicapi/serp`

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### 1. Web Search

`POST /api/v1/search`

Get Google web search results including organic results, knowledge graph, featured snippets, People Also Ask, and related searches.

**Request Body:**

```json
{
  "q": "best programming languages 2025",
  "gl": "us",
  "hl": "en",
  "num": 10,
  "page": 1
}
```

**Response:**

```json
{
  "searchParameters": {
    "q": "best programming languages 2025",
    "type": "web",
    "engine": null,
    "gl": "us",
    "hl": "en",
    "num": 10
  },
  "organic": [
    {
      "title": "Top Programming Languages 2024 - Forbes Advisor",
      "link": "https://www.forbes.com/advisor/education/top-programming-languages/",
      "snippet": "Oct 27, 2023 — Python is rapidly becoming the most popular language. With a readable syntax, Python is easy to learn and use. With the growth of AI and machine learning, Python has established itself as a leader.",
      "position": 1,
      "date": "Oct 27, 2023"
    }
  ],
  "knowledgeGraph": null,
  "peopleAlsoAsk": [],
  "relatedSearches": [],
  "credits": {
    "used": 1,
    "remaining": 999
  }
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/serp/search" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
  "q": "best programming languages 2025",
  "gl": "us",
  "hl": "en",
  "num": 10,
  "page": 1
}'
```

#### 2. Image Search

`POST /api/v1/images`

Search for images across the web. Returns image URLs, dimensions, thumbnails, and source information.

**Request Body:**

```json
{
  "q": "sunset wallpaper",
  "gl": "us",
  "num": 10
}
```

**Response:**

```json
{
  "searchParameters": {
    "q": "sunset wallpaper",
    "type": "images",
    "engine": null,
    "gl": "us",
    "hl": null,
    "num": 10
  },
  "images": [
    {
      "title": "Beautiful Sunset Wallpapers - Wallpaper Cave",
      "imageUrl": "https://wallpapercave.com/wp/wp7706791.jpg",
      "imageWidth": 1920,
      "imageHeight": 1200,
      "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR8Ea8t1Wn_5nK6Pj7S0pU_4jZ0LwzX3N9N8g&usqp=CAU",
      "source": "wallpapercave.com",
      "domain": "wallpapercave.com",
      "link": "https://wallpapercave.com/beautiful-sunset-wallpapers",
      "position": 1
    }
  ],
  "credits": {
    "used": 1,
    "remaining": 999
  }
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/serp/images" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
  "q": "sunset wallpaper",
  "gl": "us",
  "num": 10
}'
```

#### 3. News Search

`POST /api/v1/news`

Get the latest news articles and headlines from Google News.

**Request Body:**

```json
{
  "q": "artificial intelligence",
  "gl": "us",
  "hl": "en"
}
```

**Response:**

```json
{
  "searchParameters": {
    "q": "artificial intelligence",
    "type": "news",
    "engine": null,
    "gl": "us",
    "hl": "en",
    "num": null
  },
  "news": [
    {
      "title": "What to expect from AI in 2024",
      "link": "https://venturebeat.com/ai/what-to-expect-from-ai-in-2024/",
      "snippet": "As we kick off 2024, here are some of the biggest artificial intelligence (AI) trends and predictions to keep an eye on. Generative AI models, such as ...",
      "date": "Jan 1, 2024",
      "source": "VentureBeat",
      "imageUrl": "https://venturebeat.com/wp-content/uploads/2023/12/GettyImages-1845414056.jpg?fit=1200%2C600&strip=all",
      "position": 1
    }
  ],
  "credits": {
    "used": 1,
    "remaining": 999
  }
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/serp/news" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
  "q": "artificial intelligence",
  "gl": "us",
  "hl": "en"
}'
```

#### 4. Maps & Places Search

`POST /api/v1/maps`

Search for local businesses, restaurants, hotels, and places with ratings, addresses, and contact info.

**Request Body:**

```json
{
  "q": "coffee shops near Times Square",
  "gl": "us"
}
```

**Response:**

```json
{
  "searchParameters": {
    "q": "coffee shops near Times Square",
    "type": "maps",
    "engine": null,
    "gl": "us",
    "hl": null,
    "num": null
  },
  "places": [
    {
      "title": "Starbucks",
      "address": "1500 Broadway, New York, NY 10036",
      "latitude": 40.757517,
      "longitude": -73.986029,
      "rating": 4.0,
      "ratingCount": 1073,
      "category": "Coffee shop",
      "phoneNumber": "(212) 764-0526",
      "website": "https://www.starbucks.com/",
      "position": 1
    }
  ],
  "credits": {
    "used": 1,
    "remaining": 999
  }
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/serp/maps" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
  "q": "coffee shops near Times Square",
  "gl": "us"
}'
```

#### 5. Video Search

`POST /api/v1/videos`

Find videos from YouTube and other platforms with thumbnails, duration, and channel info.

**Request Body:**

```json
{
  "q": "javascript tutorial",
  "gl": "us",
  "num": 10
}
```

**Response:**

```json
{
  "searchParameters": {
    "q": "javascript tutorial",
    "type": "videos",
    "engine": null,
    "gl": "us",
    "hl": null,
    "num": 10
  },
  "videos": [
    {
      "title": "JavaScript Tutorial for Beginners: Learn JavaScript in 1 Hour [2024]",
      "link": "https://www.youtube.com/watch?v=W6NZfCO5SIk",
      "snippet": "JavaScript Tutorial for Beginners: Learn JavaScript in 1 Hour [2024] / Learn JavaScript with this full tutorial course for beginners. The main goal is to ...",
      "imageUrl": "https://i.ytimg.com/vi/W6NZfCO5SIk/hqdefault.jpg",
      "duration": "1:01:56",
      "source": "YouTube",
      "channel": "Programming with Mosh",
      "date": "Dec 15, 2018",
      "position": 1
    }
  ],
  "credits": {
    "used": 1,
    "remaining": 999
  }
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/serp/videos" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
  "q": "javascript tutorial",
  "gl": "us",
  "num": 10
}'
```

#### 6. Shopping Search

`POST /api/v1/shopping`

Get product listings, prices, ratings, and merchant data from Google Shopping.

**Request Body:**

```json
{
  "q": "wireless headphones",
  "gl": "us"
}
```

**Response:**

```json
{
  "searchParameters": {
    "q": "wireless headphones",
    "type": "shopping",
    "engine": null,
    "gl": "us",
    "hl": null,
    "num": null
  },
  "shopping": [
    {
      "title": "Beats Solo3 Wireless On-Ear Headphones - Apple W1 Headphone Chip, Class 1 Bluetooth, 40 Hours of Listening Time - Black",
      "source": "target.com",
      "link": "https://www.target.com/p/beats-solo3-wireless-on-ear-headphones/-/A-53613708",
      "price": "$129.99",
      "imageUrl": "https://target.scene7.com/is/image/Target/GUEST_0e510b5c-6981-436d-b6b3-e40d8a24b120",
      "rating": 4.6,
      "ratingCount": 12495,
      "delivery": "Free standard shipping with $35 orders",
      "position": 1
    }
  ],
  "credits": {
    "used": 1,
    "remaining": 999
  }
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/serp/shopping" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
  "q": "wireless headphones",
  "gl": "us"
}'
```

#### 7. Autocomplete Suggestions

`POST /api/v1/autocomplete`

Get Google autocomplete/search suggestions for a partial query.

**Request Body:**

```json
{
  "q": "how to",
  "gl": "us",
  "hl": "en"
}
```

**Response:**

```json
{
  "searchParameters": {
    "q": "how to",
    "type": "autocomplete",
    "engine": null,
    "gl": "us",
    "hl": "en",
    "num": null
  },
  "suggestions": [
    {
      "value": "how to get rid of a cold"
    },
    {
      "value": "how to make money online"
    }
  ],
  "credits": {
    "used": 1,
    "remaining": 999
  }
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/serp/autocomplete" \
     -H "Content-Type: application/json" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -d '{
  "q": "how to",
  "gl": "us",
  "hl": "en"
}'
```

## Status Codes

*   **200 OK:** Request successful.
*   **400 Bad Request:** Invalid input parameters or malformed request. Review the request body and ensure all required parameters are present and correctly formatted. Check for type mismatches or values outside of allowed ranges.
*   **401 Unauthorized:** Missing or invalid API key. Ensure the `x-api-market-key` header is present and contains a valid API key.
*   **402 Insufficient credits:** Your account does not have enough credits to perform the request. Upgrade your plan or purchase more credits.
*   **429 Too Many Requests:** Rate limit exceeded. Reduce the number of requests you are making per minute.
*   **503 Service Unavailable:** Service temporarily unavailable. Try again later.

## Rate Limits

The API is rate-limited to 60 requests per minute per API key. If you exceed this limit, you will receive a `429 Too Many Requests` error. Implement retry logic in your code to handle rate limiting gracefully.

Get real-time Google search results for SEO, market research, and AI with SerpLib API. Fast, reliable, and affordable SERP data.

Real-time Google SERP API: Get Search Results with SerpLib

Free