{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"7abf30ec-ce00-40a2-8f04-bcbbee5fa38f","name":"Keyword.com Google SERP Tracker API v2","description":"# Welcome to the Keyword.com API Documentation!\n\nThe **Keyword.com API** empowers developers to programmatically access and manage keyword ranking data, giving you the same core functionality available in the Keyword.com interface. Whether you’re building an SEO tool, a content marketing platform, or a performance dashboard, our API delivers the data and insights needed to grow search visibility and drive traffic.\n\nThis documentation covers everything you need to get started:\n\n- Authentication using secure headers\n    \n- RESTful endpoints for managing projects and keywords\n    \n- Practical examples of requests and responses\n    \n- Tips for efficient, scalable integration\n    \n\n## **Getting Started**\n\nTo use the API, you’ll need an API token. If you don’t have one yet, create an account on [Keyword.com](https://keyword.com) and retrieve your token under **Settings >** [Account tab](https://app.keyword.com/settings/account).\n\nOnce authenticated, you can:\n\n- Retrieve project and keyword ranking data\n    \n- Add and delete keywords\n    \n- Trigger on-demand keyword refreshes\n    \n- Access custom shareable view links for reporting\n    \n- And more...\n    \n\nWith this API, you can integrate Keyword.com into your internal tools, automate SEO workflows, and scale your keyword tracking operations.\n\n## Authentication\n\nThe Keyword.com API uses **token-based authentication via HTTP headers** for secure access.\n\n### **Required Header**\n\nInclude the following header in all your API requests:\n\n```\nAuthorization: [api_token]\n\n ```\n\nExampe:\n\n``` bash\ncurl --location 'https://app.keyword.com/api/v2/groups/Apple/keywords/272678916' \\\n--header 'Authorization: Bearer [API_TOKEN]'\n\n ```\n\n### **API Token Types**\n\nThere are two types of tokens:\n\n- **Master API Token**\n    \n    Grants full access to your account, including all projects and administrative actions (e.g., add/remove keywords, manage users).\n    \n- **Project Auth Token + ViewKey**\n    \n    Provides access to a specific project. Useful when sharing data with third-party tools or restricting access.\n    \n\nKeep your API key and tokens secure, and do not share them with unauthorized users.\n\n### Making API Requests\n\nThe Keyword.com API follows a RESTful design, using standard HTTP methods:\n\n- GET to retrieve data\n    \n- POST to create resources\n    \n- PATCH to update data\n    \n- DELETE to remove resources\n    \n\nAll responses are returned in JSON format for easy integration.\n\nBy following this guide, you’ll be able to seamlessly embed Keyword.com’s capabilities into your product or workflow. Let’s get started!\n\n---\n\n# **Keyword Update Schedule**\n\nOne of the core benefits of using **Keyword.com** is that **you don’t need to manually run API requests to keep your keyword data fresh**—we handle that for you.\n\nWhen you add keywords to a project, they’re automatically queued for updates according to your plan. Our system continuously tracks and refreshes keyword rankings in the background, so you can focus on analysis and insights rather than data collection.\n\n#### Automatic Update Frequency\n\n| **Plan Type** | **Update Frequency** |\n| --- | --- |\n| Daily | Every 24 hours |\n| Weekly | Every 7 days |\n\n> **Example**: If you’re on a weekly plan and added keywords on a Wednesday, your keywords will automatically refresh every Wednesday between 00:00 and 12:00 UTC \n  \n\nJust keep in mind:\n\n- On-demand refreshes are limited based on your plan.\n    \n- They count separately from the automatic updates.\n    \n\nThis hybrid approach gives you both the **convenience of automation** and the **control of real-time updates** when you need them.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"26915172","team":6552093,"collectionId":"7abf30ec-ce00-40a2-8f04-bcbbee5fa38f","publishedId":"2s93eSabYB","public":true,"publicUrl":"https://documenter-api.postman.tech/view/26915172/2s93eSabYB","privateUrl":"https://go.postman.co/documentation/26915172-7abf30ec-ce00-40a2-8f04-bcbbee5fa38f","customColor":{"top-bar":"EDEEF0","right-sidebar":"303030","highlight":"0074D9"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/745a96a7-9d53-4f53-8ec0-d5cc962d5003/ZGFyay13aXRoIGNvbG9yIGxvZ28ucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"0074D9"}},{"name":"light","logo":"https://content.pstmn.io/02aef102-5326-4401-9c47-81a96b89099e/a2V5d29yZCBsb2dvIDMyMHB4LVcucG5n","colors":{"top-bar":"EDEEF0","right-sidebar":"303030","highlight":"0074D9"}}]}},"version":"8.10.1","publishDate":"2026-01-13T10:10:49.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/02aef102-5326-4401-9c47-81a96b89099e/a2V5d29yZCBsb2dvIDMyMHB4LVcucG5n","logoDark":"https://content.pstmn.io/745a96a7-9d53-4f53-8ec0-d5cc962d5003/ZGFyay13aXRoIGNvbG9yIGxvZ28ucG5n"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s93eSabYB"}