---
url: "https://apidocs.mangools.com/kwfinder/"
title: "KWFinder | Mangools API Documentation"
---

# KWFinder

Keyword research API — search volumes, keyword difficulty, trends, competitor keywords, and keyword lists.

KWFinder is Mangools' keyword research tool. The API gives you programmatic access to the same keyword data that powers the KWFinder app: search volumes, keyword difficulty scores, CPC, trend history, competitor keyword profiles, and long-tail suggestions.

## [What you can do](https://apidocs.mangools.com/kwfinder/\#what-you-can-do)

- **Discover keywords** — fetch related keyword suggestions for any seed keyword, filtered by location and language.
- **Analyze competitors** — pull the keyword profile of any competing domain or URL.
- **Import and score keywords** — submit your own keyword lists and get back metrics (volume, KD, CPC, trends).
- **Fetch SERP data** — retrieve the SERP results for a keyword to see who is ranking.
- **Analyze keyword gaps** — find keywords a competitor ranks for that you don't.
- **Manage keyword lists** — create, update, and delete saved keyword lists via API.

## [Authentication](https://apidocs.mangools.com/kwfinder/\#authentication)

All KWFinder endpoints require an API key passed as the `x-access-token` header. See [Authentication](https://apidocs.mangools.com/authentication/) for setup instructions.

## [Rate limits and credits](https://apidocs.mangools.com/kwfinder/\#rate-limits-and-credits)

Each keyword lookup counts against your **Keyword lookups** limit. Duplicate requests within 24 hours are not counted. Use the Get limits endpoint to check remaining credits programmatically.

## [Endpoints](https://apidocs.mangools.com/kwfinder/\#endpoints)

| Method | Endpoint | Path |
| --- | --- | --- |
| `GET` | [Get related keywords list](https://apidocs.mangools.com/kwfinder/get-related-keywords/) | `/kwfinder/related-keywords` |
| `GET` | [Get list of keywords for domain or URL](https://apidocs.mangools.com/kwfinder/get-competitor-keywords/) | `/kwfinder/competitor-keywords` |
| `POST` | [Get list of keywords for domain or URL (POST variant)](https://apidocs.mangools.com/kwfinder/post-competitor-keywords/) | `/kwfinder/competitor-keywords` |
| `POST` | [Get details for a set of keywords](https://apidocs.mangools.com/kwfinder/post-keyword-imports/) | `/kwfinder/keyword-imports` |
| `GET` | [Get keyword details](https://apidocs.mangools.com/kwfinder/get-serps/) | `/serpchecker/serps` |
| `GET` | [Get list of competitor domains](https://apidocs.mangools.com/kwfinder/get-competitor-domain/) | `/kwfinder/competitor-domain` |
| `GET` | [Get suggested keywords for URL](https://apidocs.mangools.com/kwfinder/get-suggested-keywords/) | `/kwfinder/suggested-keywords` |
| `POST` | [Export keywords into CSV file](https://apidocs.mangools.com/kwfinder/post-keywords/) | `/kwfinder/keywords` |
| `GET` | [Get history of lookups](https://apidocs.mangools.com/kwfinder/get-requests/) | `/siteprofiler/requests` |
| `GET` | [Get trends](https://apidocs.mangools.com/kwfinder/get-trends/) | `/kwfinder/trends` |
| `GET` | [Get url-metrics for url](https://apidocs.mangools.com/kwfinder/get-kd-url-metrics/) | `/kwfinder/kd/url-metrics` |
| `GET` | [Get KD lookup history](https://apidocs.mangools.com/kwfinder/get-kd-requests/) | `/kwfinder/kd/requests` |
| `POST` | [Keyword Gap Analysis](https://apidocs.mangools.com/kwfinder/post-gap-analysis/) | `/kwfinder/gap-analysis` |
| `GET` | [Get current and free limits](https://apidocs.mangools.com/kwfinder/get-limits/) | `/kwfinder/limits` |
| `GET` | [Get all lists](https://apidocs.mangools.com/kwfinder/get-lists/) | `/kwfinder/lists` |
| `POST` | [Add new list](https://apidocs.mangools.com/kwfinder/post-lists/) | `/kwfinder/lists` |
| `GET` | [Get items in List, filter by list ID](https://apidocs.mangools.com/kwfinder/get-lists-by-list-id/) | `/kwfinder/lists/{list_id}` |
| `PATCH` | [Update List name](https://apidocs.mangools.com/kwfinder/patch-lists-by-list-id/) | `/kwfinder/lists/{list_id}` |
| `DELETE` | [Remove custom list](https://apidocs.mangools.com/kwfinder/delete-lists-by-list-id/) | `/kwfinder/lists/{list_id}` |
| `POST` | [Add new keywords to the list](https://apidocs.mangools.com/kwfinder/post-lists-by-list-id-keyword/) | `/kwfinder/lists/{list_id}/keyword` |
| `DELETE` | [Remove keywords from the list](https://apidocs.mangools.com/kwfinder/delete-lists-by-list-id-keyword/) | `/kwfinder/lists/{list_id}/keyword` |
| `GET` | [Get list of all locations](https://apidocs.mangools.com/kwfinder/get-locations/) | `/mangools/locations` |
| `GET` | [Get detail of location](https://apidocs.mangools.com/kwfinder/get-locations-by-location/) | `/mangools/locations/{location}` |

[Errors\\
\\
HTTP status codes returned by the Mangools API and how to handle them.](https://apidocs.mangools.com/errors/) [Get related keywords listGET\\
\\
Next Page](https://apidocs.mangools.com/kwfinder/get-related-keywords/)

### On this page

[What you can do](https://apidocs.mangools.com/kwfinder/#what-you-can-do) [Authentication](https://apidocs.mangools.com/kwfinder/#authentication) [Rate limits and credits](https://apidocs.mangools.com/kwfinder/#rate-limits-and-credits) [Endpoints](https://apidocs.mangools.com/kwfinder/#endpoints)