Skip to content

Structured Airbnb data: send url. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/airbnb-price-tracker/Open in Playground

Call GET /api/v2/airbnb-price-tracker/ with url. The results are in data.entries; send data.next_cursor back as cursor to get the next page. 8 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/airbnb-price-tracker/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "url=https://www.airbnb.com/rooms/569049214818933247" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
urlstringyese.g. https://www.airbnb.com/rooms/569049214818933247Airbnb listing URL. Required on first call; ignored when cursor is supplied.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
check_in_datestringno2026-12-01Starting check-in date (YYYY-MM-DD). Cursor advances this by 30 days per page.
stay_daysintegerno3Length (nights) of each daily quote. Locked into the cursor.
adultsintegerno2Adult guests
childrenintegerno0Child guests
infantsintegerno0Infant guests
petsintegerno0Pet count
currencystringnoUSDCurrency code
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"url": "https://www.airbnb.com/rooms/569049214818933247",
"check_in_date": "2026-12-01",
"currency": "USD",
"page_size": 30,
"entries": [
{
"listing_url": "https://www.airbnb.com/rooms/569049214818933247",
"listing_id": "569049214818933247",
"host": "Hosted by Fatin",
"overview": "Entire serviced apartment in Kuala Lumpur, Malaysia",
"title": "CeylonZ Suites Kuala Lumpur. 33a (B) City View - Serviced apartments for Rent in Kuala Lumpur, Malaysia - Airbnb",
"canonical_url": "https://www.airbnb.com/rooms/569049214818933247",
"room_info": "Serviced apartment in Kuala Lumpur · ★4.91 · 1 bedroom · 2 beds · 1 bath",
"property_type": "Entire serviced apartment",
"room_rating": 4.91,
"accuracy_rating": 4.94,
"checkin_rating": 4.84,
"cleanliness_rating": 4.93,
"communication_rating": 4.92,
"location_rating": 4.84,
"value_rating": 4.9,
"guest_satisfaction_overall": 4.91,
"visible_review_count": "388",
"review_accessibility_label": "Rated 4.91 out of 5 from 388 reviews.",
"pets_allowed": false,
"guest_capacity": 2,
"location": "Kuala Lumpur",
"image_url": "https://a0.muscache.com/im/pictures/93f9feea-82c8-4537-bfad-3bda8e479333.jpg",
"meta_description": "Dec 1, 2026 · Entire serviced apartment · Located in the HEART of Kuala Lumpur. Building address is Exsim Ceylonz Suites, Persiaran Raja Chulan...",
"price_breakdown_title": "Price details",
"price_breakdown_subtitle": null,
"accessibility_label": "$435 for 3 nights",
"strike_through_price": null,
"primary_price": "$145",
"cleaning_fee": "$25",
"service_fee": "$61",
"taxes": null,
"total_price": "$435",
"booking": "Available",
"bedrooms": "1",
"beds": "2",
"bathrooms": "1",
"cancellation_policy_name": "Firm",
"cancellation_policy_subtitles": [
"Free cancellation before November 1. Cancel before November 24 for a partial refund."
],
"check_in_date": "2026-12-01",
"check_out_date": "2026-12-04",
"url": "https://www.airbnb.com/rooms/569049214818933247"
}
],
"next_cursor": "eyJhIjoyLCJjaCI6bnVsbCwiY2lkIjoiMjAyNi0xMi0zMSIsImN1IjoiVVNEIiwiaCI6IjdmMWU1ZjZhMDk5MyIsImluZiI6bnVsbCwicCI6MCwic2QiOjMsInUiOiJodHRwczovL3d3dy5haXJibmIuY29tL3Jvb21zLzU2OTA0OTIxNDgxODkzMzI0NyJ9"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.entries.

FieldTypeExampleDescription
urlstringhttps://www.airbnb.com/rooms/569049214818933247—
check_in_datestring2026-12-01—
currencystringUSD—
page_sizeinteger30—
entriesarray[1 item]The results.
next_cursorstringeyJhIjoyLCJjaCI6bnVsbCwiY2lkIjoiMjAyNi0xMi0zM…Pass back as cursor for the next page. null on the last page.
entries[].listing_urlstringhttps://www.airbnb.com/rooms/569049214818933247—
entries[].listing_idstring569049214818933247—
entries[].hoststringHosted by Fatin—
entries[].overviewstringEntire serviced apartment in Kuala Lumpur, Ma…—
entries[].titlestringCeylonZ Suites Kuala Lumpur. 33a (B) City Vie…—
entries[].canonical_urlstringhttps://www.airbnb.com/rooms/569049214818933247—
entries[].room_infostringServiced apartment in Kuala Lumpur · ★4.91 · …—
entries[].property_typestringEntire serviced apartment—
entries[].room_ratingnumber4.91—
entries[].accuracy_ratingnumber4.94—
entries[].checkin_ratingnumber4.84—
entries[].cleanliness_ratingnumber4.93—
entries[].communication_ratingnumber4.92—
entries[].location_ratingnumber4.84—
entries[].value_ratingnumber4.9—
entries[].guest_satisfaction_overallnumber4.91—
entries[].visible_review_countstring388—
entries[].review_accessibility_labelstringRated 4.91 out of 5 from 388 reviews.—
entries[].pets_allowedbooleanfalse—
entries[].guest_capacityinteger2—
entries[].locationstringKuala Lumpur—
entries[].image_urlstringhttps://a0.muscache.com/im/pictures/93f9feea-…—
entries[].meta_descriptionstringDec 1, 2026 · Entire serviced apartment · Loc…—
entries[].price_breakdown_titlestringPrice details—
entries[].price_breakdown_subtitlenullnull—
entries[].accessibility_labelstring$435 for 3 nights—
entries[].strike_through_pricenullnull—
entries[].primary_pricestring$145—
entries[].cleaning_feestring$25—
entries[].service_feestring$61—
entries[].taxesnullnull—
entries[].total_pricestring$435—
entries[].bookingstringAvailable—
entries[].bedroomsstring1—
entries[].bedsstring2—
entries[].bathroomsstring1—
entries[].cancellation_policy_namestringFirm—
entries[].cancellation_policy_subtitlesarray[1 item]—
entries[].check_in_datestring2026-12-01—
entries[].check_out_datestring2026-12-04—
entries[].urlstringhttps://www.airbnb.com/rooms/569049214818933247—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/airbnb-price-tracker/";
let params = { url: "https://www.airbnb.com/rooms/569049214818933247" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.entries ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Nothing special: send the inputs, read the result.