POST budgetatlas/v1/get_data_freshness

POSTbudgetatlas/v1/get_data_freshnessverifiedsync

Report 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.

Provider rate: Free

Call get_dataset_coverage first. It is free and lists the cities and cohorts that exist.

Provider documentation →

Input schema

citiesarray

City IDs such as 'th-bangkok'. Call get_dataset_coverage for the covered list.

countriesarray

ISO 3166-1 alpha-2 country codes, e.g. ['TH','VN'].

categorystring

Which observations to age. 'all' reports lodging and restaurants together and each on its own.

stale_after_daysinteger

Age at which this caller considers an observation stale. Default 90, the same window the typical-price queries use.

Use this exact tool

Every snippet below names budgetatlas/v1/get_data_freshness, so an agent runs this endpoint instead of searching for something similar.

Paste into your agent

Use the OpenTools tool budgetatlas/v1/get_data_freshness (https://opentools.fulinlabs.com/tools/budgetatlas/v1/get_data_freshness?method=POST). Connect to the OpenTools MCP server at https://opentools.fulinlabs.com/mcp (or install the CLI with `npm i -g @aeither/opentools`). Do not search the catalog — call `inspect` with provider "budgetatlas" and endpoint "/v1/get_data_freshness" and method "POST" for the input schema, then `run` with the same provider and endpoint.

CLI

opentools run -p budgetatlas -e /v1/get_data_freshness --method POST -i '{"body":{"cities":[],"countries":[],"category":"","stale_after_days":0}}' -w

HTTP

curl -X POST https://opentools.fulinlabs.com/v1/run \
  -H "Authorization: Bearer opentools_live_..." \
  -H "content-type: application/json" \
  -d '{"provider":"budgetatlas","endpoint":"/v1/get_data_freshness","method":"POST","input":{"body":{"cities":[],"countries":[],"category":"","stale_after_days":0}}}'

Connect

Skill

set up https://opentools.fulinlabs.com/SKILL.md

MCP

https://opentools.fulinlabs.com/mcp

CLI

npm i -g @aeither/opentools

Try it →

Share this tool

Send this link to whoever should use it. It carries the schema, the price, and the snippets above — they need an OpenTools key and a balance, nothing from you.

https://opentools.fulinlabs.com/tools/budgetatlas/v1/get_data_freshness?method=POST