Help

Getting started

From sign-up to your first lookup in about five minutes.

Create an account

Go to app.geoiphub.com and click Create an account, or use Continue with Google. If you sign up with an email and password, open the link in the confirmation email before you sign in.

The Free plan gives you 1,500 lookups a day with every field included. No card needed.

Create an API key

Open API keys in the sidebar and click Create key. Name it after where it will run, like Production server, and copy it. The key is shown once. See API keys.

Make your first lookup

curl https://api.geoiphub.com/v1/lookup/8.8.8.8 \
  -H "x-api-key: YOUR_API_KEY"

The response is one JSON object with ten groups, from geo to scoring. See the API quickstart for JavaScript and Python.

Check it in the dashboard

Back on the Dashboard you'll see the request counted, how many lookups you have left today, and the country of the IP you looked up. See Your usage.

Upgrade when you need more

When 1,500 lookups a day isn't enough, choose a bigger plan in Billing. The response stays the same, only the volume changes. See Plans and billing.

On this page