Unwired Labs (incl. OpenCelliD) GEOLOCATION API
The GEOLOCATION API from Unwired Labs (incl. OpenCelliD) — 1 operation(s) for geolocation.
The GEOLOCATION API from Unwired Labs (incl. OpenCelliD) — 1 operation(s) for geolocation.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/unwired-labs:unwired-labs-geolocation-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: 2.0.0
title: GEOLOCATION API
description: Geolocation, Geocoding and Maps
servers:
- url: https://us1.unwiredlabs.com/v2
tags:
- name: GEOLOCATION
paths:
/process.php:
post:
operationId: Geolocation
summary: Geolocation
tags:
- GEOLOCATION
description: The Geolocation API helps developers locate IoT, M2M and other connected devices anywhere in the world without GPS. The device first sends the API data about which Cellular networks and WiFi networks it can see nearby. The API then uses Unwired Labs’ large datasets of Cell towers, WiFi networks backed by numerous algorithms to calculate and return the device’s location
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/geolocation_schema'
responses:
'200':
description: The response will be a JSON object as defined in the model.
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/geolocation_response_schema'
- $ref: '#/components/schemas/geolocation_error_schema'
components:
schemas:
cid_schema:
description: Cell ID
type: integer
format: int64
minimum: 0
maximum: 268435455
example: 17811
signalToNoiseRatio_schema:
description: The current signal to noise ratio, measured in dB (optional)
type: integer
format: int64
example: 1
fallback_schema:
title: fallback
description: An array of fallback options to enable or disable.
type: object
properties:
all:
$ref: '#/components/schemas/all_schema'
ipf:
$ref: '#/components/schemas/ipf_schema'
lacf:
$ref: '#/components/schemas/lacf_schema'
scf:
$ref: '#/components/schemas/scf_schema'
mcc_schema:
title: mcc
description: '"Mobile Country Code of your operator’s network represented by an integer (Optional). Range: 0 to 999."'
type: integer
format: int64
example: 310
ta_schema:
description: Timing Advance
type: integer
format: int64
minimum: 0
maximum: 63
example: 0
lac_schema:
description: the Location Area Code of your operator’s network.
type: integer
format: int64
minimum: 1
maximum: 65533
example: 7033
all_schema:
description: Enable or disable all fallbacks.
type: integer
format: int32
enum:
- 0
- 1
example: 1
psc_schema:
description: Primary Scrambling Code
type: integer
format: int64
minimum: 0
maximum: 503
example: 51
cell_schema:
title: cell
description: You can send 1 to 7 cell ID objects. If your device supports scanning for more than 7 cell objects, reach out to us and we’ll increase this limit on your account. The first cell object has to be that of the serving cell, i.e. the tower the device is connected to. The others are neighbouring cell objects that are visible to the device. Except lac and cid all other parameters mentioned below are optional. Parameters vary depending on the radio type. Supported radio types and their corresponding parameters are
type: object
properties:
lac:
$ref: '#/components/schemas/lac_schema'
cid:
$ref: '#/components/schemas/cid_schema'
radio:
$ref: '#/components/schemas/radio_schema'
mcc:
$ref: '#/components/schemas/mcc_schema'
mnc:
$ref: '#/components/schemas/mnc_schema'
signal:
$ref: '#/components/schemas/signal_schema'
psc:
$ref: '#/components/schemas/psc_schema'
asu:
$ref: '#/components/schemas/asu_schema'
ta:
$ref: '#/components/schemas/ta_schema'
geolocation_address_schema:
description: The physical address of the returned location
title: physical address
type: integer
format: int64
enum:
- 0
- 1
- 2
example: 1
scf_schema:
description: Enable Short CID fallback. Adds support for devices that can only see 16-bit (short) CID of an UMTS 28-bit UTRAN CID.
type: integer
format: int32
enum:
- 0
- 1
example: 0
geolocation_schema:
title: Geolocation
type: object
required:
- token
properties:
token:
$ref: '#/components/schemas/token_schema'
id:
$ref: '#/components/schemas/id_schema'
radio:
$ref: '#/components/schemas/radio_schema'
mcc:
$ref: '#/components/schemas/mcc_schema'
mnc:
$ref: '#/components/schemas/mnc_schema'
cells:
description: An array of cell ID objects
type: array
items:
$ref: '#/components/schemas/cell_schema'
wifi:
description: An array of WiFi objects visible to the device.
type: array
items:
$ref: '#/components/schemas/wifi_schema'
fallbacks:
$ref: '#/components/schemas/fallback_schema'
address:
$ref: '#/components/schemas/geolocation_address_schema'
ip:
$ref: '#/components/schemas/ip_schema'
bt:
$ref: '#/components/schemas/bt_schema'
signal_schema:
description: Signal Strength (RSSI)
type: integer
format: int64
minimum: -121
maximum: -25
example: -51
geolocation_response_schema:
title: Geolocation response
description: The response will be a JSON object as defined in the model.
properties:
status:
$ref: '#/components/schemas/status_schema'
message:
$ref: '#/components/schemas/message_schema'
balance:
type: integer
format: int64
description: This represents the remaining balance on the API token. Requests that return error are not charged and do not affect balance
example: 99585
balance_slots:
type: integer
format: int64
description: This represents the remaining balance of device slots. Requests that return error are not charged and do not affect balance. If -1 is returned, then observe it as an error while calculating slots balance. This element will only exist if you are on a device plan.
example: 2
lat:
type: number
format: double
description: The latitude representing the location
example: 39.56763197
lon:
type: number
format: double
description: The longitude representing the location
example: -105.00727917
accuracy:
description: The accuracy of the position is returned in meters
type: integer
format: int64
example: 10
address:
description: The physical address of the location
type: string
example: High Line Canal Trail, Littleton, CO 80120, USA
address_details:
$ref: '#/components/schemas/address_details_schema'
aged:
description: Shown when the location is based on a single measurement or those older than 90 days or is an LAC fallback
type: integer
format: int32
example: 0
fallback:
$ref: '#/components/schemas/fallback_schema'
channel_schema:
description: Channel the WiFi network is operating in (optional)
type: integer
format: int64
example: 11
bt_schema:
description: Specify level of strictness to apply to Borders
title: Border Threshold
type: integer
format: int32
enum:
- 0
- 1
- 2
default: 1
example: 1
mnc_schema:
title: mnc
description: 'Mobile Network Code of your operator’s network represented by an integer (Optional). Range: 0 to 999. On CDMA, provide the System ID or SID, with range: 1 to 32767.'
type: integer
format: int64
example: 404
radio_schema:
title: radio
description: Radio type of the device. Supported values are ‘gsm’, ‘cdma’, ‘umts’ and ‘lte’. This field should be included for more accurate results.
type: string
enum:
- '"gsm"'
- '"utms"'
- '"cdma"'
- '"lte"'
- '"nbiot"'
- '"nr"'
example: '"gsm"'
geolocation_error_schema:
title: geolocation error response
type: object
properties:
status:
$ref: '#/components/schemas/status_schema'
message:
$ref: '#/components/schemas/message_schema'
balance:
description: This represents the remaining balance on the API token. Requests that return error are not charged and do not affect balance.
type: integer
format: int64
example: 0
token_schema:
title: token
type: string
example: '"YOUR_API_TOKEN"'
id_schema:
description: ID of the device, in case you are in a per-device plan. This could be any unique string such as an IMEI, IMSI, phone number or a hash of any of the previous values, etc. Maximum accepted length is 20 chars, and values should only be alphanumeric (a-z, 0-9)
title: id
type: string
example: '"IMEI number"'
ip_schema:
description: IP address of device.
title: ip address
type: string
example: '"49.204.218.106"'
message_schema:
type: string
description: Any additional information from the server is returned here
example: '"INVALID_TOKEN"'
asu_schema:
description: Arbitrary Strength Unit
type: integer
format: int64
minimum: -5
maximum: 97
example: 56
wifi_schema:
title: wifi
description: You can send a minimum of 2 and a maximum of 15 WiFi objects in 1 request. If WiFi is not available, wifi object can be omitted all together. In accordance with our industry’s privacy standards we require a minimum of 2 valid nearby Access Points to be sent. If your use-case allows only 1 AP, reach out to us.
type: object
properties:
bssid:
$ref: '#/components/schemas/bssid_schema'
channel:
$ref: '#/components/schemas/channel_schema'
frequency:
$ref: '#/components/schemas/frequency_schema'
signal:
$ref: '#/components/schemas/signal_schema'
signalToNoiseRatio:
$ref: '#/components/schemas/signalToNoiseRatio_schema'
ipf_schema:
description: Enable IP address fallback. Specify IP address of the device in the “ip” field if it’s different from the device making the API call.
type: integer
format: int32
enum:
- 0
- 1
example: 1
lacf_schema:
description: Enable LAC fallback. If we are unable to locate a cell, we will return an approzimate location based on nearby cells in our database.
type: integer
format: int32
enum:
- 0
- 1
- 2
example: 1
status_schema:
title: status
description: If the request is successful, ok is returned. Otherwise error is returned
type: string
example: '"error"'
frequency_schema:
description: Frequency the WiFi network is operating in (MHz) (optional)
type: integer
format: int64
example: 2412
bssid_schema:
description: 'Basic Service Set Identifier or MAC address of the Access Point. Typical format of a MAC address is xx-xx-xx-xx-xx-xx. However, the delimiter can be any of these when sent to the API: : or - or .'
type: string
example: '"00:17:c5:cd:ca:aa"'
address_details_schema:
title: address_details
description: The API only returns components that have valid values for a location. Component town is normalized to city to make things simple
type: object
properties:
area:
type: string
example: '"5th Avenue"'
locality:
type: string
example: '"Korea Town"'
district:
type: string
example: '"Manhattan"'
county:
type: string
example: '"New York County"'
city:
type: string
example: '"New York City"'
state:
type: string
example: '"New York"'
country:
type: string
example: '"United States of America"'
country_code:
type: string
example: '"US"'
postal_code:
type: string
example: '"80120"'
securitySchemes:
token:
name: token
type: apiKey
in: query