Mangools/API

Get keywords by ID as JSON, or as CSV with the .csv suffix

fields can be used to filter columns you wish to include in the export. possible values include:

  • kw: Keyword
  • sv: Avg. Search Volume
  • lid: Location
  • cpc: Cost per click
  • ppc: PPC competition (0-100)
  • seo: Keyword difficulty
  • msv: Monthly Search Volume

Prerequisites

The keyword_ids are Mangools-specific identifiers returned by keyword-producing endpoints — call one of /kwfinder/keyword-imports, /kwfinder/related-keywords, /kwfinder/competitor-keywords, /kwfinder/suggested-keywords, or /kwfinder/serps first and reuse the _id values (or mId for SERP items). IDs that do not correspond to known keywords are silently dropped from the response.

The response is a JSON array of keyword objects. Posting to /kwfinder/keywords.csv instead returns the same data as a text/csv attachment.

At most 10,000 keyword IDs per request.

POST
/kwfinder/keywords

Authorization

ApiKeyAuth
x-access-token<token>

API token issued for your Mangools account, sent as an API key in the x-access-token HTTP header. This is NOT a standard RFC 6750 Authorization: Bearer <token> header. Auto-generated clients should be configured to send the token in x-access-token accordingly.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://api.mangools.com/v3/kwfinder/keywords" \  -H "Content-Type: application/json" \  -d '{    "keyword_ids": [      "916647301d98e2ec41df257cbdf97ac0",      "916647301d98e2ec41df257cbdf97ac0"    ]  }'
[
  {
    "_id": "005de7e7771450763339653e918778ef",
    "cpc": 0.813559,
    "kw": "seo solutions",
    "lid": 0,
    "msv": [
      [
        2015,
        8,
        590
      ]
    ],
    "ppc": 15,
    "seo": 13,
    "seo_ts": 1590868935,
    "sv": 930,
    "svn": 930,
    "svs": 0,
    "ts": 1592997076,
    "language": {
      "code": "en",
      "label": "English",
      "_id": 1000
    },
    "location": {
      "_id": 2703,
      "label": "Slovakia",
      "code": "us"
    }
  }
]
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}