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
- In Quotable, open Settings → API keys and select Create API key.
- Under Scope, choose Brand for the brand you’re working in, or Workspace for every brand you can access.
- Name the key after the integration that will use it, for example
Looker dashboard, and select Create key. - 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.
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
id of the brand you want. The next call uses it as project_id.4
Read daily visibility
Without Each point is one day with a tracking run, oldest first:
from and to, you get the last 30 days ending today (UTC).Response
scoreis the visibility score, from 0 to 100.mention_rateis the share of answers that mention the brand, from 0 to 1.share_of_voicemaps every brand named in answers to its share, from 0 to 1. The values sum to 1 whenever any brand is named.
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.