# Social Fetch API - Airbnb endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 4 documented Airbnb operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/airbnb/search Search Airbnb stays Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/airbnb/search/get.mdx SDK: client.airbnb.searchStays({ location: "London", adults: 2, currency: "USD" }) Parameters: - location (required, string) - Where to stay: a city, region, neighbourhood or address, as you would type it on the site, e.g. `London` or `Hay-on-Wye`. Add the country to tell places apart, e.g. `Paris, France`. - checkIn (optional, string) - Check-in date, `YYYY-MM-DD`. Pass it with `checkOut`. Default: no dates, so each listing is priced for the next dates it is free (its own `checkIn` and `checkOut` say which). - checkOut (optional, string) - Check-out date, `YYYY-MM-DD`, after `checkIn`. - adults (optional, integer) - Adults, 1 to 16. Default 1. - children (optional, integer) - Children aged 2 to 12, 0 to 15. Default 0. - infants (optional, integer) - Infants under 2, 0 to 5. Default 0. - pets (optional, integer) - Pets, 0 to 5. Default 0. - currency (optional, string) - Currency for prices, a three-letter code such as `USD`, `EUR` or `GBP`. Default `USD`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same parameters. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/airbnb/search?location=London" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/airbnb/listings/{listingId} Get Airbnb listing Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/airbnb/listings/listingid/get.mdx SDK: client.airbnb.getListing({ listingId: "1900063" }) Parameters: - listingId (required, string) - Airbnb listing id: the number in the listing URL (`airbnb.com/rooms/1900063`), e.g. `1900063`. The full listing URL also works. Search results return it as `listingId`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/airbnb/listings/1900063" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/airbnb/listings/{listingId}/reviews List Airbnb listing reviews Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/airbnb/listings/listingid/reviews/get.mdx SDK: client.airbnb.listListingReviews({ listingId: "1900063", sort: "most_recent" }) Parameters: - listingId (required, string) - Airbnb listing id: the number in the listing URL (`airbnb.com/rooms/1900063`), e.g. `1900063`. The full listing URL also works. Search results return it as `listingId`. - sort (optional, string, enum: most_recent | most_relevant | highest_rated | lowest_rated) - Order: `most_recent`, `most_relevant` (the site's own ranking), `highest_rated` or `lowest_rated`. Default `most_recent`. - limit (optional, integer) - Reviews per page, 1 to 50. Default 24. - language (optional, string, enum: en | ar | az | bg | bs | ca | cs | da | de | el | es | et | fi | fr | ga | he | hi | hr | hu | hy | id | is | it | ja | ka | kn | ko | lt | lv | mk | mr | ms | mt | nl | no | pl | pt | ro | ru | sk | sl | sq | sr | sv | sw | th | tl | tr | uk | vi | zh | zh-TW | zh-HK) - Language for translations, dates and topic names, e.g. `de`, `ja` or `zh-TW`. Default `en`. Each review's own `text` stays in the language it was written in. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same parameters. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/airbnb/listings/1900063/reviews?sort=most_recent" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/airbnb/listings/{listingId}/availability Get Airbnb listing availability Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/airbnb/listings/listingid/availability/get.mdx SDK: client.airbnb.getListingAvailability({ listingId: "1900063", months: 3 }) Parameters: - listingId (required, string) - Airbnb listing id: the number in the listing URL (`airbnb.com/rooms/1900063`), e.g. `1900063`. The full listing URL also works. Search results return it as `listingId`. - month (optional, string) - First month to show, `YYYY-MM`, from last month to 23 months ahead. Default: this month (UTC). - months (optional, integer) - How many months to show, 1 to 12. Default 12. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/airbnb/listings/1900063/availability?months=3" \ -H "x-api-key: YOUR_API_KEY"