Introduction

Welcome to the Geoptie API. The API gives you programmatic access to the same data and actions as the Geoptie dashboard: visibility across AI engines, the prompts you track, the citations behind each answer, competitor share of voice, recommendations, and content generation.

​

Who can use it

The API is available to Geoptie subscribers on an active or trialing plan. There is no free or anonymous tier. Keys are created in the dashboard under API keys, in the sidebar.

​

Versions

• v1 is current and stable, at https://api.geoptie.com/v1/.

We may add new fields to responses at any time, so ignore fields you do not recognise rather than treating them as errors. Breaking changes will ship as /v2 with 90 days’ notice.

​

Engines

Use these identifiers wherever an endpoint accepts an engine value. Seven engines are available, and each brand tracks any four of them. A brand’s current selection is returned on the brand object.

​

Conventions

• Authentication. A bearer token on every request. See Authentication.
• Pagination. List endpoints are cursor-based. See Pagination.
• Dates. ISO 8601, UTC. from is inclusive, to is exclusive, and omitting both gives the last 30 days.
• Errors. Standard HTTP status codes plus a stable error.code. See Errors.

​

Next steps

​

Need help

Email support@geoptie.com, including the X-Request-Id header from the response so we can find the exact request.