Skip to main content
By the end of this page you’ll have a working key and a script that reads the last 30 days of visibility for one of your brands.

Before you start

  • You’re the owner of the workspace or an integration admin. Other members can see the key list but can’t create keys. See Team and roles.
  • The workspace has at least one brand with tracking data.

Make your first calls

1

Create a key

  1. In Quotable, open Settings → API keys and select Create API key.
  2. Under Scope, choose Brand for the brand you’re working in, or Workspace for every brand you can access.
  3. Name the key after the integration that will use it, for example Looker dashboard, and select Create key.
  4. Copy the key. This is the only time Quotable shows it.
If Quotable asks you to sign in again or confirm your authenticator code, that’s expected: creating a key requires a recent sign-in.
Store the key in an environment variable so the examples below can read it:
2

Check the key

GET /me works with any valid key and tells you what the key can do.
Response
project_ids: null means the key reads every brand. A list means it reads only those. expires_at: null means the key doesn’t expire.
3

List your brands

Response
Copy the id of the brand you want. The next call uses it as project_id.
4

Read daily visibility

Without from and to, you get the last 30 days ending today (UTC).
Response
Each point is one day with a tracking run, oldest first:
  • score is the visibility score, from 0 to 100.
  • mention_rate is the share of answers that mention the brand, from 0 to 1.
  • share_of_voice maps every brand named in answers to its share, from 0 to 1. The values sum to 1 whenever any brand is named.
Days without a tracking run are absent, so a 30-day range can return fewer than 30 points.

Check the response headers

Add -i to any cURL call to see the headers that come back with every successful response:

Next steps

Authentication

Scopes, brand access, expiry and safe revocation.

Pagination

Walk every page of prompts, citations, articles and demand terms.

Weekly visibility trend

Turn the visibility series into a week-over-week trend.
Last modified on November 18, 2026