Skip to main content
POST
Cancel Keyword List

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Scopes

query

Path Parameters

brand_id
integer
required
list_id
integer
required

The keyword list's id, from Start Keyword List

Response

Successful Response

A keyword list: its status and progress, without the per-keyword results.

id
integer
required

The list's id.

status
enum<string>
required

queued (waiting to start), running, finished, failed (stopped early; unused lookups were given back) or canceled.

Available options:
queued,
running,
finished,
failed,
canceled
country
string
required

The country the estimates are for. Always US today.

item_count
integer
required

How many keywords are on the list, after repeats and blanks are dropped.

counts
KeywordBulkCounts · object
required

How many of the list's keywords are in each status.

created_at
string<date-time>
required

When the list was started.

started_at
string<date-time> | null
required

When it began running. Null while it's queued.

finished_at
string<date-time> | null
required

When it ended. Null while it's queued or running.