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). A list holds up to 10,000 keywords; adding more answers HTTP 422 with type OutOfLimitException. 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"
  }
}