Mangools/API

Add new list

Create a new keyword list on your account.

Required fields:

  • name — list name
  • keyword_ids — array of keyword IDs to populate the list (may be empty to create an empty list)

Keyword IDs typically come from previous KWFinder lookups such as /kwfinder/related-keywords or /kwfinder/keyword-imports. Creating more lists than your plan allows returns HTTP 400.

POST
/kwfinder/lists

Authorization

ApiKeyAuth
x-access-token<token>

Your Mangools API key

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

body?unknown

Response Body

application/json

curl -X POST "https://api.mangools.com/v3/kwfinder/lists" \  -H "Content-Type: application/json" \  -d '{    "keyword_ids": [      "string"    ],    "name": "string"  }'
{
  "name": "My Awesome Keyword List",
  "user_id": "005de7e7771450763339653e918778ef",
  "keyword_ids": [
    "005de7e7771450763339653e918778ef",
    "005de7e7771450763339653e918778ef"
  ],
  "created_at": 1590868935
}