Built-in tool
Discover Airbnb Properties by Search URL
Discover Airbnb properties from an Airbnb search-results URL.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| urlstring · required | string | required | Airbnb search-results URL (e.g. https://www.airbnb.com/s/Greece/homes?...). |
| countrystring · optional | string | optional | 2-letter country code for the proxy/locale (e.g. "US"). Leave blank for the default. |
| limit_per_inputnumber · optional | number | optional | Limit the number of results per input. Capped at 62 results for this tool's credit tier. |
| limit_multiple_resultsnumber · optional | number | optional | Limit the total number of results. Capped at 62 results for this tool's credit tier. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"elements"
],
"properties": {
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"type": "string"
},
"stars": {
"type": "number"
},
"images": {
"type": "array",
"items": {
"type": "string"
}
},
"rating": {
"type": "number"
},
"address": {
"type": "string"
},
"check_in": {
"type": "string"
},
"currency": {
"type": "string"
},
"latitude": {
"type": "number"
},
"location": {
"type": "string"
},
"amenities": {
"type": "array",
"items": {
"type": "string"
}
},
"check_out": {
"type": "string"
},
"longitude": {
"type": "number"
},
"room_type": {
"type": "string"
},
"description": {
"type": "string"
},
"reviews_count": {
"type": "number"
}
},
"additionalProperties": true
}
},
"capReason": {
"enum": [
"tier_default",
"requested_limit",
"limit_clamped"
],
"type": "string"
},
"recordCap": {
"type": "number"
},
"truncated": {
"type": "boolean"
},
"capApplied": {
"type": "boolean"
},
"suggestion": {
"type": "string"
},
"totalElements": {
"type": "number"
}
},
"additionalProperties": true
}