# Property Search > Source: /api-reference/public/properties/search > Search properties by location with availability and pricing (no authentication required) > Endpoint: POST /public/properties/web/search ## Overview [#overview] Search for properties by location with optional dates, guest count, and filters. When dates are provided, returns availability status and pricing. No estimated points calculation since this is unauthenticated access showing public pricing. ## Authentication [#authentication] No authentication required. This is a public endpoint. ## Request Body [#request-body] Location search criteria Google Places ID for location-based search Geographic bounds for map-based search Northeast corner latitude Northeast corner longitude Southwest corner latitude Southwest corner longitude Specific property ID for single property search Check-in date (YYYY-MM-DD). If provided, availability and pricing will be included Check-out date (YYYY-MM-DD). Required if checkIn is provided Number of guests (minimum: 1) Search filters Price range filter Minimum price per night Maximum price per night Predefined filter IDs (e.g., pet-friendly, pool, spa) Room requirements Number of bedrooms Number of beds Number of bathrooms Property type IDs or names to include Pagination options Maximum results per page (1-100) Number of results to skip ```bash cURL - Location Search with Dates curl -X POST "https://api.journey.com/v1/public/properties/web/search" \ -H "Content-Type: application/json" \ -d '{ "location": { "placeId": "ChIJ-wSojYBEQogR5PMnOeL97CE" }, "checkIn": "2026-06-01", "checkOut": "2026-06-03", "guests": 2, "filters": { "price": { "min": 100, "max": 500 } }, "pagination": { "limit": 10, "offset": 0 } }' ``` ```bash cURL - Map Bounds Search curl -X POST "https://api.journey.com/v1/public/properties/web/search" \ -H "Content-Type: application/json" \ -d '{ "location": { "bounds": { "northeast": { "latitude": 21.2, "longitude": -86.8 }, "southwest": { "latitude": 21.1, "longitude": -86.9 } } }, "guests": 2 }' ``` ```typescript TypeScript const searchProperties = async (searchParams) => { const response = await fetch('https://api.journey.com/v1/public/properties/web/search', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: { placeId: 'ChIJ-wSojYBEQogR5PMnOeL97CE' }, checkIn: '2026-06-01', checkOut: '2026-06-03', guests: 2, filters: { price: { min: 100, max: 500 }, predefinedFilters: [1, 3], // Pool, Spa propertyTypes: ['resort', 'hotel'] }, pagination: { limit: 20, offset: 0 } }) }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${response.statusText}`); } return response.json(); }; ``` ```javascript JavaScript const searchProperties = async (searchParams) => { const response = await fetch('https://api.journey.com/v1/public/properties/web/search', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(searchParams) }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${response.statusText}`); } return response.json(); }; ``` ## Response [#response] Array of matching properties Internal property ID Strapi document ID Property name URL-friendly identifier Property type (hotel, resort, villa, etc.) Star rating (1-5) Guest review rating Number of reviews Brief property description Property location City name State or province Country name Latitude coordinate Longitude coordinate Main property image Full resolution image URL Thumbnail image URL Alt text for accessibility Key property amenities Brand information Brand name Brand logo URL Pricing information (only when dates provided) Base room type for pricing Nightly cost in cents (USD) Total cost for stay in cents (USD) Currency code (USD) Whether taxes are included in pricing Availability status (only when dates provided) Whether property has availability for requested dates Number of available room types Any booking restrictions Minimum nights required Maximum nights allowed Distance from search location in kilometers Relevance score for search ranking (0-100) Total number of properties matching search criteria Pagination information Current page limit Current offset Whether more results are available Applied filter summary and available filter options Summary of applied filters Available filter options based on results Minimum price found Maximum price found Available property types in results Common amenities that can be filtered ```json 200 Response - Search Results with Dates { "properties": [ { "id": 12345, "documentId": "abc123def456ghi789jkl012", "name": "Journey Beach Resort & Spa", "slug": "journey-beach-resort-spa", "propertyType": "Resort", "starRating": 5, "guestRating": 4.7, "reviewCount": 1247, "shortDescription": "Oceanfront luxury resort with spa and dining", "address": { "city": "Cancun", "state": "Quintana Roo", "country": "Mexico", "latitude": 21.1619, "longitude": -86.8515 }, "heroImage": { "url": "https://cdn.journey.com/properties/beach-resort-hero.jpg", "thumbnailUrl": "https://cdn.journey.com/properties/beach-resort-hero-thumb.jpg", "alt": "Oceanfront resort with infinity pool at sunset" }, "amenities": [ "Private Beach", "Infinity Pool", "Full-Service Spa", "Fine Dining Restaurant", "WiFi", "Parking" ], "brand": { "name": "Journey Resorts", "logo": "https://cdn.journey.com/brands/journey-resorts-logo.svg" }, "pricing": { "baseRoomCategory": "Ocean View Room", "nightlyCost": 35000, "totalCost": 70000, "currency": "USD", "taxesIncluded": false }, "availability": { "isAvailable": true, "availableRooms": 3, "restrictions": { "minNights": 2, "maxNights": 14 } }, "distance": 2.3, "searchScore": 95 }, { "id": 12346, "documentId": "def456ghi789jkl012mno345", "name": "Coastal Boutique Hotel", "slug": "coastal-boutique-hotel", "propertyType": "Hotel", "starRating": 4, "guestRating": 4.4, "reviewCount": 892, "shortDescription": "Intimate beachfront hotel with personalized service", "address": { "city": "Playa del Carmen", "state": "Quintana Roo", "country": "Mexico", "latitude": 20.6296, "longitude": -87.0739 }, "heroImage": { "url": "https://cdn.journey.com/properties/boutique-hotel-hero.jpg", "thumbnailUrl": "https://cdn.journey.com/properties/boutique-hotel-hero-thumb.jpg", "alt": "Boutique hotel courtyard with tropical gardens" }, "amenities": [ "Beach Access", "Pool", "Restaurant", "Concierge", "WiFi" ], "brand": { "name": "Independent", "logo": null }, "pricing": { "baseRoomCategory": "Standard Room", "nightlyCost": 22000, "totalCost": 44000, "currency": "USD", "taxesIncluded": false }, "availability": { "isAvailable": true, "availableRooms": 2, "restrictions": { "minNights": 1, "maxNights": null } }, "distance": 8.7, "searchScore": 88 } ], "total": 15, "pagination": { "limit": 10, "offset": 0, "hasMore": true }, "filters": { "applied": { "location": "Cancun, Mexico area", "dates": "Jun 1-3, 2026", "guests": 2, "priceRange": "$100-$500" }, "available": { "priceRange": { "min": 180, "max": 850 }, "propertyTypes": [ "Resort", "Hotel", "Villa", "Boutique Hotel" ], "amenities": [ "Beach Access", "Pool", "Spa", "Restaurant", "Fitness Center", "WiFi", "Parking" ] } } } ``` ```json 200 Response - Search without Dates { "properties": [ { "id": 12345, "documentId": "abc123def456ghi789jkl012", "name": "Journey Beach Resort & Spa", "slug": "journey-beach-resort-spa", "propertyType": "Resort", "starRating": 5, "guestRating": 4.7, "reviewCount": 1247, "shortDescription": "Oceanfront luxury resort with spa and dining", "address": { "city": "Cancun", "state": "Quintana Roo", "country": "Mexico", "latitude": 21.1619, "longitude": -86.8515 }, "heroImage": { "url": "https://cdn.journey.com/properties/beach-resort-hero.jpg", "thumbnailUrl": "https://cdn.journey.com/properties/beach-resort-hero-thumb.jpg", "alt": "Oceanfront resort with infinity pool at sunset" }, "amenities": [ "Private Beach", "Infinity Pool", "Full-Service Spa", "Fine Dining Restaurant", "WiFi", "Parking" ], "brand": { "name": "Journey Resorts", "logo": "https://cdn.journey.com/brands/journey-resorts-logo.svg" }, "distance": 2.3, "searchScore": 95 } ], "total": 15, "pagination": { "limit": 10, "offset": 0, "hasMore": true }, "filters": { "applied": { "location": "Cancun, Mexico area", "guests": 2 }, "available": { "propertyTypes": [ "Resort", "Hotel", "Villa" ], "amenities": [ "Beach Access", "Pool", "Spa", "Restaurant", "WiFi" ] } } } ``` ```json 400 Error - Invalid Search Parameters { "statusCode": 400, "message": [ "location is required", "checkOut is required when checkIn is provided" ], "error": "Bad Request" } ``` ## Use Cases [#use-cases] ### Property Search Interface [#property-search-interface] ```typescript const PropertySearch = () => { const [searchParams, setSearchParams] = useState({ location: null, checkIn: '', checkOut: '', guests: 2, filters: { price: { min: null, max: null }, propertyTypes: [], amenities: [] } }); const [results, setResults] = useState(null); const [loading, setLoading] = useState(false); const [pagination, setPagination] = useState({ offset: 0, limit: 20 }); const handleSearch = async (newParams = searchParams, newPagination = pagination) => { setLoading(true); try { const searchData = { location: newParams.location, ...(newParams.checkIn && newParams.checkOut && { checkIn: newParams.checkIn, checkOut: newParams.checkOut }), guests: newParams.guests, filters: newParams.filters, pagination: newPagination }; const data = await searchProperties(searchData); if (newPagination.offset === 0) { setResults(data); } else { // Append to existing results for pagination setResults(prev => ({ ...data, properties: [...(prev?.properties || []), ...data.properties] })); } } catch (error) { console.error('Search failed:', error); } finally { setLoading(false); } }; const loadMore = () => { if (!results?.pagination.hasMore) return; const newPagination = { ...pagination, offset: pagination.offset + pagination.limit }; setPagination(newPagination); handleSearch(searchParams, newPagination); }; const renderProperty = (property) => (
{property.heroImage?.alt} {property.starRating && (
{'★'.repeat(property.starRating)}
)}

{property.name}

{property.brand?.logo && ( {property.brand.name} )}

{property.address.city}, {property.address.country}

{property.shortDescription}

{property.guestRating && ( ⭐ {property.guestRating} ({property.reviewCount} reviews) )} {property.distance && ( {property.distance.toFixed(1)}km away )}
{property.amenities.slice(0, 4).map((amenity, index) => ( {amenity} ))} {property.amenities.length > 4 && ( +{property.amenities.length - 4} more )}
{property.pricing && (
${(property.pricing.nightlyCost / 100).toFixed(0)}/night
Total: ${(property.pricing.totalCost / 100).toFixed(0)} {!property.pricing.taxesIncluded && + taxes}
{property.availability && (
{property.availability.isAvailable ? `${property.availability.availableRooms} rooms available` : 'No availability' }
)}
)}
); return (
{/* Search Form */} { setPagination({ offset: 0, limit: 20 }); handleSearch(); }} loading={loading} /> {/* Results */} {results && (

{results.total} properties found

{Object.entries(results.filters.applied).map(([key, value]) => ( {key}: {value} ))}
{results.properties.map(renderProperty)}
{results.pagination.hasMore && ( )}
)}
); }; ``` ### Search with Map Integration [#search-with-map-integration] ```typescript const PropertySearchWithMap = () => { const [mapBounds, setMapBounds] = useState(null); const [properties, setProperties] = useState([]); const [selectedProperty, setSelectedProperty] = useState(null); const handleMapBoundsChange = async (bounds) => { setMapBounds(bounds); try { const results = await searchProperties({ location: { bounds }, guests: 2, pagination: { limit: 50, offset: 0 } }); setProperties(results.properties); } catch (error) { console.error('Map search failed:', error); } }; return (

{properties.length} properties in this area

{properties.map(property => ( setSelectedProperty(property)} /> ))}
); }; ``` ## Search Strategies [#search-strategies] ### Location Search Types [#location-search-types] - **Place ID**: Most accurate, uses Google Places - **Bounds**: Geographic area search for map integration - **Property ID**: Direct property lookup ### Ranking Algorithm [#ranking-algorithm] Properties are ranked by search score considering: - Distance from search location - Property rating and reviews - Availability (when dates provided) - Price competitiveness - Amenity match to filters ### Performance Optimization [#performance-optimization] ```typescript // Implement debounced search for better UX const useDebounced = (value, delay) => { const [debouncedValue, setDebouncedValue] = useState(value); useEffect(() => { const handler = setTimeout(() => { setDebouncedValue(value); }, delay); return () => clearTimeout(handler); }, [value, delay]); return debouncedValue; }; const SearchWithDebounce = ({ onSearch }) => { const [query, setQuery] = useState(''); const debouncedQuery = useDebounced(query, 300); useEffect(() => { if (debouncedQuery) { onSearch(debouncedQuery); } }, [debouncedQuery, onSearch]); return ( setQuery(e.target.value)} placeholder="Search destination..." /> ); }; ``` ## Related Endpoints [#related-endpoints] - [Trending Searches](/api-reference/public/properties/get-trending-searches) - Popular search destinations - [Property Details](/api-reference/public/properties/get-property-details) - Detailed property information