← All tools Advanced · Developer API

REST API

Read and write your coverage, campaigns and analytics programmatically. Workspace-scoped, authenticated with API keys.

Your API keys

Authentication

Send your key as a Bearer token. Keys are workspace-scoped; write access needs a read & write key. Rate limit: 120 requests/minute.

curl https://brainoaid.com/api/v1/coverage \
  -H "Authorization: Bearer prlab_your_key_here"

Endpoints

All estimate fields (reach, views, impressions, CPM) are labelled as estimates in responses. Base URL: https://brainoaid.com/api/v1

Example: create coverage

curl -X POST https://brainoaid.com/api/v1/coverage \
  -H "Authorization: Bearer prlab_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://news.site/story","headline":"Our launch","publication":"The Site","estimated_views":50000,"campaign_cost":2000,"estimated_impressions":300000}'