Add keywords
Add keywords to a domain with search engine, locale, devices, location and tags.
POST https://cotlet.dev/api/v1/accuranker/domains/{domain_id}/keywords
write Confirm
Returns how many keywords were added and how many tracked keywords that makes, because AccuRanker counts a keyword once per country locale, search engine, device and location. Keywords AccuRanker refuses come back in rejected with a reason. This changes your plan usage and is undone by deleting the keywords. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| domain_id string required | string | Domain ID from list_domains. |
| keywords string[] required | string[] | Keywords to track. |
| search_engine string | string | Google, Bing, Baidu or YouTube. Leave out for the domain default. |
| country_locale string | string | Country and language as the locale picker names them, for example United States (English). Leave out for the domain default. |
| devices string[] | string[] | desktop, mobile or both. Leave out for the domain default. |
| location string | string | City or address; leave out for country-level data. |
| tags string[] | string[] | Static tags to put on every added keyword. |
Request
curl -X POST https://cotlet.dev/api/v1/accuranker/domains/48213/keywords \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords":["rank tracking software","keyword rank checker","seo rank tracker"],"search_engine":"Google","country_locale":"United States (English)","devices":["desktop","mobile"],"tags":["q4-launch"]}'result = client.call("accuranker", "add_keywords", {"domain_id":"48213","keywords":["rank tracking software","keyword rank checker","seo rank tracker"],"search_engine":"Google","country_locale":"United States (English)","devices":["desktop","mobile"],"tags":["q4-launch"]})const result = await cotlet.call('accuranker', 'add_keywords', {"domain_id":"48213","keywords":["rank tracking software","keyword rank checker","seo rank tracker"],"search_engine":"Google","country_locale":"United States (English)","devices":["desktop","mobile"],"tags":["q4-launch"]});cotlet call accuranker add_keywords --data '{"domain_id":"48213","keywords":["rank tracking software","keyword rank checker","seo rank tracker"],"search_engine":"Google","country_locale":"United States (English)","devices":["desktop","mobile"],"tags":["q4-launch"]}'Example response
{
"domain_id": "48213",
"added_keywords": 3,
"tracked_keywords_added": 6,
"search_engine": "Google",
"country_locale": "United States (English)",
"devices": [
"desktop",
"mobile"
],
"tags": [
"q4-launch"
],
"rejected": []
}