Find a place
Cities and postal codes for the near_place filter, best match first. You can also pass the place written out as near_place (for example Denver, Colorado); the API then uses the best match of this same lookup. Free.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | argorant:read_counts |
Authorization
BearerAuth AuthorizationBearer <token>
Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.
In: header
Query Parameters
q*string
A city or postal code, or the start of one.
country?string
Two-letter country code to look in.
limit?integer
How many places, 1 to 50 (default 10).
Header Parameters
X-Request-Id?string
Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.
Match
^[A-Za-z0-9._-]{8,64}$Response Body
application/json
application/json
application/json
application/json
application/json
Shell
curl -X GET "https://app.argorant.com/api/v1/lookups/places?q=Denver&country=US&limit=5"JSON
{ "places": [ { "id": "gn:5419384", "label": "Denver, Colorado, United States", "kind": "city", "country": "US", "lat": 39.73915, "lon": -104.9847 } ]}