---
url: "https://apidocs.mangools.com/kwfinder/post-keyword-imports/"
title: "Get details for a set of keywords | Mangools API Documentation"
---

[KWFinder](https://apidocs.mangools.com/kwfinder/)

# Get details for a set of keywords

This is one of the most powerful endpoints in our API. You can import your own keyword set with up to 700 keywords in one request.

With this endpoint, you will get the following details for each keyword:

- Cached Keyword SEO difficulty (rank)
- CPC, PPC
- Search volume history
- Average search volume (last 12 months - as `sv` attribute)
- Organic SERP results and CTRs

### [Limits](https://apidocs.mangools.com/kwfinder/post-keyword-imports/\#limits)

Each request is counted towards to your **Keyword lookups** limit. Lookup is not counted if you make the identical request within 24 hours.

### [Locations](https://apidocs.mangools.com/kwfinder/post-keyword-imports/\#locations)

You can specify a location\_id to get localized search volumes and SERPs.

To get a list of supported locations, please refer to [this article](https://developers.google.com/adwords/api/docs/appendix/geotargeting).

### [How to send keywords](https://apidocs.mangools.com/kwfinder/post-keyword-imports/\#how-to-send-keywords)

To get data about set of keywords send them in the request body. Don't forget to include location and language ids. See the following example of request body:

```
{
   "keywords": [\
      "seo agency",\
      "seo",\
      "seo specialist"\
   ],
   "location_id": 21167,
   "language_id": 1000
 }
```

Server URL`https://api.mangools.com/v3`

POST

``/`kwfinder`/`keyword-imports`

Send

Authorization

Body

## [Authorization](https://apidocs.mangools.com/kwfinder/post-keyword-imports/\#authorization)

`ApiKeyAuth`

x-access-token<token>

Your Mangools API key

In: `header`

## [Request Body](https://apidocs.mangools.com/kwfinder/post-keyword-imports/\#request-body)

`application/json`

TypeScript Definitions

Use the request body type in TypeScript.

Copy

body?unknown

## [Response Body](https://apidocs.mangools.com/kwfinder/post-keyword-imports/\#response-body)

### 200  `application/json`

cURL

JavaScript

Go

Python

Java

C#

```
curl -X POST "https://api.mangools.com/v3/kwfinder/keyword-imports" \
  -H "x-access-token: " \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": [\
      [\
        "seo agency",\
        "seo",\
        "seo specialist"\
      ]\
    ],
    "location_id": 21167,
    "language_id": 1000
  }'
```

200

```
{
  "language": {
    "code": "en",
    "label": "English",
    "_id": 1000
  },
  "location": {
    "_id": 1000,
    "name": "string",
    "country_code": "string",
    "canonical_name": "string",
    "code": "us",
    "label": "New York,United States",
    "google_domain": "string",
    "type": "string"
  },
  "keywords": [\
    {\
      "_id": "11e2a4ff072b3f6394dfb602dcea80c3",\
      "kw": "seo agency",\
      "lid": 21167,\
      "sv": 21167,\
      "svs": 21167,\
      "cpc": 21167,\
      "ppc": 21167,\
      "svn": 530,\
      "msv": [\
        2015,\
        8,\
        590\
      ],\
      "ts": 1617710810,\
      "seo": null,\
      "seo_ts": null\
    }\
  ],
  "countKeywordsBeforeLimit": 500
}
```

[Get list of keywords for domain or URL (POST variant)POST\\
\\
Previous Page](https://apidocs.mangools.com/kwfinder/post-competitor-keywords/) [Get keyword detailsGET\\
\\
Next Page](https://apidocs.mangools.com/kwfinder/get-serps/)