Skip to main content
GET
List the organizations that sold in one ZIP
This route serves the dataset under /v3/places/{zip}/sellers. See The dataset for the tier rules.

​
The seller side

The buyers of a ZIP say who buys there. This route says who sells there, and how fast. Each row is an organization on the seller side of a deed of the ZIP. n_sales counts its deeds there. n_quick_resales counts the deeds it held the parcel 29 days or less before. n_same_day counts the deeds of a parcel it bought and sold on one day. median_hold_days is the median over the holds the file knows. The row also carries its first and last sale there and the sum of its prices. The hold of a seller is its own purchase of the parcel, the one whose resale is the deed. A seller whose purchase is not in the file has no hold, and the counts leave it out. The rows are measurements and carry no class: a quick reseller is an organization with a short hold, and the reader decides what that means. period picks the deals of the 12, 24 or 36 months before the data end, or every deal, the default. sort orders by sales (default), quick_resales or last_sale. The page is a keyset page as /v3/buyers.

​
Where the rows come from

Step 14h of the pipeline writes one row for each ZIP, seller organization and period. A page reads one range of that table, and the route reads no deal row and no party row at request time. The route answers 422 fact_unavailable with the fact place_sellers while no served state has the table.

Authorizations

​
Authorization
string
header
required

API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key. The same key works on POST /mcp.

Path Parameters

​
zip
string
required

The 5-digit ZIP of the place.

Pattern: ^\d{5}$

Query Parameters

​
period
enum<string>

The deals the row counts: 12m, 24m or 36m for the deals dated inside 365, 730 or 1095 days before the data end of the deeds, all for every deal. The default is all.

Available options:
all,
12m,
24m,
36m
​
sort
enum<string>

The row order. sales: the most sales in the ZIP first, then the newest. quick_resales: the most quick resales first, then the most sales. last_sale: the newest sale first, an undated organization last, then the most sales. The default is sales. Every sort breaks a tie on the organization id.

Available options:
sales,
quick_resales,
last_sale
​
limit
integer
default:100

Page size, 1-500 (default 100).

Required range: 1 <= x <= 500
​
cursor
string

Opaque cursor from page.next_cursor of the previous page. A change of query, sort, weights or data version invalidates it (400 invalid_cursor). Then restart from page 1.

Required string length: 1 - 4096

Response

The organizations that sold in the ZIP in the period, in the order of the sort, the most sales first by default, one page.

The organizations that sold in the ZIP in the period, in the order of the sort, the most sales first by default, one page.

​
data
object[]
required

The rows of this page.

​
page
object
required

Pagination: the page size, the rows returned and the cursor for the next page. Paged lists carry no total. The summary block does.

​
meta
object
required

Response metadata of the /v3 family: when the API produced it, and the publishes behind the rows.