[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# List keywords and ranks

> List the tracked keywords of one domain with current rank, change and landing page. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/accuranker/list_keywords

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

List the tracked keywords of one domain with current rank, change and landing page.

AccuRanker API: https://cotlet.dev/docs/api/accuranker.md

`GET https://cotlet.dev/api/v1/accuranker/domains/{domain_id}/keywords`

Access: read.

Returns the rows of the Keywords tab: keyword ID, keyword, search engine, device, location, current rank, change since the compare date, landing page URL and tags. Rows come in the order the tab shows them; follow next_cursor for the rest. A keyword with no rank yet has rank null.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `domain_id` | string | yes | Domain ID from list_domains. |
| `search` | string | no | Part of a keyword. |
| `tag` | string | no | Only keywords with this tag. |
| `search_engine` | string | no | Google, Bing, Baidu or YouTube. |
| `cursor` | string | no | next_cursor from the previous page; leave out for the first page. |

## Request

**cURL**

```bash
curl https://cotlet.dev/api/v1/accuranker/domains/domain_8c41d2/keywords \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("accuranker", "list_keywords", {"domain_id":"domain_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('accuranker', 'list_keywords', {"domain_id":"domain_8c41d2"});
```

**CLI**

```bash
cotlet call accuranker list_keywords --data '{"domain_id":"domain_8c41d2"}'
```

## Example response

```json
{
  "keywords": [
    {
      "keyword_id": "k_90311",
      "keyword": "rank tracking software",
      "search_engine": "Google",
      "device": "desktop",
      "location": "United States",
      "rank": 4,
      "change": 2,
      "landing_page": "https://acme-outdoors.com/pricing",
      "tags": [
        "pricing-pages"
      ]
    },
    {
      "keyword_id": "k_90312",
      "keyword": "keyword rank checker",
      "search_engine": "Google",
      "device": "mobile",
      "location": "United States",
      "rank": 7,
      "change": 5,
      "landing_page": "https://acme-outdoors.com/pricing/teams",
      "tags": []
    }
  ],
  "next_cursor": null
}
```

Previous: [List domains](https://cotlet.dev/docs/api/accuranker/list_domains.md)
Next: [Get keyword rank history](https://cotlet.dev/docs/api/accuranker/get_keyword_history.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.