Airbnb Price Tracker
Structured Airbnb data: send url. Cursor-paginated, 1 credit per successful call.
Overview
Section titled “Overview”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).
Request
Section titled “Request”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 210const params = new URLSearchParams({ url: "https://www.airbnb.com/rooms/569049214818933247" });
const res = await fetch(`https://api.scrapier.io/api/v2/airbnb-price-tracker/?${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}`);
console.log(body.data.entries);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/airbnb-price-tracker/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"url": "https://www.airbnb.com/rooms/569049214818933247"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["entries"])curl -X POST "https://api.scrapier.io/api/v2/airbnb-price-tracker/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"https://www.airbnb.com/rooms/569049214818933247"}' \ --max-time 210Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | — | Your API key from the dashboard. |
url | string | yes | e.g. https://www.airbnb.com/rooms/569049214818933247 | Airbnb listing URL. Required on first call; ignored when cursor is supplied. |
cursor | string | no | — | 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_date | string | no | 2026-12-01 | Starting check-in date (YYYY-MM-DD). Cursor advances this by 30 days per page. |
stay_days | integer | no | 3 | Length (nights) of each daily quote. Locked into the cursor. |
adults | integer | no | 2 | Adult guests |
children | integer | no | 0 | Child guests |
infants | integer | no | 0 | Infant guests |
pets | integer | no | 0 | Pet count |
currency | string | no | USD | Currency code |
Advanced
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | false | When 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. |
Response
Section titled “Response”{ "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" }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "…"}Balance below the endpoint’s price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled — wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.entries.
Response fields
Section titled “Response fields”| Field | Type | Example | Description |
|---|---|---|---|
url | string | https://www.airbnb.com/rooms/569049214818933247 | — |
check_in_date | string | 2026-12-01 | — |
currency | string | USD | — |
page_size | integer | 30 | — |
entries | array | [1 item] | The results. |
next_cursor | string | eyJhIjoyLCJjaCI6bnVsbCwiY2lkIjoiMjAyNi0xMi0zM… | Pass back as cursor for the next page. null on the last page. |
entries[].listing_url | string | https://www.airbnb.com/rooms/569049214818933247 | — |
entries[].listing_id | string | 569049214818933247 | — |
entries[].host | string | Hosted by Fatin | — |
entries[].overview | string | Entire serviced apartment in Kuala Lumpur, Ma… | — |
entries[].title | string | CeylonZ Suites Kuala Lumpur. 33a (B) City Vie… | — |
entries[].canonical_url | string | https://www.airbnb.com/rooms/569049214818933247 | — |
entries[].room_info | string | Serviced apartment in Kuala Lumpur · ★4.91 · … | — |
entries[].property_type | string | Entire serviced apartment | — |
entries[].room_rating | number | 4.91 | — |
entries[].accuracy_rating | number | 4.94 | — |
entries[].checkin_rating | number | 4.84 | — |
entries[].cleanliness_rating | number | 4.93 | — |
entries[].communication_rating | number | 4.92 | — |
entries[].location_rating | number | 4.84 | — |
entries[].value_rating | number | 4.9 | — |
entries[].guest_satisfaction_overall | number | 4.91 | — |
entries[].visible_review_count | string | 388 | — |
entries[].review_accessibility_label | string | Rated 4.91 out of 5 from 388 reviews. | — |
entries[].pets_allowed | boolean | false | — |
entries[].guest_capacity | integer | 2 | — |
entries[].location | string | Kuala Lumpur | — |
entries[].image_url | string | https://a0.muscache.com/im/pictures/93f9feea-… | — |
entries[].meta_description | string | Dec 1, 2026 · Entire serviced apartment · Loc… | — |
entries[].price_breakdown_title | string | Price details | — |
entries[].price_breakdown_subtitle | null | null | — |
entries[].accessibility_label | string | $435 for 3 nights | — |
entries[].strike_through_price | null | null | — |
entries[].primary_price | string | $145 | — |
entries[].cleaning_fee | string | $25 | — |
entries[].service_fee | string | $61 | — |
entries[].taxes | null | null | — |
entries[].total_price | string | $435 | — |
entries[].booking | string | Available | — |
entries[].bedrooms | string | 1 | — |
entries[].beds | string | 2 | — |
entries[].bathrooms | string | 1 | — |
entries[].cancellation_policy_name | string | Firm | — |
entries[].cancellation_policy_subtitles | array | [1 item] | — |
entries[].check_in_date | string | 2026-12-01 | — |
entries[].check_out_date | string | 2026-12-04 | — |
entries[].url | string | https://www.airbnb.com/rooms/569049214818933247 | — |
Pagination
Section titled “Pagination”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 };}import requests
URL = "https://api.scrapier.io/api/v2/airbnb-price-tracker/"HEADERS = {"X-API-Key": "YOUR_API_KEY"}params = {"url": "https://www.airbnb.com/rooms/569049214818933247"}items = []
for _ in range(10): # each page is one billed call resp = requests.get(URL, headers=HEADERS, params=params, timeout=210) resp.raise_for_status() data = resp.json()["data"] items.extend(data.get("entries") or []) if not data.get("next_cursor"): # None = last page break params = {"cursor": data["next_cursor"]}Errors
Section titled “Errors”Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No — fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No — fix the key | No |
402 | Out of credits (body has balance). | No — top up | No |
404 | Unknown endpoint slug. | No — check the slug | No |
429 / 503 | Busy or throttled. | Yes — after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes — with backoff | No |
- Nothing special: send the inputs, read the result.
Related
Section titled “Related”- Airbnb Listing Search — Structured Airbnb data: send
query. Cursor-paginated, 1 credit per successful call. - Airbnb Occupancy / Availability — Structured Airbnb data: send
room_id. Cursor-paginated, 1 credit per successful call. - Airbnb Reviews Scraper — Structured Airbnb data: send
url. Cursor-paginated, 1 credit per successful call. - Airbnb Room URL Scraper — Structured Airbnb data: send
url. Cursor-paginated, 1 credit per successful call.