Description

Returns cell tower information in response to four tower identifiers.

All data provided by the API is from OpenCellid, "The world's largest Open Database of Cell Towers". OpenCellid is maintained by Unwired Labs and released under a Creative Commons Attribution-ShareAlike 4.0 International License.

Giraffe Geo has added the column "dbupdated", which gives the date when the entry was last updated in Giraffe Geo's database.

Endpoint

https://api.giraffegeo.com/cellid

required parameters type description
mcc integer Mobile Country Code, for example 260 for Poland.
mnc integer For GSM, UMTS and LTE networks, this is the Mobile Network Code (MNC). For CDMA networks, this is the System IDentification number (SID).
lac integer Location Area Code (LAC) for GSM and UMTS networks. Tracking Area Code (TAC) for LTE networks. Network IDenfitication number (NID) for CDMA networks.
cellid integer Cell ID (CID) for GSM and LTE networks. UTRAN Cell ID / LCID for UMTS networks, which is the concatenation of 2 or 4 bytes of Radio Network Controller (RNC) code and 4 bytes of Cell ID. Base station IDentifier number (BID) for CDMA networks.
response field type description
radio string Network type. One of the strings GSM, UMTS, LTE or CDMA.
mcc integer Mobile Country Code, for example 260 for Poland.
mnc integer For GSM, UMTS and LTE networks, this is the Mobile Network Code (MNC). For CDMA networks, this is the System IDentification number (SID).
lac integer Location Area Code (LAC) for GSM and UMTS networks. Tracking Area Code (TAC) for LTE networks. Network IDenfitication number (NID) for CDMA networks.
cellid integer Cell ID (CID) for GSM and LTE networks. UTRAN Cell ID / LCID for UMTS networks, which is the concatenation of 2 or 4 bytes of Radio Network Controller (RNC) code and 4 bytes of Cell ID. Base station IDentifier number (BID) for CDMA networks.
unit integer Primary Scrambling Code (PSC) for UMTS networks. Physical Cell ID (PCI) for LTE networks. An empty value for GSM and CDMA networks.
lon double Longitude in degrees between -180.0 and 180.0
See changeable below. changeable=1: average of longitude values of all related measurements changeable=0: exact GPS position of the cell tower
lat double Latitude in degrees between -90.0 and 90.0
See changeable below. changeable=1: average of latitude values of all related measurements changeable=0: exact GPS position of the tower
range integer Estimate of cell range, in meters.
samples integer Total number of measurements assigned to the cell tower
changeable integer Defines if coordinates of the cell tower are exact or approximate.
See changeable below. changeable=1: the GPS position of the cell tower has been calculated from all available measurements changeable=0: the GPS position of the cell tower is precise - no measurements have been used to calculate it.
created integer The first time when the cell tower was seen and added to the OpenCellID database. A date in timestamp format: number of seconds since the UTC Unix Epoch of 1970-01-01T00:00:00Z For example 1409522613 is the timestamp for 2014-08-31T22:03:33Z.
updated integer The last time when the cell tower was seen and update. A date in timestamp format: number of seconds since the UTC Unix Epoch of 1970-01-01T00:00:00Z For example 1409522613 is the timestamp for 2014-08-31T22:03:33Z.
averageSignal integer Average signal strength from all assigned measurements for the cell. Either in dBm or as defined in TS 27.007 8.5 - both is accepted.
dbupdated date Last update date in the Giraffe Geo database. Updates are currently weekly.

Example python request

import requests
headers = {'x-api-key':'your_key'}
payload = {
        'mcc':250,
        'mnc':2,
        'lac':7839,
        'cellid':7394696
        }
s = requests.get('https://api.giraffegeo.com/celltower',headers=headers,params=payload)
s = s.json()

Response

{
"results": [
    {
    "updated": 1489724826,
    "created": 1467971032,
    "lon": 30.369644,
    "mcc": 250,
    "dbupdated": null,
    "lac": 7839,
    "averagesignal": 0,
    "range": 1000,
    "radio": "UMTS",
    "samples": 18,
    "wkb_geometry": null,
    "lat": 59.838257,
    "changeable": 1,
    "mnc": 2,
    "cellid": 7394696,
    "unit": 0
    }
    ]
}