--- title: "Airbnb API: JSON data, 3 endpoints, 1 credit per call" description: "Get Airbnb data as structured JSON with one API key: search, listing and reviews. Free credits every month." url: https://perceptlayer.com/apis/airbnb --- [APIs](https://perceptlayer.com/apis) / [Travel](https://perceptlayer.com/verticals/travel) / Airbnb 1 credit per call 3 endpoints 16 datapoints # Airbnb API Get Airbnb data as structured JSON with one API key: search, listing and reviews. Free credits every month. [Get a free API key](https://perceptlayer.com/signup) Run it below Airbnb GET /v1/airbnb/search?place=Paris--France&checkin=2026-11-10&checkout=2026-11-14&adults=2¤cy=EUR ``` { "success": true, "data": { "place": "Paris, France", "results": [ { "id": "1669612146929039736", "url": "https://www.airbnb.com/rooms/1669612146929039736", "title": "Apartment in Paris", "name": "Stylish 1-Bedroom/2-Person Apartment – Beaugrenelle", "subtitle": "Bright 6th-floor stay near the Eiffel Tower, with a balcony and a private entrance", "rating": 5, "review_count": 17, "price": { "amount": 714, "currency": "EUR", "nights": 4, "qualifier": "for 4 nights" }, "price_breakdown": [ { "description": "4 nights x €178.34", "amount": 713.37 } ], "bedrooms": 1, "beds": 1, "bathrooms": 1, "latitude": 48.84223, "longitude": 2.29241, "badges": [ "Guest favorite" ], "images": [ "https://a0.muscache.com/im/pictures/hosting/Hosting-1669612146929039736/original/053b1768-c702-49bf-9b31-d0b00b51260b.jpeg", "https://a0.muscache.com/im/pictures/hosting/Hosting-1669612146929039736/original/5ca917a8-cc14-48aa-9f76-f07a991a7f7a.jpeg", "https://a0.muscache.com/im/pictures/hosting/Hosting-1669612146929039736/original/8212d4d8-b4f5-47b7-9b0c-5f83bcfeb804.jpeg" ] }, { "id": "1789244334462111444", "url": "https://www.airbnb.com/rooms/1789244334462111444", "title": "Apartment in Paris", "name": "1-bedroom Parisian apartment in the center ", "subtitle": "Tasteful Parisian flat in the Latin Quarter, near Place Monge and Rue Mouffetard", "price": { "amount": 765, "currency": "EUR", "nights": 4, "qualifier": "for 4 nights" }, "price_breakdown": [ { "description": "4 nights x €191.25", "amount": 765 } ], "bedrooms": 1, "beds": 2, "bathrooms": 1, "latitude": 48.8419, "longitude": 2.3529, "images": [ "https://a0.muscache.com/im/pictures/hosting/Hosting-1789244334462111444/original/7ad0a21c-dc61-4f7b-9c45-9c99ec24158d.jpeg", "https://a0.muscache.com/im/pictures/hosting/Hosting-1789244334462111444/original/68dc68c0-4513-46eb-a8fa-304c27f44d8c.jpeg", "https://a0.muscache.com/im/pictures/hosting/Hosting-1789244334462111444/original/445f921f-1ea9-4fbe-a013-c75704db10a9.jpeg" ] }, { "id": "42040070", "url": "https://www.airbnb.com/rooms/42040070", "title": "Apartment in Paris", "name": "21 Eiffel Tower Apartment for 2 people", "subtitle": "Decorator-renovated hideaway, 1 min from the metro, with a private entrance", "rating": 4.81, "review_count": 212, "price": { "amount": 435, "currency": "EUR", "nights": 4, "qualifier": "for 4 nights" }, "price_breakdown": [ { "description": "4 nights x €108.75", "amount": 435 } ], "beds": 1, "bathrooms": 1.5, "latitude": 48.84118, "longitude": 2.30754, "badges": [ "Guest favorite" ], "images": [ "https://a0.muscache.com/im/pictures/b4c186f7-1085-4d98-97cd-9f10e29f7970.jpg", "https://a0.muscache.com/im/pictures/43244eb7-f2a8-4f0b-9fd8-b515d01b861b.jpg", "https://a0.muscache.com/im/pictures/857eece6-5076-4f55-a492-d7c72d1a73bb.jpg" ] } ], "has_more": true, "next_cursor": "eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxOCwidmVyc2lvbiI6MX0=" }, "meta": { "endpoint_family": "stay_search", "billable": true } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | url url | title string | name string | subtitle string | rating number | review\_count number | price object | price\_breakdown object\[\] | bedrooms number | beds integer | bathrooms number | latitude number | longitude number | badges string\[\] | images string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1669612146929039736 | https://www.airbnb.com/rooms/1669612146929039736 | Apartment in Paris | Stylish 1-Bedroom/2-Person Apartment – Beaugrenelle | Bright 6th-floor stay near the Eiffel Tower, with a balcony and a private entrance | 5 | 17 | {4 fields} | \[1 item\] | 1 | 1 | 1 | 48.84223 | 2.29241 | \[1 item\] | \[3 items\] | | 2 | 1789244334462111444 | https://www.airbnb.com/rooms/1789244334462111444 | Apartment in Paris | 1-bedroom Parisian apartment in the center | Tasteful Parisian flat in the Latin Quarter, near Place Monge and Rue Mouffetard | — | — | {4 fields} | \[1 item\] | 1 | 2 | 1 | 48.8419 | 2.3529 | — | \[3 items\] | | 3 | 42040070 | https://www.airbnb.com/rooms/42040070 | Apartment in Paris | 21 Eiffel Tower Apartment for 2 people | Decorator-renovated hideaway, 1 min from the metro, with a private entrance | 4.81 | 212 | {4 fields} | \[1 item\] | — | 1 | 1.5 | 48.84118 | 2.30754 | \[1 item\] | \[3 items\] | Recorded from our API · 3 items shown · 16 datapoints per item GET /v1/airbnb/search?place=Paris--France&checkin=2026-11-10&checkout=2026-11-14&adults=2¤cy=EUR 16 datapoints ### Identity - id string - title string - name string - subtitle string ### Contact - url url ### Location - latitude number - longitude number ### Reputation - rating number - review\_count number - badges string\[\] - images string\[\] ### Price - price object - price\_breakdown object\[\] ### Other - bedrooms number - beds integer - bathrooms number Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/airbnb/search?place=Paris--France&checkin=2026-11-10&checkout=2026-11-14&adults=2¤cy=EUR" \ -H "X-API-Key: $API_KEY" ``` Airbnb · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/airbnb/listing`](https://perceptlayer.com/apis/airbnb/listing) | `listing_id` +3 optional | 1 credit | | [GET `/v1/airbnb/reviews`](https://perceptlayer.com/apis/airbnb/reviews) | `listing_id` +2 optional | 1 credit | | [GET `/v1/airbnb/search`](https://perceptlayer.com/apis/airbnb/search) | `place` +10 optional | 1 credit | Overview ## About the Airbnb API ## What you can get The Airbnb API returns search, listing and reviews as clean JSON. Each successful call costs one credit, and calls that fail are free. Travel JSON REST MCP ### More travel APIs [Agoda](https://perceptlayer.com/apis/agoda) [Booking.com](https://perceptlayer.com/apis/booking) [Economy Car Rentals](https://perceptlayer.com/apis/economy-car-rentals) [Eventbrite](https://perceptlayer.com/apis/eventbrite) [Expedia](https://perceptlayer.com/apis/expedia) [FlixBus](https://perceptlayer.com/apis/flixbus) [GetYourGuide](https://perceptlayer.com/apis/getyourguide) [Google Flights](https://perceptlayer.com/apis/google-flights) [Google Hotels](https://perceptlayer.com/apis/google-hotels) [Google Travel Explore](https://perceptlayer.com/apis/google-travel-explore) [HolidayCheck](https://perceptlayer.com/apis/holidaycheck) [Holidu](https://perceptlayer.com/apis/holidu) Use cases ### Monitor fares and room rates `Use the Airbnb API to monitor fares and room rates` ### Check availability across dates `Use the Airbnb API to check availability across dates` ### Build travel search and comparison tools `Use the Airbnb API to build travel search and comparison tools` FAQ ## Questions **How much does the Airbnb API cost?** Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a separate key for Airbnb?** No. One key works for every API in the catalogue. ## Try the Airbnb API with 1,000 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)