IP Geolocation & Demographics API

Get instant insight on your website visitors

Turn any IP address into location, income, education, and household demographics with a single API call.

Get Your API Key Documentation →

Features

The real-time audience intelligence API

Go beyond basic IP lookups with detailed demographics, nearby cities, and low-latency delivery from the edge.

IP Geolocation

Resolve any IPv4 or IPv6 address to city, region, country, coordinates, timezone, and currency.

Demographic Data

Enrich every lookup with income, education, housing, employment, ethnicity, and 13+ demographic categories.

Nearby Cities

Get a proximity-ordered list of nearby cities for location-aware UIs and personalized landing pages.

React SDK

Drop in server and client components with hooks like useCity() and useIncome(). Built for the Next.js App Router.

Edge Speed

Receive sub-50ms responses from our global edge network. Cached requests are free for 15 minutes.

Field Selection

Request only the data you need to reduce payload size. Build your query in the API Playground.

Audience Intelligence

See the person behind the pageview

Advertisers have lost the ability to target by income, education, and homeownership. IP Beam restores that signal with every lookup, enriching your audience with detailed demographics without tracking individual users.

View demographic data →

San Francisco, CA

94105

Median Income $67,046

Bachelor's+ 42.1%

Homeownership 32.7%

Internet Access 91.4%

Pop. Density 72,033/mi²

Median Age 36.9

Unemployment 4.2%

Avg Commute 34.5 min

Poverty Rate 12.8%

Foreign Born 28.4%

Broadband 87.3%

Work From Home 18.6%

Median Income $67,046

Bachelor's+ 42.1%

Homeownership 32.7%

Internet Access 91.4%

Pop. Density 72,033/mi²

Median Age 36.9

Unemployment 4.2%

Avg Commute 34.5 min

Poverty Rate 12.8%

Foreign Born 28.4%

Broadband 87.3%

Work From Home 18.6%

San Francisco, CA

94105

$67,046 Median Income

42.1% Bachelor's+

32.7% Homeownership

91.4% Internet Access

72,033/mi² Pop. Density

36.9 Median Age

4.2% Unemployment

34.5 min Avg Commute

12.8% Poverty Rate

28.4% Foreign Born

87.3% Broadband

18.6% Work From Home

$67,046 Median Income

42.1% Bachelor's+

32.7% Homeownership

91.4% Internet Access

72,033/mi² Pop. Density

36.9 Median Age

4.2% Unemployment

34.5 min Avg Commute

12.8% Poverty Rate

28.4% Foreign Born

87.3% Broadband

18.6% Work From Home

Use Cases

Personalized experiences that drive conversions

See how developers use IP Beam to create smarter, more relevant experiences that turn visitors into customers.

Content Localization

Show city names, nearby locations, and local social proof to make every visitor feel like the page was built for them.

Personalized Pricing

Adjust pricing, discounts, or plan recommendations based on local household income and cost of living.

203.0.113.42

IP Beam API

city New York, NY

income High (>$100k)

housing Homeowner

age_range 35–44

Identity Verification

Flag suspicious activity by detecting mismatches between a user's claimed location and their actual IP location.

Audience Enrichment

Enrich every user with income, education, and housing data to build first-party audiences you can actually market to.

Integration

One request. Instant insight

Get integrated in minutes with our REST API or try the new React SDK.

app/layout.tsx

Server

import { IPBeamProvider } from '@ipbeam/react/server'
import { headers } from 'next/headers'

export default function Layout({ children }) {
  return (
    <IPBeamProvider
      apiKey={process.env.IPBEAM_API_KEY}
      headers={headers()}
    >
      {children}
    </IPBeamProvider>
  )
}

components/Banner.tsx

Client

import { useCity, useIncome } from '@ipbeam/react'

export function Banner() {
  const city = useCity()
  const income = useIncome()

  return (
    <p>
      Welcome from {city?.name}!
    </p>
  )
}

Terminal

REST API

curl https://api.ipbeam.com/v1/lookup/me \
  -H "Authorization: Bearer ipb_..."

# { "city": { "name": "San Francisco", ... }, ... }

Response

JSON

// loading your data...

lookup.js

REST API

const res = await fetch('https://api.ipbeam.com/v1/lookup/me', {
  headers: { 'Authorization': 'Bearer ipb_...' }
})

const data = await res.json()
console.log(data.city.name)  // "San Francisco"

Response

JSON

// loading your data...

lookup.py

REST API

import requests

res = requests.get(
  'https://api.ipbeam.com/v1/lookup/me',
  headers={'Authorization': 'Bearer ipb_...'}
)

data = res.json()
print(data['city']['name'])  # San Francisco

Response

JSON

// loading your data...

lookup.php

REST API

$opts = ['http' => [
  'header' => 'Authorization: Bearer ipb_...'
]];

$ctx = stream_context_create($opts);
$res = file_get_contents(
  'https://api.ipbeam.com/v1/lookup/me', false, $ctx
);

$data = json_decode($res, true);
echo $data['city']['name'];  // San Francisco

Response

JSON

// loading your data...

lookup.go

REST API

req, _ := http.NewRequest("GET",
  "https://api.ipbeam.com/v1/lookup/me", nil)
req.Header.Set("Authorization", "Bearer ipb_...")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

var data map[string]interface{}
json.NewDecoder(resp.Body).Decode(&data)
fmt.Println(data["city"].(map[string]interface{})["name"])  // San Francisco

Response

JSON

// loading your data...

lookup.js

REST API

$.ajax({
  url: 'https://api.ipbeam.com/v1/lookup/me',
  headers: { 'Authorization': 'Bearer ipb_...' },
  success: function(data) {
    console.log(data.city.name)  // "San Francisco"
  }
})

Response

JSON

// loading your data...

Want to explore the full API integration? View docs →

Testimonials

Trusted by developers and marketers

“We went from API key to production in a single sprint. One request gives us everything we need about a visitor.”

Sarah Lewis

backend developer

“We started personalizing landing pages by city and housing status. Conversion rates jumped 22% in the first month.”

James Parker

growth marketing lead

“The React SDK plugged right into our Next.js app. We were showing personalized content within minutes.”

Anika Reddy

software developer

“We finally have the demographic targeting that Meta took away. Now we build first-party audiences we own and control.”

David Kim

head of demand gen

“Millisecond responses and cached requests are free. We are scaling to millions of lookups without latency or runaway costs.”

Omar Ali

engineering manager

“Now we know the income profile of every user. We use it to personalize pricing and it’s been a game changer for our funnel.”

Laura Martinez

performance marketing manager

Comparison

The only API to combine location and demographics

See how IP Beam stacks up against traditional geolocation providers.

Other Geolocation APIs

Geolocation only, no demographics
No nearby city data
No SDK, manual fetch and parsing
No way to explore the API live
Full payload every time, no filtering
Variable latency, every request billed

Location and demographics in one call
Nearby cities ranked by proximity
React SDK with hooks for Next.js
API Playground to build and test queries
Field selection to reduce payload size
Edge responses, cached requests free

Pricing

Simple plans,
for every level of insight

Monthly Yearly 20% OFF

Starter

For developers getting started with IP geolocation.

$49 /month

Try Starter free for 7 days →

50,000 lookups per month
$2.00 per 1,000 lookups overage
Full IP geolocation
Field selection
API Playground
React SDK
1 API key
Email support

Pro

Recommended

Full audience intelligence for teams that need deeper insight.

$99 /month

Try Pro free for 7 days →

Everything in Starter, plus:
150,000 lookups per month
$1.00 per 1,000 lookups overage
Full demographics (13+ categories)
Nearby cities
5 API keys
Priority email support

Ultimate

Maximum volume and flexibility for high-traffic applications.

$149 /month

Try Ultimate free for 7 days →

Everything in Pro, plus:
300,000 lookups per month
$0.50 per 1,000 lookups overage
Unlimited API keys
Dedicated onboarding manager
Priority email & video support

FAQs

Questions developers and marketers ask us

How we handle data, accuracy, and billing.

How do you get demographic data from an IP?

We start by resolving the IP to a geographic location, then enrich it with demographic data for that specific area. The data is aggregated at the area level, not the individual, so you get powerful audience intelligence without collecting personal information.

Do you track or fingerprint individual users?

No. We do not use cookies, fingerprinting, or any form of individual tracking. We resolve the IP, return the data, and store nothing about the request. The demographic data describes the area, not the person.

How accurate is the geolocation data?

We update our geolocation and demographic databases daily. We aim to offer city-level accuracy for the majority of lookups. However, accuracy does vary by IP type. Residential broadband IPs resolve more precisely than mobile IPs on cellular networks.

How do cached requests work?

Every lookup is cached at the edge for 15 minutes. If the same IP is looked up again within that window, the response is served from cache instantly and does not count toward your monthly lookup limit. This means repeated lookups from the same visitor are completely free.

How does the 7-day free trial work?

Pick any plan and start your trial. You get full access to that plan’s features for 7 days. Your credit card is collected at signup but won’t be charged until the trial ends. Cancel anytime before day 7 and you won’t be billed.

What happens if I exceed my lookup limit?

Your API keys and integrations keep working. Overages are billed at the end of the month at your plan’s overage rate: $2.00, $1.00, or $0.50 per 1,000 lookups depending on your plan. No hard cutoffs, no downtime.

Start building with IP Beam

Get real-time audience intelligence from a single API call. Try it free for 7 days.

Get Your API Key →

Get instant insight on your website visitors

The real-time audience intelligence API

IP Geolocation

Demographic Data

Nearby Cities

React SDK

Edge Speed

Field Selection

See the person behind the pageview

Personalized experiences that drive conversions

Content Localization

Personalized Pricing

Identity Verification

Audience Enrichment

One request. Instant insight

Trusted by developers and marketers

The only API to combine location and demographics

Simple plans,for every level of insight

Questions developers and marketers ask us

Start building with IP Beam

Simple plans,
for every level of insight