JAjambase
Geographies

Search Cities

Search for cities. Results will be returned in order of most to least upcoming events in the city, and then alphabetically city name in the case of a tie.

<!-- theme: info -->

Requirement

Your request must include at least one of the geo parameters such as geoCityName, geoCountryIso2, geoCountryIso3, geoIp, geoMetroId, geoStateIso, or geoLatitude and geoLongitude.

get/geographies/cities

Request

Query parameters

pageinteger

Page number of results to retrieve

perPageinteger

Number of events per page of results

geoCityNamestring

Use to retrieve events for city name(s).

  • geoCityName=Seattle

Use a pipe (|) to include multiple city names.

  • geoCityName=Seattle|Tacoma

For more precise city-specific results try using city[id]

geoCountryIso2'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XD' | 'XG' | 'XK' | 'XP' | 'XR' | 'XS' | 'XW' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' iso-3166-alpha-2

The Country code in ISO 3166-1 alpha-2 format [docs].

Example:US

The two-letter ISO 3166-1 alpha-2 code for a country.

  • geoCountryIso2=US

Use a pipe (|) to include multiple countries.

  • geoCountryIso2=US|CA

Geographic filters alone request the normal upcoming-events dataset, even on historically entitled subscriptions; dateModifiedFrom alone is not historical intent either. On plans with geo + historical search (Enterprise baseline, or granted by request), request history explicitly with a licensed past event-date window or expandPastEvents=true. For country-by-country historical backfills, prefer bounded eventDateFrom/eventDateTo windows with no expand flag needed. An authorized historical request with no lower event-date bound receives the later fixed subscription date and rolling plan/override floor before origin fetch; truly unlimited history gets no invented floor. Iterate only countries that actually have data for your target date range (ask support for the coverage list) rather than sweeping every ISO code. Note the code for the United Kingdom is GB, not UK — source data occasionally shows UK, but this filter expects GB.

geoCountryIso3'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATF' | 'ATG' | 'AUS' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'URY' | 'USA' | 'UZB' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XGZ' | 'XKS' | 'XPR' | 'XQZ' | 'XSP' | 'XSV' | 'XWB' | 'XXD' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE' iso-3166-alpha-3

The Country code in ISO 3166-1 alpha-3 format [docs].

Example:USA

The three-letter ISO code for a country.

  • geoCountryIso3=USA

Use a pipe (|) to include multiple countries.

  • geoCountryIso3=USA|CAN
string ipv4
OR
string ipv6

Use to retrieve events near an IP address.
Supports IPv4 or IPv6 values.

  • geoIp=55.123.456.789
geoLatitudenumber float

The latitude of a location

Example:40.7505

The latitude for geographic radius.

  • geoLatitude=40.7505
geoLongitudenumber float

The longitude of a location

Example:-73.9934

The longitude for geographic radius.

  • geoLongitude=-73.9934
geoMetroIdstring

Use to retrieve events for specific <a href="https://data.jambase.com/api/reference/get-metros">metro ID(s)</a>.

  • geoMetroId=jambase:1

Use a pipe (|) to include multiple metro IDs.

  • geoMetroId=jambase:1|jambase:5
geoRadiusAmountnumber

The search radius for lat/lng type searches.

  • geoRadiusAmount=60
geoRadiusUnits'mi' | 'km'

The units of measure for a geo search radius

Whether to use miles (default) or kilometers for radius.

  • geoRadiusUnits=km
geoStateIso'US-AL' | 'US-AK' | 'US-AZ' | 'US-AR' | 'US-CA' | 'US-CO' | 'US-CT' | 'US-DE' | 'US-FL' | 'US-GA' | 'US-HI' | 'US-ID' | 'US-IL' | 'US-IN' | 'US-IA' | 'US-KS' | 'US-KY' | 'US-LA' | 'US-ME' | 'US-MD' | 'US-MA' | 'US-MI' | 'US-MN' | 'US-MS' | 'US-MO' | 'US-MT' | 'US-NE' | 'US-NV' | 'US-NH' | 'US-NJ' | 'US-NM' | 'US-NY' | 'US-NC' | 'US-ND' | 'US-OH' | 'US-OK' | 'US-OR' | 'US-PA' | 'US-RI' | 'US-SC' | 'US-SD' | 'US-TN' | 'US-TX' | 'US-UT' | 'US-VT' | 'US-VA' | 'US-WA' | 'US-WV' | 'US-WI' | 'US-WY' | 'US-DC' | 'US-AS' | 'US-GU' | 'US-MP' | 'US-PR' | 'US-UM' | 'US-VI' | 'AU-ACT' | 'AU-NSW' | 'AU-NT' | 'AU-QLD' | 'AU-SA' | 'AU-TAS' | 'AU-VIC' | 'AU-WA' | 'CA-AB' | 'CA-BC' | 'CA-MB' | 'CA-NB' | 'CA-NL' | 'CA-NS' | 'CA-NT' | 'CA-NU' | 'CA-ON' | 'CA-PE' | 'CA-QC' | 'CA-SK' | 'CA-YT' iso-3166-2

A State code in ISO 3166-2 format [docs].

Example:US-AZ

The State code in ISO_3166-2 format [docs].

  • geoStateIso=US-NY

Use a pipe (|) to include multiple State codes.

  • geoStateIso=US-NY|=US-PA

Note: Available for United States, Canada, and Australia only.

cityHasUpcomingEventsboolean

Only include Cities with / without upcoming events. Omit for both.

Response

A list of Cities

successboolean

A successful response.

Example response

{
  "pagination": {
    "page": 1,
    "perPage": 10,
    "totalItems": 50,
    "totalPages": 5
  },
  "cities": [
    {
      "identifier": "jambase:13412",
      "name": "New York",
      "geo": {
        "latitude": 40.7505,
        "longitude": -73.9934
      },
      "address": {
        "addressRegion": "US-AZ",
        "addressCountry": "US"
      },
      "x-timezone": "America/New_York",
      "containedInPlace": {
        "identifier": "jambase:13412",
        "name": "New York Area",
        "geo": {
          "latitude": 40.7505,
          "longitude": -73.9934
        },
        "address": {
          "addressRegion": "US-AZ",
          "addressCountry": "US"
        },
        "x-primaryCityId": 12,
        "x-numUpcomingEvents": 12
      },
      "x-numUpcomingEvents": 12
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.