GeoIP API

Getting started

Subscribe, copy your secret key, and run your first GeoIP lookup.

The Syndaq GeoIP API returns structured location and network metadata for any public IPv4 or IPv6 address. Responses are served from Syndaq's local database when possible, with automatic upstream enrichment for addresses that are not yet cached.

What you need

  1. A GeoIP plan from the Syndaq API catalog.
  2. A secret key (geo_sec_) from the Syndaq client area after your order is provisioned.

GeoIP lookups are server-side only. Send your secret key from your backend or trusted worker. Do not embed it in client-side code, mobile apps, or public repositories.

Base URL

All GeoIP endpoints are served from:

https://api.syndaq.com/v1/geoip/

Quick start

Replace geo_sec_YOUR_SECRET_KEY with the secret shown in Services for your GeoIP subscription.

curl -sS "https://api.syndaq.com/v1/geoip/lookup/8.8.8.8" \
  -H "Authorization: Bearer geo_sec_YOUR_SECRET_KEY"

You can also pass the IP as a query parameter:

curl -sS "https://api.syndaq.com/v1/geoip/lookup?ip=8.8.8.8" \
  -H "Authorization: Bearer geo_sec_YOUR_SECRET_KEY"

A successful response includes country, region, city, coordinates, timezone, ISP, ASN, and whether the address is in the EU.

How lookups work

StepWhat happens
1Your server sends a lookup request with your secret key.
2Syndaq checks an in-memory cache, then the local GeoIP database.
3If the IP is not stored yet, Syndaq enriches it from an upstream provider and saves the result for future requests.
4JSON is returned with a cached flag so you can tell cache hits from fresh enrichments.

Private, reserved, and invalid addresses return a clear error without billing an upstream lookup.

Manage your subscription

Sign in to the Syndaq client area and open Services. Select your GeoIP service to:

  • View usage and remaining monthly quota
  • Copy or rotate your secret key
  • Configure optional IP allowlists for API access

Next steps