Formulas for

Look Up City Data

Geography1 credit/cellSheets · Excel150K+ cities
=VERVE("citieslookup", "San Francisco")

Pull population, country and coordinates by the row. =VERVE("citieslookup", A2) reads a whole column across 150K+ cities — Sheets or Excel.

It's one of 250+ live sources you reach with a single =VERVE() function — served from APIVerve's production data engine, billed at 1 credit per resolved cell, and refreshed on whatever cadence you set. No API keys to wrangle, no scripts, no exports.

A real example — the input you type, and the values you can pull from it. Click any cell to see the formula behind it.

citieslookup.xlsxsample data
B2fx=VERVE("citieslookup", A2, "search")
A
B
1
City
Search
2
San Francisco
San Francisco
3
4
click any cell to see its formula1 credit / cell

Enrich an address list

Have a column of places? Fill =VERVE("citieslookup", "San Francisco") down it to resolve each into structured location data — coordinates, timezone, or region — right in the grid.

Clean location data in place

Normalize messy, hand-entered locations into consistent values without exporting to another tool and importing the result back.

Location-aware calculations

Feed Look Up City Data's output straight into distance, timezone, or cost math with the spreadsheet functions you already use.

The same function works in both apps — install once, sign in with your key, and type it into any cell.

Google SheetsAdd-on

Install from the Workspace Marketplace, then drop the formula into a cell. Autocomplete suggests the source and its fields.

=VERVE("citieslookup", "San Francisco")
Microsoft ExcelAdd-in

Same source, same arguments, same key — in Excel on desktop, the web, or mobile. Excel namespaces it as VERVE.CALL. Drag to fill a whole column.

=VERVE.CALL("citieslookup", "San Francisco")

Tune the result by adding name=value before the field argument — in any order. Leave one out and its default applies.

  • limitPremium

    Limit number of cities that match your search criteria

    =VERVE("citieslookup", "San Francisco", "limit", "5")

Add a field name as the last argument to land just that value in the cell.

  • Search
    =VERVE("citieslookup", "San Francisco", "field", "search")
  • Found Cities
    =VERVE("citieslookup", "San Francisco", "field", "foundCities")
  • Found Cities[].name
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].name")
  • Found Cities[].alt Name
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].altName")
  • Found Cities[].country
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].country")
  • Found Cities[].country Name
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].countryName")
  • Found Cities[].feature Code
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].featureCode")
  • Found Cities[].population
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].population")
  • Found Cities[].population Category
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].populationCategory")
  • Found Cities[].loc.type
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].loc.type")
  • Found Cities[].loc.coordinatesPremium
    =VERVE("citieslookup", "San Francisco", "field", "foundCities[].loc.coordinates")

Premium marks data included on paid plans. On the Free plan a marked field is withheld and a marked input is ignored — either way the cell reads #PREMIUM(name) instead of a value, so a gated answer can never be mistaken for a real one. Everything unmarked works on every plan. Compare plans

Look Up City Data, answered

Everything you need to wire it into a sheet.

How do I pull Look Up City Data into a spreadsheet?
Install the VerveSheets add-on, sign in with your key, and type =VERVE("citieslookup", "San Francisco") into any cell. The same function works in Google Sheets and Excel — no scripts, no API wiring.
How many credits does each Look Up City Data cell cost?
Each resolved cell costs 1 credit. Filling a column of ten rows costs ten times that; a cell only re-bills when it actually refreshes, so a static sheet doesn't keep charging.
Can I fill a whole column at once?
Yes. Reference a range instead of a single cell — e.g. point Look Up City Data at A2:A50 — and it returns a value for every row in one call, or just drag =VERVE("citieslookup", "San Francisco") down like any spreadsheet function.
Does Look Up City Data work in Excel as well as Google Sheets?
Yes. It's the same =VERVE() function with the same arguments and the same key in both — build a sheet in one and it behaves identically in the other.
How current is the data?
Look Up City Data is served live from APIVerve's production data engine, and cells recalculate on the refresh cadence you choose — every open, hourly, or every 30 minutes. It draws on 150K+ cities and refreshes on the schedule you set.
Where does the data come from, and what shows on my bill?
VerveSheets runs on APIVerve, our production data engine; Look Up City Data is one of 300+ sources on the same key. Invoices and card statements show APIVERVE.

Put Look Up City Data in your next spreadsheet. Add the extension, paste the formula, and the cell keeps itself current.

Scaling up?

Volume pricing, custom SLAs, and dedicated support for high-traffic teams.

Contact sales