# Listings List

**GET** `/v1/listings`

Searches and lists listings with filters, sort, and pagination.

Search and list catalog listings with filters, sorting, and pagination.

## Query Parameters

- `page` (number, optional): Page number for pagination, starting from 1.
- `per_page` (number, optional): Number of records per page. Default is 30, maximum is 100.
- `price_from` (number, optional): Minimum price filter.
- `price_to` (number, optional): Maximum price filter.
- `search_key` (string, optional): Search keyword to match listing title or description.
- `sort` (string, optional): Sort order. Supported values: `relevance`, `price_high_to_low`, `price_low_to_high`, `newest_first`, `oldest_first`.
- `category_id` (number, optional): Category ID to filter listings.
- `account_id` (number, optional): Account ID to filter listings by owner.
- `attribute_value_id` (string, optional): Comma-separated attribute value IDs to filter by attribute selection.