Get Listing Optimizer ranking for a listing

GET

https://api.pricelabs.co/v1/listing_optimizer/ranking

GET

/v1/listing_optimizer/ranking

$ curl -G https://api.pricelabs.co/v1/listing_optimizer/ranking \
>      -H "X-API-Key: {{API_KEY}}" \
>      -d listing_id=123456789

1 {
2   "data": {
3     "listing_id": "123456789",
4     "pms_name": "airbnb",
5     "neighborhood_count": 42,
6     "current_rankings": {
7       "updated_at": "2026-06-25T08:00:00Z",
8       "current_rank_min": 3,
9       "segments": [
10         {
11           "guest_count": 2,
12           "los": "1",
13           "dates": {
14             "2025-06-10": {
15               "rank": 3,
16               "page": 1,
17               "price": 150
18             }
19           }
20         }
21       ]
22     },
23     "ranking_history": [
24       {
25         "guest_count": 2,
26         "los": "1",
27         "dates": [
28           "2025-05-01"
29         ],
30         "ranks": {
31           "rank_1": [
32             3
33           ]
34         }
35       }
36     ]
37   }
38 }

Requires listing_id as a query parameter. pms_name, guest_count, los, and history_start_date remain optional query parameters.

Use guest_count and los to narrow results to a specific segment. Use history_start_date to control how far back the ranking history goes (defaults to 90 days ago; cannot be set earlier than 90 days ago).

Returns competitive ranking data for a single Airbnb listing: current search-result rankings by guest count and length-of-stay segments, the number of competing listings in the neighborhood, and up to 90 days of ranking history. Requires `listing_id` as a query parameter. `pms_name`, `guest_count`, `los`, and `history_start_date` remain optional query parameters. Use `guest_count` and `los` to narrow results to a specific segment. Use `history_start_date` to control how far back the ranking history goes (defaults to 90 days ago; cannot be set earlier than 90 days ago).

Query parameters

listing_idstringRequired

Listing ID of the Airbnb listing.

pms_namestringOptional

PMS name. Defaults to airbnb.

guest_countintegerOptional

Filter ranking segments to this guest count only.

losstringOptional

Filter ranking segments to this length of stay only.

history_start_datedateOptional

Start date for ranking history (YYYY-MM-DD). Cannot be earlier than 90 days ago. Defaults to 90 days ago.

Response

Listing Optimizer ranking retrieved successfully.

dataobject

Listing Optimizer ranking data for the listing.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

Headers

Query parameters

Response

Errors