# GeoTargetly API

> Geo-targeting platform — create location-based short links (Geo Links) that resolve to different URLs by country, region, city, or IP. REST API, Bearer auth.

## Resources
- Geo Links: POST /v1/geo-links — create a short URL with per-country destination rules. GET /v1/geo-links — list all links. GET /v1/geo-links/:id — get one. PATCH /v1/geo-links/:id — update. DELETE /v1/geo-links/:id — trash.
- Custom Domains: attach your own domain (e.g. go.yourbrand.com) to Geo Links instead of the default gtly.ink slug.
- Tags: label and filter Geo Links. Create new tags inline or attach existing ones.

## Auth
Bearer token. Header: Authorization: Bearer <key>
Get a key at dashboard.geotargetly.com → API Access.

## Errors
- 401: missing or revoked API key — check dashboard.geotargetly.com → API Access
- 409: slug/path conflict — choose a different path
- 500: retry with backoff; if persists contact support@geotargetly.com

## Spec
https://api.geotargetly.com/v1/openapi.json

## Docs
https://api.geotargetly.com/v1/docs