API reference
Every endpoint in the Gensiv API, with parameters, responses and examples.
The Gensiv API is a read-only REST API. It returns JSON and uses standard HTTP status codes.
https://api.gensiv.com/v1Authenticate every request with an API key in the Authorization header. See Authentication.
curl https://api.gensiv.com/v1/brands \
-H "Authorization: Bearer $GENSIV_API_KEY"Endpoints
| Endpoint | Description |
|---|---|
GET /engines | AI engines and their slugs |
GET /brands | Brands in the workspace |
GET /brands/{brandId} | One brand |
GET /brands/{brandId}/competitors | Tracked competitors |
GET /brands/{brandId}/prompts | Tracked prompts |
GET /brands/{brandId}/metrics | Visibility metrics for a date range |
GET /brands/{brandId}/metrics/daily | Metrics per day, engine and company |
GET /brands/{brandId}/metrics/prompts | Metrics per prompt, lowest visibility first |
GET /brands/{brandId}/sources/domains | Most cited domains |
GET /brands/{brandId}/sources/urls | Most cited pages |
GET /brands/{brandId}/responses | Individual AI responses |
GET /brands/{brandId}/alerts | Visibility drops, competitor overtakes and new rival sources |
GET /brands/{brandId}/action-plans | Prompts lost to competitors, with action plans |
GET /brands/{brandId}/articles | AI-written articles |
GET /brands/{brandId}/articles/{articleId} | One article with Markdown, HTML, sources and JSON-LD |
GET /credits | AI writing credits left |
GET /brands/{brandId}/reddit/opportunities | Reddit threads |
OpenAPI
The full OpenAPI 3 specification is available at https://api.gensiv.com/v1/openapi.json. Import it into Postman, Insomnia or a code generator to get a client for your language.