Help
Schedule & API Access
When does data update?
Achtung.app collects and refreshes data automatically. Here's what to expect:
| Frequency | What gets updated |
|---|---|
| Daily | AI citation checks, scores, competitor benchmarks, alerts, news monitoring |
| Weekly | SERP rankings, competitor profiles, content suggestions, AI strategic insights |
| Monthly | Keyword suggestions, keyword prioritisation, local competitor discovery, PDF reports |
All daily jobs finish in the morning (Europe/Berlin time). If you're expecting fresh data later in the day and it isn't there, give it until midday before checking again.
API access (v1)
A stable REST API is available on Pro and Enterprise plans if you want to pull brand data into your own tools, BI dashboards, or reports.
Authentication
- Go to Settings → API Tokens in the admin panel.
- Click Create token, give it a recognisable name, and copy the value. We only show it once.
- Send it on every request as a bearer token:
Authorization: Bearer <your-token>
Tokens default to the brand:read ability. Revoke any token at any time from the same page; the application using it loses access immediately.
Endpoints
| Method | Path | Returns |
|---|---|---|
| GET | /api/v1/brands |
All brands your team owns |
| GET | /api/v1/brands/{id}/scores |
Monthly GEO scores for the brand |
| GET | /api/v1/brands/{id}/keywords |
Tracked keywords with current rank |
| GET | /api/v1/brands/{id}/reports |
PDF reports with signed download URLs |
All responses are JSON. Errors follow the shape { "error": "<message>" } with the appropriate HTTP status (401 unauthenticated, 403 feature not on plan, 404 brand not found, 429 throttled).
Rate limits
- 60 requests per minute per authenticated user across all v1 endpoints.
- A separate 3 requests per hour per IP applies to the unauthenticated free preview token issuance at
POST /api/v1/tokens.
Throttled responses include the standard Retry-After header.
Stability guarantee
The v1 namespace is stable. We will only add fields, never remove or rename them. Breaking changes will be published as v2 with a deprecation window on v1.
Base URL
https://achtung.app/api/v1
Start tracking
Want to see this for your own brand?
Achtung.app measures AI visibility for any brand, daily. Free check available — no credit card required.
Free check →Looking for the measurement methodology? See the methodology page.