Name: Keyword Search Volume API: Google & Amazon
Brand: vncnt-labs
SKU: api-vncnt-labs-keyword-volume-api
Availability: InStock
Author: API Market

# Keyword Search Volume API

## Overview

The Keyword Search Volume API returns search demand numbers for keywords from Google and Amazon. Two Google endpoints return monthly search volume, up to 48 months of history, month-over-month, quarter-over-quarter and year-over-year trends, cost per click, competition, the top-of-page bid range, keyword difficulty and search intent, for up to 10 keywords per call or up to 100 in bulk. A third endpoint returns estimated monthly Amazon search volume for product keywords in 16 Amazon marketplaces.

It is built for SEO and content tools, e-commerce sellers researching product keywords, PPC and ad managers who need CPC and competition data, and AI agents that plan content around demand. The data comes from DataForSEO's licensed Google Ads keyword database and Amazon search volume model, returned as clean JSON with a clear status for keywords that have no data.

## Features

*   **3 endpoints**: Google volume for 1 to 10 keywords, Google bulk for up to 100, and Amazon volume for 1 to 10.
*   **Rich Google metrics**: monthly volume and history, trend percentages, CPC, competition, bid range, keyword difficulty and search intent.
*   **94 countries** for Google and **16 Amazon marketplaces**.
*   **Fair billing**: calls where no keyword has data, invalid input and provider errors cost 0 credits.
*   **Licensed data**: sourced from DataForSEO, not scraped.
*   **Rate limit**: up to 10 requests per second.

## Use Cases

*   **SEO tools**: show search volume, difficulty and trends for keyword lists.
*   **Amazon sellers**: compare Amazon demand for product keywords across marketplaces.
*   **PPC planning**: estimate CPC and competition before launching ad campaigns.
*   **AI agents**: let an agent check real demand before choosing topics or product names.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/vncnt-labs/keyword-volume-api
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Google Search Volume

Returns Google monthly search volume, monthly history, trend percentages, CPC, competition, top-of-page bid range, keyword difficulty and search intent for 1 to 10 keywords. Costs 8 credits per call.

**Method:** `POST`

**Endpoint:** `/v1/keywords/google-volume`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| keywords | body | List of keywords, up to 80 characters and 10 words each. Case and spacing are normalised and duplicates are looked up once. | array of strings | Yes | - | 10 |
| location | body | Country name, 2-letter code (`US`, `GB`, `DE`) or DataForSEO location code (`2840`). 94 countries. | string | No | United States | - |
| language | body | Language code or name. Defaults to English where available, otherwise the country's main language. | string | No | - | - |
| trendMonths | body | How many months of history to return. | integer | No | 12 | 48 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/vncnt-labs/keyword-volume-api/v1/keywords/google-volume' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"keywords": ["coffee mug", "teacher gift"], "location": "United States"}'
```

**Example Response (200 OK, trimmed):**

`googleMonthlySearches` is cut to the 3 newest months; by default the API returns 12.

```json
{
  "ok": true,
  "provider": "VNCNT Labs",
  "results": [
    {
      "type": "keyword",
      "keyword": "coffee mug",
      "inputKeyword": "coffee mug",
      "location": "United States",
      "locationCode": 2840,
      "language": "en",
      "googleSearchVolume": 60500,
      "googleMonthlySearches": [
        {
          "month": "2026-09",
          "searchVolume": 60500
        },
        {
          "month": "2026-08",
          "searchVolume": 49500
        },
        {
          "month": "2026-07",
          "searchVolume": 40500
        }
      ],
      "googleTrend": {
        "monthOverMonthPct": 22,
        "quarterOverQuarterPct": 49,
        "yearOverYearPct": 22
      },
      "cpcUsd": 1.06,
      "competition": 1,
      "competitionLevel": "HIGH",
      "lowTopOfPageBidUsd": 0.3,
      "highTopOfPageBidUsd": 2.78,
      "keywordDifficulty": 1,
      "searchIntent": "transactional",
      "googleDataSource": "dataforseo_labs_google",
      "googleDataUpdatedAt": "2026-10-16 13:11:35 +00:00",
      "googleStatus": "ok",
      "checkedAt": "2026-10-25T21:11:26Z"
    },
    {
      "type": "keyword",
      "keyword": "teacher gift",
      "inputKeyword": "teacher gift",
      "location": "United States",
      "locationCode": 2840,
      "language": "en",
      "googleSearchVolume": 18100,
      "googleMonthlySearches": [
        {
          "month": "2026-09",
          "searchVolume": 8100
        },
        {
          "month": "2026-08",
          "searchVolume": 12100
        },
        {
          "month": "2026-07",
          "searchVolume": 6600
        }
      ],
      "googleTrend": {
        "monthOverMonthPct": -33,
        "quarterOverQuarterPct": 23,
        "yearOverYearPct": 0
      },
      "cpcUsd": 0.88,
      "competition": 0.94,
      "competitionLevel": "HIGH",
      "lowTopOfPageBidUsd": 0.2,
      "highTopOfPageBidUsd": 1.11,
      "keywordDifficulty": 0,
      "searchIntent": "transactional",
      "googleDataSource": "dataforseo_labs_google",
      "googleDataUpdatedAt": "2026-10-17 15:09:49 +00:00",
      "googleStatus": "ok",
      "checkedAt": "2026-10-25T21:11:26Z"
    }
  ],
  "meta": {
    "keywordsRequested": 2,
    "keywordsValid": 2,
    "keywordsWithData": 2,
    "skippedInputs": [],
    "location": "United States",
    "locationCode": 2840,
    "language": "en",
    "creditsCharged": 8,
    "dataSource": "dataforseo_labs_google",
    "disclaimer": "Search volumes are third-party estimates (DataForSEO: Google Ads-based keyword database and Amazon search-volume model), rounded and averaged monthly."
  }
}
```
#### 2. Google Search Volume (Bulk)

Returns the same fields as the Google Search Volume endpoint for up to 100 keywords in one call. Costs 35 credits per call, so use the endpoint above for 10 keywords or fewer.

**Method:** `POST`

**Endpoint:** `/v1/keywords/google-volume/bulk`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| keywords | body | List of keywords, up to 80 characters and 10 words each. Case and spacing are normalised and duplicates are looked up once. | array of strings | Yes | - | 100 |
| location | body | Country name, 2-letter code (`US`, `GB`, `DE`) or DataForSEO location code (`2840`). 94 countries. | string | No | United States | - |
| language | body | Language code or name. Defaults to English where available, otherwise the country's main language. | string | No | - | - |
| trendMonths | body | How many months of history to return. | integer | No | 12 | 48 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/vncnt-labs/keyword-volume-api/v1/keywords/google-volume/bulk' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"keywords": ["coffee mug", "teacher gift"], "location": "United States"}'
```

**Example Response (200 OK, trimmed):**

Only the first keyword is shown and `googleMonthlySearches` is cut to 3 months.

```json
{
  "ok": true,
  "provider": "VNCNT Labs",
  "results": [
    {
      "type": "keyword",
      "keyword": "coffee mug",
      "inputKeyword": "coffee mug",
      "location": "United States",
      "locationCode": 2840,
      "language": "en",
      "googleSearchVolume": 60500,
      "googleMonthlySearches": [
        {
          "month": "2026-09",
          "searchVolume": 60500
        },
        {
          "month": "2026-08",
          "searchVolume": 49500
        },
        {
          "month": "2026-07",
          "searchVolume": 40500
        }
      ],
      "googleTrend": {
        "monthOverMonthPct": 22,
        "quarterOverQuarterPct": 49,
        "yearOverYearPct": 22
      },
      "cpcUsd": 1.06,
      "competition": 1,
      "competitionLevel": "HIGH",
      "lowTopOfPageBidUsd": 0.3,
      "highTopOfPageBidUsd": 2.78,
      "keywordDifficulty": 1,
      "searchIntent": "transactional",
      "googleDataSource": "dataforseo_labs_google",
      "googleDataUpdatedAt": "2026-10-16 13:11:35 +00:00",
      "googleStatus": "ok",
      "checkedAt": "2026-10-25T10:19:50Z"
    }
  ],
  "meta": {
    "keywordsRequested": 2,
    "keywordsValid": 2,
    "keywordsWithData": 2,
    "skippedInputs": [],
    "location": "United States",
    "locationCode": 2840,
    "language": "en",
    "creditsCharged": 35,
    "dataSource": "dataforseo_labs_google",
    "disclaimer": "Search volumes are third-party estimates (DataForSEO: Google Ads-based keyword database and Amazon search-volume model), rounded and averaged monthly."
  }
}
```
#### 3. Amazon Search Volume

Returns the estimated monthly Amazon search volume for 1 to 10 product keywords in one of 16 Amazon marketplaces. Costs 9 credits per call.

**Method:** `POST`

**Endpoint:** `/v1/keywords/amazon-volume`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| keywords | body | List of keywords, up to 80 characters and 10 words each. Case and spacing are normalised and duplicates are looked up once. | array of strings | Yes | - | 10 |
| marketplace | body | Amazon marketplace country: US, GB, DE, FR, IT, ES, NL, CA, MX, AU, IN, SG, AE, SA, EG or AT. | string | No | United States | - |
| language | body | Language code or name. Defaults to English where available, otherwise the country's main language. | string | No | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/vncnt-labs/keyword-volume-api/v1/keywords/amazon-volume' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"keywords": ["coffee mug"], "marketplace": "United States"}'
```

**Example Response (200 OK):**

```json
{
  "ok": true,
  "provider": "VNCNT Labs",
  "results": [
    {
      "type": "keyword",
      "keyword": "coffee mug",
      "inputKeyword": "coffee mug",
      "location": "United States",
      "locationCode": 2840,
      "language": "en",
      "amazonSearchVolume": 22926,
      "amazonStatus": "ok",
      "checkedAt": "2026-10-25T10:26:34Z"
    }
  ],
  "meta": {
    "keywordsRequested": 1,
    "keywordsValid": 1,
    "keywordsWithData": 1,
    "skippedInputs": [],
    "location": "United States",
    "locationCode": 2840,
    "language": "en",
    "creditsCharged": 9,
    "dataSource": "dataforseo_labs_amazon",
    "disclaimer": "Search volumes are third-party estimates (DataForSEO: Google Ads-based keyword database and Amazon search-volume model), rounded and averaged monthly."
  }
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the body holds the result. |
| 400 | Bad Request | The body is not valid JSON, `keywords` is missing or empty, or a keyword is longer than 80 characters or 10 words. |
| 401 | Unauthorized | The `x-api-market-key` header is missing, invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path does not exist under the base URL. |
| 429 | Too Many Requests | You sent more than 10 requests per second, or you used all 20 calls of the Basic plan. |
| 500 | Internal Server Error | Something failed on the provider side. Retry after a short delay. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

You can send up to 10 requests per second. Usage is counted in credits: 8 per Google call, 35 per Google bulk call and 9 per Amazon call. The Basic plan includes 20 credits; Pro includes 1,000 credits a month, Ultra 2,500 and Mega 5,000, with overage billed per credit on paid plans. Requests above the limit return `429 Too Many Requests`; throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **How many credits does a call use?**
    8 for `/v1/keywords/google-volume`, 35 for the bulk endpoint and 9 for Amazon. The `meta.creditsCharged` field in the response shows what a call cost.

*   **Which Google endpoint should I use?**
    Use `/v1/keywords/google-volume` for 10 keywords or fewer, it costs less. Use the bulk endpoint for 11 to 100 keywords.

*   **What happens when a keyword has no data?**
    It comes back with `googleStatus` or `amazonStatus` set to `no_data`. If no keyword in the call has data, the call costs 0 credits.

*   **Are the volumes exact?**
    No. Like every keyword tool, they are third-party estimates, rounded and averaged monthly.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Google search volume, CPC, competition, difficulty and 12-month trends for up to 100 keywords per call, plus Amazon search volume in 16 marketplaces.

Keyword Search Volume API: Google & Amazon

Basic

VNCNT Labs

Ultra

Mega

Google monthly search volume, CPC, competition and 12-month trend for up to 100 keywords per call, plus Amazon search volume. Licensed data, no scraping.