v1

Remove keywords from a Niche's Master Keyword List

Changed on

Undoes an add, by where each keyword came from:

  • removedManual — added by hand; deleted from the Niche.
  • sentBackToOutliers / sentBackToResidue — moved in from Outliers or Residue; listed there again, with their data kept.
  • notRemovable — found by the Dive itself, or not in the Niche; left unchanged.

Free. Removing a keyword right after adding it leaves the Niche settings exactly as they were.

Rate limited to 2 requests per minute per Niche.

post/v1/niches/{nicheId}/keywords/remove

Request

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

Path parameters

nicheIdstring required

The unique identifier of the Niche

Request body

keywordsstring[] required

Keywords to take out of the Niche's Master Keyword List, 100 at most and 255 characters each. They are lower-cased and trimmed and must be unique after that; blank entries are ignored.

Example request

{
  "keywords": [
    "paint by numbers for adults"
  ]
}

Response

messagestring

Example response

{
  "data": {
    "removedManual": [
      "paint by numbers for adults"
    ],
    "sentBackToOutliers": [],
    "sentBackToResidue": [],
    "notRemovable": [
      "diamond painting kits"
    ]
  }
}

Changes