Legacy city and address autocomplete (deprecated)

View all Realty in US Property & Mortgage Data endpoints →

Retained for existing integrations that submit one required input query string to obtain location suggestions. The documented input covers city, district and place names; the endpoint description also mentions street names and address-to-property-identifier lookup. The example input is new york. This deprecated route is a migration surface, not the recommended choice for a new location picker; evaluate /locations/v2/auto-complete instead. The supplied documentation example contains an autocomplete array. Example candidates include _id as a candidate identity, _score as a relevance value, area_type as a location category, centroid.lat and centroid.lon as coordinates, and city, state_code and country as geography. Example counties entries contain fips, name and state_code. Other type-dependent example fields include geo_id, slug_id, county_needed_for_uniq, city_slug_id, line, postal_code, has_catchment, school and school_id. Do not treat these fields as present on every suggestion or confuse a city identity with a property identifier. No successful response from this deprecated route was recorded in the supplied checks. The fields above come from an unverified, truncated documentation example rather than an observed response. Address-to-property resolution is a documented purpose, not a guarantee that a particular address will yield a property identifier. Before migrating, validate suggestion types, optional fields and the inputs accepted by the next property endpoint; do not assume the replacement route has an identical response contract.

API Features

Single-input legacy search contract Preserve the existing GET request with its required input string for city, district or place-name searches while auditing older search forms.
Example-only candidate field inventory Review the documented autocomplete array, candidate identities, location categories, coordinates and geographic fields without presenting the truncated example as verified output.
Geography versus property identity checks Distinguish location identifiers such as a city candidate from any optional property identifier before handing a selection to a property lookup.
Explicit deprecated-route migration boundary Use this route to understand an existing integration and separately validate the current location endpoint instead of treating the two contracts as interchangeable.

Live API Demo

GET /api/project/realty-in-us/locations-auto-complete-deprecated

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/locations-auto-complete-deprecated?key=<API_KEY>&input=<input>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Should a new location picker use this deprecated route?

No. Keep this documentation for existing /locations/auto-complete integrations and evaluate /locations/v2/auto-complete for new work. Validate the replacement response and parameter contract rather than assuming a drop-in substitution.

Which query parameters belong to this legacy endpoint?

The supplied contract exposes only the required string parameter input, with new york as its example. It does not document a limit parameter for this route.

Does entering an address guarantee a property identifier?

No. Address-to-property-identifier lookup is mentioned in the endpoint description, but this route has no recorded successful check in the supplied evidence. A location candidate identity must not automatically be treated as a property identifier.

Are the documented autocomplete fields verified on this route?

No. Fields such as _id, area_type, centroid, city, state_code and counties appear in a truncated documentation example only. Treat them as migration clues, handle absent type-dependent fields and verify the contract before relying on them.

Related operations

Guides

View Subscription Plans →