---
title: "Profile of a place"
method: GET
path: "/api/v1/profile"
---

# Profile of a place

`GET /api/v1/profile`

## Request

- Base URL: `https://invokely.ai`
- URL: `https://invokely.ai/api/v1/profile`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
  - none

An overview of one place in a single call: its latest official figures grouped in sections (people, work and income, economy, prices and housing, consumers, business and tourism, health, digital, energy and environment), each with its period, its change from a year earlier, its rank among similar places and its source, plus a one-sentence summary per section.
Use it for "give me an overview of Travis County", "key statistics for Bavaria", "a profile of Mataró". For one figure use get_value; for a ranking use rank_places.
Only sections the place has data for are returned, with at most 6 figures each. sections limits the answer to some of them: people, work_income, economy, prices_housing, consumers, business, health, digital, environment.
Example: {"place": "Travis County, Texas"}. {"place": "Spain", "sections": ["economy", "work_income"]}.
Returns {place, url, sections: [{id, title, summary, figures: [{indicator, value, text, period, status?, change?: {kind, value, unit, from_period, from_value}, change_note?, rank?: {rank, counted_from, of, tied, period, among, ranking_url}, source}]}], sources: [{id, name, publisher, title, url, retrieved, license, citation}], notes}.
change.kind is percent, points (percentage points), difference or compare (a net balance, given with the earlier value). rank counts from the nearer end: {rank: 3, counted_from: "lowest"} is the 3rd lowest. Each figure names its source by id; cite sources[].citation and give the period. One call, whatever the number of figures.

## Query parameters

- `place` string, required
- `country` string
- `section` string[]

## Response `200`

Success. The body is {"data": ...}; the remaining allowance is in the x-invokely-remaining header.

- Data
  - `data` unknown, required

## Other responses

- `400`: Invalid argument (INVALID_ARGUMENT).
- `401`: The API key or token is invalid or revoked (UNAUTHORIZED).
- `402`: Allowance used up (QUOTA_EXHAUSTED), or the plan does not include the REST API (PLAN_REQUIRED: Free keys; use the MCP server or upgrade to Builder).
- `404`: Unknown indicator or place, or no data (INDICATOR_NOT_FOUND, PLACE_NOT_FOUND, AMBIGUOUS_PLACE, NO_DATA). hint and suggestions say what to try next.
- `429`: Rate limited (RATE_LIMITED). Retry after retry_after_seconds.

---

[API](https://skmtc.dev/invokely/apis/invokely-statistics-api.md) · [All operations](https://skmtc.dev/invokely/apis/invokely-statistics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/invokely/apis/invokely-statistics-api/revisions/3b0f775bccb6?raw)