Heading API Reference
Complete reference for the Heading REST API
Programmatic access to properties, prompts, competitors, and visibility data. Authenticate with session cookies, get JSON responses.
Base URL
https://api.useheading.comAuthentication
All requests require a Better Auth session cookie:
curl https://api.useheading.com/properties \
-H "Cookie: better-auth.session_token=YOUR_SESSION_TOKEN"Resources
PropertiesCreate, read, update, and delete monitored propertiesPromptsManage monitoring prompts and bulk operationsVisibilityAccess visibility scores and chart dataTeamsTeam management and member roles
Status Codes
| Status | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Bad request — check your parameters |
401 | Unauthorized — authentication required |
403 | Forbidden — insufficient permissions |
404 | Not found |
422 | Validation error — check error details |
500 | Internal server error |
Rate Limits
- 60 requests/min per session
- Bulk operations count as a single request