Resolve a free-text place into Immobiliare geography suggestions (region_id, province_id, city_id, macrozone_ids).
Turn a free-text place into structured Immobiliare geography suggestions —
nations, regions, provinces, cities (comuni) or zones. Use the returned
region_id / province_id / city_id to drive precise
/search and
/market-insights/prices
queries.
Query Parameters
string
required
Partial location — city, province, region or zone, e.g. Milano.
string
default:"it"
Market to search in. One of it, es, gr, lu.
Response
Suggestion[]
Geography suggestions, most relevant first.
Show Suggestion
string
Id of the suggested geography entity.
string
Human-readable label, e.g. Milano.
string
One of nation, region, province, comune, zone.
string
Region id — feed to /search and /market-insights/prices.
string
Province id.
string
City (comune) id.
integer[]
Macrozone ids when the suggestion is a zone.
string
Search-results path on the market’s portal.
string
Echo of the requested market.
Example
const res = await fetch( "https://scrapebadger.com/v1/immobiliare/autocomplete?" + new URLSearchParams({ query: "Milano", market: "it" }), { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },);const data = await res.json();