Alerts
List alerts
Alerts raised for a brand, newest first: visibility drops, competitors overtaking the brand and new sources citing a rival.
Authorization
bearer AuthorizationBearer <token>
An API key from Settings → API keys in the Gensiv app.
In: header
Path Parameters
brandId*string
A brand id from GET /v1/brands.
Format
uuidQuery Parameters
type?string
Only alerts of this type.
Value in
- "visibility_drop"
- "competitor_overtake"
- "new_rival_source"
limit?number
Maximum number of alerts to return.
Range
1 <= value <= 100Default
25cursor?string
The nextCursor value from the previous page.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/alerts"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "type": "visibility_drop", "headline": "Rival Co overtook Acme in AI answers", "detail": "string", "competitor": "Rival Co", "domain": "newsource.io", "previous": 0, "current": 0, "detectedAt": "2019-08-24T14:15:22Z" } ], "nextCursor": "string"}