---
title: "Delete Keyword lists"
method: DELETE
path: "/management/keyword-lists"
tags: ["Management"]
---

# Delete Keyword lists

`DELETE /management/keyword-lists`

## Request

- Base URL: `https://api.ahrefs.com/v3`
- URL: `https://api.ahrefs.com/v3/management/keyword-lists`
- Auth: HTTP bearer

>Requests to this endpoint are free and do not consume any API units.

## Query parameters

- `keyword_list_ids` string, required
- `output` 'json' | 'php' | 'xml'

## Response `200`

OK

- ManagementKeywordLists
  - `keyword_lists` object[]
    - `access` 'private' | 'shared': The access type of the keyword list.
    - `countries` string[]: Up to 15 country codes to select when location is 'all'. Omit for all locations.
    - `folder_id` string, nullable: The ID of the keyword list's folder, if any.
    - `keyword_count` integer: The number of keywords in the list.
    - `keyword_list_id` string: The ID of the keyword list.
    - `location` 'all' | 'af' | 'al' | 'dz' | 'as' | 'ad' | 'ao' | 'ai' | 'ag' | 'ar' | 'am' | 'au' | 'at' | 'az' | 'bs' | 'bh' | 'bd' | 'by' | 'be' | 'bz' | 'bj' | 'bt' | 'bo' | 'ba' | 'bw' | 'br' | 'bn' | 'bg' | 'bf' | 'bi' | 'kh' | 'cm' | 'ca' | 'cv' | 'cf' | 'td' | 'cl' | 'co' | 'cg' | 'cd' | 'ck' | 'cr' | 'ci' | 'hr' | 'cy' | 'cz' | 'dk' | 'dj' | 'dm' | 'do' | 'ec' | 'eg' | 'sv' | 'ee' | 'et' | 'fj' | 'fi' | 'fr' | 'ga' | 'gm' | 'ge' | 'de' | 'gh' | 'gi' | 'gr' | 'gl' | 'gp' | 'gt' | 'gg' | 'gy' | 'ht' | 'hn' | 'hk' | 'hu' | 'is' | 'in' | 'id' | 'iq' | 'ie' | 'il' | 'it' | 'jm' | 'jp' | 'je' | 'jo' | 'kz' | 'ke' | 'ki' | 'kw' | 'kg' | 'la' | 'lv' | 'lb' | 'ls' | 'ly' | 'li' | 'lt' | 'lu' | 'mg' | 'mw' | 'my' | 'mv' | 'ml' | 'mt' | 'mu' | 'mx' | 'fm' | 'md' | 'mn' | 'me' | 'ms' | 'ma' | 'mz' | 'mm' | 'na' | 'nr' | 'np' | 'nl' | 'nz' | 'ni' | 'ne' | 'ng' | 'nu' | 'mk' | 'no' | 'om' | 'pk' | 'ps' | 'pa' | 'pg' | 'py' | 'pe' | 'ph' | 'pn' | 'pl' | 'pt' | 'pr' | 'qa' | 'ro' | 'ru' | 'rw' | 'sh' | 'vc' | 'ws' | 'sm' | 'st' | 'sa' | 'sn' | 'rs' | 'sc' | 'sl' | 'sg' | 'sk' | 'si' | 'sb' | 'so' | 'za' | 'kr' | 'es' | 'lk' | 'sr' | 'se' | 'ch' | 'tw' | 'tj' | 'tz' | 'th' | 'tl' | 'tg' | 'tk' | 'to' | 'tt' | 'tn' | 'tr' | 'tm' | 'ug' | 'ua' | 'ae' | 'gb' | 'us' | 'uy' | 'uz' | 'vu' | 've' | 'vn' | 'vg' | 'vi' | 'zm' | 'zw', nullable: The location of the keyword list. Specify a country code for one country, or 'all' for all locations. When using 'all', optionally provide 'countries' to restrict the list to selected countries. All locations and selections of multiple countries require Global Mode.
    - `name` string: The name of the keyword list.
    - `owned_by` string, nullable: The email of the keyword list owner, if available.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Error

## Changes

- **2026-10-20** `009fff8f64ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ahrefs/apis/ahrefs-api/changes/management/keyword-lists/delete.md)

---

[API](https://skmtc.dev/ahrefs/apis/ahrefs-api.md) - [All operations](https://skmtc.dev/ahrefs/apis/ahrefs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ahrefs/apis/ahrefs-api/revisions/667fedfff126?raw)