Example
Property listings: from CSV to API
Keep listings on your site and partner portals consistent.
In short
Use 5 columns with "listing_id" as the key column and address as searchable fields; upload the CSV, check the inferred types, create an API key and query rows over HTTPS.
Example CSV
listing_id,address,bedrooms,price,status
L-501,"12 Elm Road",3,425000,"for sale"
Columns and types
| Column | Type | Example |
|---|---|---|
| listing_id | text | L-501 |
| address | text | 12 Elm Road |
| bedrooms | number | 3 |
| price | number | 425000 |
| status | text | for sale |
Key column: listing_id (unique per row). Searchable: address.
Example query
GET /v1/data/datasets/{id}/records?filter[status]=for%20sale
Authorization: Bearer <your API key>
Your dataset page shows the exact URL.
Step by step
- Upload. Property listings CSV.
- Schema. Key: listing_id.
- Query. Create a key, call it.
Questions and answers
How do I refresh the property listings?
Upload the new file to the same dataset.
Who can read the property listings API?
Only callers with a key you created.