IPinfo Places API

The IPinfo Places API identifies the real-world location associated with an IP address at the building level. It matches IP addresses observed on venue Wi-Fi networks to verified physical places such as hotels, airports, museums, stadiums, transit stations, and 30+ other categories.

• Place name: The name of the venue or building associated with the IP address. This information can be used to identify the brand of the business as well.
• Location category: One of 30+ standardized location tags (e.g., hotel, museum, airport).
• Network SSID: The Wi-Fi network name observed at the venue.
• Coordinates: The building-level latitude and longitude of the matched place.

IPinfo Places is currently in public beta. Access is available via API. Additional fields and data (including brand, building dimensions, polygon boundaries, BSSIDs, and last-seen date) are available for select use cases. Contact sales to discuss.

Quick Reference

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "IPinfo Places API Response",
  "description": "Schema for IPinfo Places API response",
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IP address being queried.",
      "example": "65.144.40.106"
    },
    "name": {
      "type": "string",
      "description": "The name of the venue or building associated with the IP address.",
      "example": "Museum of History and Industry (MOHAI)"
    },
    "category": {
      "type": "string",
      "description": "The location category tag for the venue.",
      "example": "museum"
    },
    "ssid": {
      "type": "string",
      "description": "The Wi-Fi network name (SSID) observed at the venue.",
      "example": "MOHAI-Guest"
    },
    "latitude": {
      "type": "number",
      "description": "The latitude coordinate of the matched place.",
      "example": 47.6275
    },
    "longitude": {
      "type": "number",
      "description": "The longitude coordinate of the matched place.",
      "example": -122.3367
    }
  }
}

Lookup an IP address

curl https://api.ipinfo.io/places/65.144.40.106?token=$TOKEN

{
  "ip": "65.144.40.106",
  "name": "Museum of History and Industry (MOHAI)",
  "category": "museum",
  "ssid": "MOHAI-Guest",
  "latitude": 47.6275,
  "longitude": -122.3367
}

curl https://api.ipinfo.io/places/12.11.109.230?token=$TOKEN

{
  "ip": "12.11.109.230",
  "name": "John F. Kennedy International Airport",
  "category": "airport",
  "ssid": "_Free JFK WiFi",
  "latitude": 40.6461,
  "longitude": -73.7843
}

Batch lookups

The Places API is supported in the batch endpoint, allowing you to combine Places lookups with other IPinfo data in a single request.

curl -X POST "https://api.ipinfo.io/batch?token=$TOKEN" \
  -H 'Content-Type: text/plain' \
  -d 'places/65.144.40.106
places/1.0.141.187'

{
  "places/65.144.40.106": {
    "ip": "65.144.40.106",
    "name": "Museum of History and Industry (MOHAI)",
    "category": "museum",
    "ssid": "MOHAI-Guest",
    "latitude": 47.6275,
    "longitude": -122.3367
  },
  "places/1.0.141.187": {
    "ip": "1.0.141.187",
    "name": "Blu Monkey Hub and Hotel Chanthaburi",
    "category": "hotel",
    "ssid": "BLU MONKEY",
    "latitude": 12.6385,
    "longitude": 102.0957
  }
}

Supported Categories

IPinfo Places currently supports 30+ location tags. The table below lists the available categories currently. Please go to our product page for a continuously updated list of places.

Additional Data (Available on Request)

For select use cases, we can provide additional points of interest and network-level metadata.