DAdatadive
v1

Exclude keywords from a Niche's Master Keyword List

Changed on

Adds exact and phrase exclusions, the same way the web app does; the excluded keywords drop out of GET /v1/niches/{nicheId}/keywords at once. Only the exclusions change: every other Master Keyword List setting is kept.

Send 1 to 100 entries in total across exact and phrase. Entries already excluded are reported under unchanged, so repeating a call is safe. A Niche can have at most 1000 exclusions, exact and phrase combined. Free.

Rate limited to 30 requests per minute per Niche.

post/v1/niches/{nicheId}/keyword-exclusions

Request

  • Base URL
    https://api.datadive.tools
  • URL
    https://api.datadive.tools/v1/niches/{nicheId}/keyword-exclusions
  • Auth
    API key in header x-api-key

Path parameters

nicheIdstring required

The unique identifier of the Niche

Request body

exactstring[]

Exact exclusions: each hides the one keyword that matches it exactly. At most 255 characters each. Entries are lower-cased and trimmed and must be unique after that; blank entries are ignored.

phrasestring[]

Phrase exclusions: each hides every keyword that contains the phrase, as the web app does. At most 255 characters each. Entries are lower-cased and trimmed and must be unique after that; blank entries are ignored.

Example request

{
  "exact": [
    "dog hat"
  ],
  "phrase": [
    "puppy"
  ]
}

Response

messagestring

Example response

{
  "data": {
    "exact": [
      {
        "keyword": "dog hat",
        "searchVolume": 12345
      }
    ],
    "phrase": [
      {
        "phrase": "puppy",
        "searchVolume": 19586,
        "excludedKeywordsCount": 4
      }
    ],
    "added": {
      "exact": [
        "dog hat"
      ],
      "phrase": []
    },
    "unchanged": {
      "exact": [
        "dog hat"
      ],
      "phrase": []
    }
  }
}

Changes