Mangools/API

Add new keywords to the list

Add one or more keywords to an existing keyword list.

Required field:

  • keyword_ids — non-empty array of keyword IDs

Duplicates are handled silently (an existing keyword is not added twice). Fails with HTTP 403 when adding would exceed the maximum number of keywords allowed per list. Returns HTTP 204.

POST
/kwfinder/lists/{list_id}/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

Path Parameters

list_id*string

list ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

keyword_ids*array<string>

Response Body

application/json

application/json

curl -X POST "https://api.mangools.com/v3/kwfinder/lists/string/keywords" \  -H "Content-Type: application/json" \  -d '{    "keyword_ids": [      "916647301d98e2ec41df257cbdf97ac0",      "916647301d98e2ec41df257cbdf97ac0"    ]  }'
Empty
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}
{
  "error": {
    "type": "Error",
    "message": "Tag not found"
  }
}