POST budgetatlas/v1/search_lodging

POSTbudgetatlas/v1/search_lodgingverifiedsync

Search stored lodging price observations for a city, either for exact dates or for a stay length. Returns comparable prices with their original amount and currency, tax status, per-source ratings, evidence-backed amenity signals, provenance, and coverage. These are historical snapshots, not live availability. A priced call is settled only when the response contains observations; a no-data answer (`no_data_reason` set) is returned unbilled, marked by the `X-BUDGETATLAS-BILLED` response header.

Provider rate: $0.002 per call

Billed: $0.0022 per call ($0.002 + 10% fee)

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

An answer with no data (no_data_reason set) is not settled upstream. OpenTools bills zero for it.

Provider documentation →

Input schema

citystringrequired

City ID, e.g. 'th-bangkok'.

checkinstring

Exact mode: use with checkout.

checkoutstring

nightsinteger

Typical mode: stay length without exact dates.

adultsinteger

childreninteger

roomsinteger

property_typesarray

sourcesarray

max_nightly_usdnumber

max_stay_total_usdnumber

min_rating_fractionnumber

Rating threshold as a 0-1 fraction of each source's own scale (0.8 = 8/10 or 4/5).

min_review_countinteger

required_signalsarray

Evidence-backed amenity signals that must qualify.

freshness_daysinteger

Only use observations collected within this many days.

limitinteger

Use this exact tool

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

Paste into your agent

Use the OpenTools tool budgetatlas/v1/search_lodging (https://opentools.fulinlabs.com/tools/budgetatlas/v1/search_lodging?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/search_lodging" and method "POST" for the input schema, then `run` with the same provider and endpoint.

CLI

opentools run -p budgetatlas -e /v1/search_lodging --method POST -i '{"body":{"city":"","checkin":"","checkout":"","nights":0,"adults":0,"children":0,"rooms":0,"property_types":[],"sources":[],"max_nightly_usd":0,"max_stay_total_usd":0,"min_rating_fraction":0,"min_review_count":0,"required_signals":[],"freshness_days":0,"limit":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/search_lodging","method":"POST","input":{"body":{"city":"","checkin":"","checkout":"","nights":0,"adults":0,"children":0,"rooms":0,"property_types":[],"sources":[],"max_nightly_usd":0,"max_stay_total_usd":0,"min_rating_fraction":0,"min_review_count":0,"required_signals":[],"freshness_days":0,"limit":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/search_lodging?method=POST