---
title: "List the discovered keyword suggestions"
method: GET
path: "/trackers/{id}/discoveries"
tags: ["Keyword discovery"]
---

# List the discovered keyword suggestions

`GET /trackers/{id}/discoveries`

## Request

- Base URL: `https://api.epovest.com/v1`
- URL: `https://api.epovest.com/v1/trackers/{id}/discoveries`
- Auth: HTTP bearer

The current suggestions, plus `dismissed`, the domains this tracker has set aside, so what
was refused stays readable and a change of mind is one call away. Nothing is ever added on
its own: relay the suggestions to the person, the decision is theirs.

## Response `200`

The suggestions and the domains set aside.

- object
  - `discoveries` KeywordDiscovery[], required
    - `domain` string, required
    - `sources` integer, required: How many times that domain appeared, recomputed on every read.
    - `keyword` string, required: The name the domain would be tracked under.
  - `dismissed` string[], required

## Other responses

- `401`: `unauthenticated`: missing, unknown or revoked key.
- `403`: `insufficient_scope`: the credential may not do this, either because the key lacks the scope, or, on a one-click connection, because the person lacks the role the action needs (manager, or owner to start, pause and top up). On that path, read it as "this person may not do this" and tell them which role the action needs.
- `404`: `not_found`: unknown for this account.
- `429`: `rate_limited`: 120 requests per minute per credential, sliding window. Retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/epovest/apis/epovest-api.md) · [All operations](https://skmtc.dev/epovest/apis/epovest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/epovest/apis/epovest-api/revisions/7a78ee27ecbb?raw)