What you get
- Endpoints for account, sites, site detail, findings, AI answers, score history and changes.
- Sites can be addressed by id or domain, e.g.
/sites/example.com. - Paging with
next_cursor, 120 requests per minute per key. - A versioned contract: within v1 fields are only added, never removed or renamed.
Before you start
- An OLAB Assist account on the Agency plan, signed in as the account owner.
- A tool that can send HTTP requests with a header (curl, Postman, your CRM, a script).
Set it up step by step
Create a key
Integrations → API keys: name it after the tool (e.g. “HubSpot sync”) and click Create key. Copy it now; it is shown only once.
Make your first request
Send the key in the
Authorizationheader. The example below lists your sites with their latest scores.Pick the data you need
Use
/sites/{site}for the full picture,/findingsfor issues,/answersfor AI answers and/historyfor scores over time. The full reference is in the developer docs.Schedule it
Run your import daily or after each
scan.completedwebhook, so you never poll more than needed.
curl https://api.olabassist.com/api/v1/sites \
-H "Authorization: Bearer olab_YOUR_KEY"Tips
- One key per integration: revoking it affects only that tool.
- Ignore fields you do not know. New ones are added over time and your code keeps working.
- For Google Sheets, an Apps Script with
UrlFetchAppand a daily trigger is enough.
Troubleshooting
| Problem | What to do |
|---|---|
| 401 Unauthorized | The key is missing, mistyped or revoked. The header must be: Authorization: Bearer olab_… |
| 403 API_NOT_IN_PLAN | The account is not on the Agency plan (or a trial ended). Upgrade and the same key works again. |
| 429 Too many requests | You passed 120 requests per minute. Wait for retryAfterSeconds and spread requests out. |
Questions
Can the API change data?
No. Version 1 is read-only.
Is there an SDK?
Not yet; the API is plain JSON over HTTPS and works from any language.
Can a team member create keys?
No, only the account owner can create and revoke keys.
Other integrations
Product names and logos belong to their owners. OLAB Assist is not affiliated with them.