Mangools/API

Export keywords into CSV file

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: Pay per click
  • 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.

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,
    "h": [
      [
        1300,
        5.24,
        20,
        33,
        1507733116,
        0.813559
      ]
    ]
  }
]
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}