IP Demographics API

Overview

To use IP Demographics, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

https://api.apiverve.com/v1/ipdemographics

Example

How to call the IP Demographics API in different programming languages.

curl -X GET \
  "https://api.apiverve.com/v1/ipdemographics?ip=173.172.81.20" \
  -H "X-API-Key: your_api_key_here"

const response = await fetch('https://api.apiverve.com/v1/ipdemographics?ip=173.172.81.20', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/ipdemographics?ip=173.172.81.20', headers=headers)

data = response.json()
print(data)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/ipdemographics?ip=173.172.81.20", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

{
  "status": "ok",
  "error": null,
  "data": {
    "ip": "8.8.8.8",
    "location": {
      "zip": "94043",
      "city": "Mountain View",
      "state": "California",
      "stateCode": "CA",
      "country": "United States",
      "countryCode": "US",
      "latitude": 37.4056,
      "longitude": -122.0775,
      "timezone": "America/Los_Angeles"
    },
    "demographics": {
      "population": 81234,
      "medianAge": 34.5,
      "medianHouseholdIncome": 142567,
      "perCapitaIncome": 78234,
      "medianHomeValue": 1875000,
      "collegeEducatedPct": 68.3,
      "unemploymentRate": 3.2,
      "homeOwnershipRate": 45.6
    },
    "acsYear": 2022,
    "formatted": {
      "medianHouseholdIncome": "$142,567",
      "perCapitaIncome": "$78,234",
      "medianHomeValue": "$1,875,000"
    }
  }
}

Authentication

The IP Demographics API requires authentication via API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the IP Demographics API directly in your browser with live requests and responses.

Parameters

The following parameters are available for the IP Demographics API:

Response

The IP Demographics API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <ip>8.8.8.8</ip>
    <location>
      <zip>94043</zip>
      <city>Mountain View</city>
      <state>California</state>
      <stateCode>CA</stateCode>
      <country>United States</country>
      <countryCode>US</countryCode>
      <latitude>37.4056</latitude>
      <longitude>-122.0775</longitude>
      <timezone>America/Los_Angeles</timezone>
    </location>
    <demographics>
      <population>81234</population>
      <medianAge>34.5</medianAge>
      <medianHouseholdIncome>142567</medianHouseholdIncome>
      <perCapitaIncome>78234</perCapitaIncome>
      <medianHomeValue>1875000</medianHomeValue>
      <collegeEducatedPct>68.3</collegeEducatedPct>
      <unemploymentRate>3.2</unemploymentRate>
      <homeOwnershipRate>45.6</homeOwnershipRate>
    </demographics>
    <acsYear>2022</acsYear>
    <formatted>
      <medianHouseholdIncome>$142,567</medianHouseholdIncome>
      <perCapitaIncome>$78,234</perCapitaIncome>
      <medianHomeValue>$1,875,000</medianHomeValue>
    </formatted>
  </data>
</response>

status: ok
error: null
data:
  ip: 8.8.8.8
  location:
    zip: '94043'
    city: Mountain View
    state: California
    stateCode: CA
    country: United States
    countryCode: US
    latitude: 37.4056
    longitude: -122.0775
    timezone: America/Los_Angeles
  demographics:
    population: 81234
    medianAge: 34.5
    medianHouseholdIncome: 142567
    perCapitaIncome: 78234
    medianHomeValue: 1875000
    collegeEducatedPct: 68.3
    unemploymentRate: 3.2
    homeOwnershipRate: 45.6
  acsYear: 2022
  formatted:
    medianHouseholdIncome: $142,567
    perCapitaIncome: $78,234
    medianHomeValue: $1,875,000

Response Structure

All API responses follow a consistent structure with the following fields:

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access IP Demographics through GraphQL to combine it with other API calls in a single request. Query only the ip demographics data you need with precise field selection, and orchestrate complex data fetching workflows.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

POST https://api.apiverve.com/v1/graphql

query {
  ipdemographics(
    input: {
      ip: "173.172.81.20"
    }
  ) {
    ip
    location {
      zip
      city
      state
      stateCode
      country
      countryCode
      latitude
      longitude
      timezone
    }
    demographics {
      population
      medianAge
      medianHouseholdIncome
      perCapitaIncome
      medianHomeValue
      collegeEducatedPct
      unemploymentRate
      homeOwnershipRate
    }
    acsYear
    formatted {
      medianHouseholdIncome
      perCapitaIncome
      medianHomeValue
    }
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

CORS Support

The IP Demographics API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

IP Demographics requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The IP Demographics API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for IP Demographics

Official IP Demographics packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

IP Demographics works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

People who used this also used...

Based on your interest in IP Demographics, you might also like these APIs:

ZIP Demographics

ZIP Demographics provides detailed demographic data for any US ZIP code including population, income, education, housing, employment, and racial composition from the US Census American Community Survey.

5 credits per call

World Time

World Time is a simple tool for getting the current time in any city. It returns the current time, date, and more.

1 credit per call

Unicode Character Lookup

Unicode Character Lookup is a tool for retrieving detailed information about Unicode characters. It provides codepoint, UTF-16 encoding, category, and emoji name information.

1 credit per call