All APIs Syndaq GeoIP

Data API

Know where traffic comes from—in milliseconds.

Look up any public IP for country, city, ISP, ASN, and coordinates. Responses are served from Syndaq's growing local database with automatic upstream enrichment when needed.

View plans See example

At a glance

  • 3 REST endpoints
  • JSON Request & response
  • HTTPS TLS required
  • Free tier available Starting price

Use cases

Where teams use Syndaq GeoIP

Fraud & risk scoring

Flag logins, payments, and signups from unexpected regions before they cost you.

Analytics enrichment

Attach location and network context to events, logs, and customer profiles.

Geo routing

Route users to the nearest support team, currency, or content locale.

Compliance & access

Apply regional policies with confidence using normalized country and EU flags.

Integration

Up and running in three steps

1

Get an API key

Subscribe to a GeoIP plan and copy your geo_sec_ secret key from the client area.

2

Call the lookup endpoint

Pass any public IPv4 or IPv6 address—by URL path or query parameter.

3

Use structured JSON

Receive normalized location, timezone, and connection fields ready for your app.

Example

Copy, paste, ship

Every response includes a request_id for support correlation. Rate limit and quota headers are returned on authenticated routes so you can backoff gracefully.

Authenticated with your secret key. Private and reserved IPs return a clear error without billing an upstream lookup.

Request
curl -s "https://api.syndaq.com/v1/geoip/lookup/8.8.8.8" \
  -H "Authorization: Bearer geo_sec_YOUR_SECRET_KEY"
Response
{
  "success": true,
  "ip": "8.8.8.8",
  "cached": true,
  "country": { "code": "US", "name": "United States" },
  "city": "Mountain View",
  "location": { "latitude": 37.386, "longitude": -122.084 },
  "connection": { "isp": "Google LLC", "asn": 15169, "type": "IPv4" },
  "is_eu": false,
  "request_id": "e6d04020be9b57b1e1069d6e483c0443"
}

Reference

API endpoints

Included with your Syndaq GeoIP plan.

Method Path Description
GET /v1/geoip/lookup Lookup geolocation by ?ip= query parameter.
GET /v1/geoip/lookup/{ip} Lookup geolocation for an IP in the URL path.
GET /v1/geoip/status Returns plan limits and quota for the authenticated key.

Pricing

Plans for every stage

Transparent limits. Upgrade when your traffic grows—no surprise overages without a plan change.

Starter

Free

Development and light production GeoIP lookups.

  • 120 requests / minute
  • 10,000 lookups / month
  • Secret key authentication
  • GeoIP JSON REST API
  • Local cache with upstream fallback
  • Rate limit & quota headers
Get started
Most popular

Developer

monthly
$29.00 USD

Higher throughput for production apps.

  • 600 requests / minute
  • 50,000 lookups / month
  • Secret key authentication
  • GeoIP JSON REST API
  • Local cache with upstream fallback
  • Rate limit & quota headers
Get started

Enterprise

monthly
$99.00 USD

High-volume GeoIP with priority limits.

  • 3,000 requests / minute
  • Unlimited monthly lookups
  • Secret key authentication
  • GeoIP JSON REST API
  • Local cache with upstream fallback
  • Rate limit & quota headers
Get started

FAQ

Common questions

Lookups hit Syndaq's local tblapi_geoip_data cache first. Missing IPs are enriched via ipwho.is, stored, and returned on subsequent requests.

Cached responses typically return in under 50ms. First-time lookups depend on upstream latency but are cached for repeat queries.

Yes. Plans include per-minute rate limits and monthly quotas with standard X-RateLimit and X-Quota response headers.

Ready to integrate Syndaq GeoIP?

Pick a plan, create your keys in the client area, and start calling the API in minutes.

Choose a plan Ask a question