curl reference

Every endpoint, every shape, copy-paste ready. No SDK install required.

Brand check (quick)

bash

curl https://api.mentionsapi.com/v1/check \
  -H "Authorization: Bearer lvk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"mode":"quick","query":"best CRM","brand":"HubSpot"}'

Brand check (all live)

bash

curl https://api.mentionsapi.com/v1/check \
  -H "Authorization: Bearer lvk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"mode":"all_live","query":"best CRM","brand":"HubSpot"}'

Query discovery

bash

curl https://api.mentionsapi.com/v1/discover \
  -H "Authorization: Bearer lvk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"brand":"HubSpot","industry":"CRM","count":25}'

Brand compare

bash

curl https://api.mentionsapi.com/v1/compare \
  -H "Authorization: Bearer lvk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"best CRM","brand_a":"HubSpot","brand_b":"Salesforce"}'

Schedule a watch

bash

curl https://api.mentionsapi.com/v1/watch \
  -H "Authorization: Bearer lvk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"best CRM","brand":"HubSpot","mode":"quick","interval":"daily","webhook_url":"https://...","webhook_secret":"whsec_..."}'

Public health snapshot

bash

curl https://api.mentionsapi.com/v1/health

Account usage rollup

bash

curl https://api.mentionsapi.com/v1/usage?granularity=total \
  -H "Authorization: Bearer lvk_live_..."