Get Listing Optimizer summary | PriceLabs

Use this endpoint first to get a portfolio-wide overview, then call /v1/listing_optimizer/report for a detailed breakdown of individual listings.

Supports optional subscribed, status, and listing_ids query parameters to filter the returned listings.

Returns Listing Optimizer scores for all active Airbnb listings in the account. Each entry includes the overall score, status, and basic listing info. If the account does not have an optimizer report, `has_optimizer_report` will be `false` and `listings` will be empty. Use this endpoint first to get a portfolio-wide overview, then call `/v1/listing_optimizer/report` for a detailed breakdown of individual listings. Supports optional `subscribed`, `status`, and `listing_ids` query parameters to filter the returned listings.

Query parameters

subscribedbooleanOptional

Filter to listings with (true) or without (false) an active PriceLabs subscription.

statusenumOptional

Filter to listings with this optimizer status. One of pending, processing, completed, error, delisted, archived, deleted.

listing_idslist of integersOptional

Filter to specific listing IDs. Pass as repeated bracketed params, e.g. listing_ids[]=1&listing_ids[]=2.

Response

Listing Optimizer summary retrieved successfully.

dataobject

Errors

401

Unauthorized Error

1	{
2	"data": {
3	"has_optimizer_report": true,
4	"listings": [
5	{
6	"listing_id": "123456789",
7	"pms_name": "airbnb",
8	"listing_name": "Sunset Villa",
9	"status": "completed",
10	"analyzed_at": "2026-06-20T10:00:00Z",
11	"overall_score": 7.85,
12	"city": "Miami",
13	"state": "Florida",
14	"subscribed": true,
15	"subscription_end": "2026-07-20",
16	"can_rerun": true,
17	"manual_reruns_remaining": 2
18	}
19	]
20	}
21	}

$	curl https://api.pricelabs.co/v1/listing_optimizer/summary \
>	-H "X-API-Key: {{API_KEY}}"

Headers

Query parameters

Response

Errors