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
- 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
KWFinder endpoints require an API key passed as the x-access-token header. The shared location lookups are the exception — they are public. See Authentication for setup instructions.
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.
Independently of the quota, a burst limit allows API-key clients 3 requests per 30 seconds per resource pool, so send lookups sequentially with at least 11 seconds between requests to the same pool (the 30-second window is inclusive at its edge) and on a 429 wait the returned retry_after seconds. See Rate limits.
Endpoints
| Method | Endpoint | Path | Quota |
|---|---|---|---|
GET | Get related keywords list | /kwfinder/related-keywords | Paid |
GET | Get list of keywords for domain or URL | /kwfinder/competitor-keywords | Paid |
POST | Get list of keywords for domain or URL (POST variant) | /kwfinder/competitor-keywords | Paid |
GET | Get list of competitor domains | /kwfinder/competitor-domain | Free |
GET | Get suggested keywords for URL | /kwfinder/suggested-keywords | Paid |
POST | Get details for a set of keywords | /kwfinder/keyword-imports | Paid |
GET | Get keyword details | /kwfinder/serps | Paid |
POST | Get keywords by ID as JSON, or as CSV with the .csv suffix | /kwfinder/keywords | Free |
GET | Get history of lookups | /kwfinder/requests | Free |
GET | Get trends | /kwfinder/trends | Paid |
GET | Get url-metrics for url | /kwfinder/kd/url-metrics | Paid |
GET | Get KD lookup history | /kwfinder/kd/requests | Free |
POST | Keyword Gap Analysis | /kwfinder/gap-analysis | Paid |
GET | Get current and free limits | /kwfinder/limits | Free |
GET | Get all lists | /kwfinder/lists | Free |
POST | Add new list | /kwfinder/lists | Free |
GET | Get items in List, filter by list ID | /kwfinder/lists/{list_id} | Free |
PATCH | Update List name | /kwfinder/lists/{list_id} | Free |
DELETE | Remove custom list | /kwfinder/lists/{list_id} | Free |
POST | Add new keywords to the list | /kwfinder/lists/{list_id}/keywords | Free |
DELETE | Remove keywords from the list | /kwfinder/lists/{list_id}/keywords | Free |
GET | Get list of all locations | /mangools/locations | Free |
GET | Get detail of location | /mangools/locations/{location} | Free |
Endpoints marked Paid consume your lookup quota on every successful call. Free endpoints do not.