Location is a JSON Structure definition published by Censys, describing 10 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/censys/refs/heads/main/json-structure/platform-location-structure.json",
"name": "Location",
"description": "Location schema from Censys Platform API",
"type": "object",
"additionalProperties": false,
"properties": {
"city": {
"type": "string",
"description": "The English name of the detected city."
},
"continent": {
"type": "string",
"description": "The English name of the detected continent (North America, Europe, Asia, South America, Africa, Oceania, Antarctica)."
},
"coordinates": {
"description": "The estimated coordinates of the detected location.",
"$ref": "#/components/schemas/Coordinates"
},
"country": {
"type": "string",
"description": "The English name of the detected country."
},
"country_code": {
"type": "string",
"description": "The detected two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...)."
},
"postal_code": {
"type": "string",
"description": "The postal code (if applicable) of the detected location."
},
"province": {
"type": "string",
"description": "The state or province name of the detected location."
},
"registered_country": {
"type": "string",
"description": "The English name of the registered country."
},
"registered_country_code": {
"type": "string",
"description": "The registered country's two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...)."
},
"timezone": {
"type": "string",
"description": "The IANA time zone database name of the detected location."
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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. See our Privacy Policy and
Terms.