Search listings

get

https://api.livfinder.com/v1/public/listings

Two pagination modes coexist: pass cursor for the infinite-scroll marketplace grid, or page for numbered pagination. Omit both to get page 1.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

category

string

length ≤ 40

A root category slug, e.g. real-estate, cars, yachts, jets, helicopters, real-estate-developments.

listingType

string

length ≤ 40

propertyType

string

length ≤ 80

type

string

length ≤ 80

transactionType

string

length ≤ 20

purpose

string

length ≤ 20

country

string

length ≤ 120

state

string

length ≤ 120

city

string

length ≤ 120

area

string

length ≤ 120

community

string

length ≤ 120

subcommunity

string

length ≤ 120

location

Repeatable — one or more location slugs/ids.

minPrice

number

≥ 0

maxPrice

number

≥ 0

priceMin

number

≥ 0

priceMax

number

≥ 0

currency

string

length ≤ 3

keyword

string

length ≤ 120

string

length ≤ 120

sort

string

enum

featured

string

length ≤ 6

verified

string

length ≤ 6

exclusive

string

length ≤ 6

make

string

length ≤ 120

brand

string

length ≤ 120

manufacturer

string

length ≤ 120

model

string

length ≤ 120

collection

string

length ≤ 120

organizationId

integer

≥ 1

agentId

integer

≥ 1

project

string

length ≤ 220

A project's public ULID or slug (never its internal numeric id).

bedrooms

beds

bathrooms

baths

page

integer

≥ 1

Defaults to 1

pageSize

integer

≥ 1

Defaults to 20

cursor

integer

0 to 100000

(category-specific facet keys)

string

length ≤ 120

Any other key (e.g. furnishing, completionStatus, ownershipType, bedrooms) is accepted as an additional single-value string filter from the category's own filter registry; repeating one of these returns 422 VALIDATION_ERROR.

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A page or cursor slice of matching listings.

422One or more fields are invalid.