Data freshness
get_data_freshnessReport how old the data is, per city and for the dataset as a whole: the newest and oldest observation, its age in days against a staleness line you choose, a fresh/aging/stale/empty verdict that names the number behind it, and the last collection run with its status. Call this before quoting a price as current.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_data_freshness"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cities | No | City IDs such as 'th-bangkok'. Call get_dataset_coverage for the covered list. | |
| category | No | Which observations to age. 'all' reports lodging and restaurants together and each on its own. | all |
| countries | No | ISO 3166-1 alpha-2 country codes, e.g. ['TH','VN']. | |
| stale_after_days | No | Age at which this caller considers an observation stale. Default 90, the same window the typical-price queries use. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| as_of | Yes | ||
| notes | Yes | ||
| cities | Yes | ||
| dataset | Yes | ||
| stalest_cities | Yes | ||
| stale_after_days | Yes |