Search commercial premises
claro_search_premisesFind shops, restaurant premises, offices, warehouses and other commercial premises for rent or sale anywhere in Spain. Describe the site in plain words in any language (brief), send criteria as data, or both (criteria override the brief). Returns exact counts, the criteria as understood and the best results, each with what it meets and what its text does not state, the sentence that matched, its coordinates, a fit verdict read from its text, the agency's own ad link and, when the plan includes Location Intelligence, footfall, residents and nearby places. Up to 200 results a page, capped by the plan; send next_cursor as cursor for the next page. Keep search_id to refine. On the Free plan, each call (and each page) is one of 4 searches. Never for homes: apartments, houses and other homes are Property Sourcing (property-sourcing_search). Costs 100 tokens a call. Each page is a call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of the text the answer writes (titles, notes, labels, reasons, error messages): en (default) or de (German). Place names, agency names, property titles and quotes from a property's own text stay as written. | en |
| sort | No | With search_id (and no brief, criteria, change or cursor): the same stored matches in this order, without searching again. Same matches and counts; the answer has a new search_id for the new order. best goes back to the search's own ranking. Unpriced properties go last. | |
| brief | No | ||
| check | No | Read the top results' text against the brief (adds a few seconds). Off above 50 results a page and on later pages. | |
| limit | No | Results a page, up to 200; above 50 check is off. With pins_only, pins a page, up to 2000 (default 10: send a limit). | |
| cursor | No | next_cursor from an earlier answer: returns that search's next page, same criteria and order. Send without brief, criteria or change. | |
| offset | No | With search_id (no brief, criteria or change): the page of that stored search starting at this place in its ranked matches. Same order as its cursors. | |
| criteria | No | Criteria as data. Hard criteria (operation, cities, types, price, area) exclude properties outside them; the rest exclude only properties that state the opposite, and each result says which were met and which the property does not state. | |
| insights | No | ||
| pins_only | No | With search_id or cursor: no results, only `pins` (id, lat, lon, precision, type, district, prices, area_m2) for up to 2000 matches a page, to draw a map. Needs no read-through and costs no results. | |
| search_id | No | A search_id from an earlier answer, with offset, stated_only or pins_only (and no brief, criteria or change): pages that search's stored matches. To change the criteria use refine_search. | |
| stated_only | No | Only the matches that state every criterion (met). Matches with a criterion not stated or not met are left out of results and of page.total; counts keeps both totals. With search_id and no brief/criteria/change: pages that stored search. |