Skip to main content
POST
Fetch a bounded batch of Zillow listing details
RealtyCrawl fetches 1–5 unique numeric Zillow ZPIDs sequentially, using the existing source cost ceiling per request. This operation is documentation-backed beta; expanded selectors have not received fresh live acceptance.
Reserve 50 credits per requested ID. Successful details cost 50 credits each; failed or undispatched items cost zero. Each outcome contains native_id, status, listing or null, and a sanitized error_code. Partial results are explicit. A shared 50-second dispatch deadline stops further work; unfinished/undispatched items report BATCH_DEADLINE_EXCEEDED. No automatic retry occurs. Retry only failed IDs deliberately. Idempotency-Key replays the original settled response without new source calls or charges. Details and available sections are retained for 24 hours. This does not promise complete inventory, valuations or verified sales.

Authorizations

x-api-key
string
header
required

Query Parameters

fields
string

Response-only comma-separated field paths relative to data items; up to 32 paths. Source requests and billing are unchanged.

Maximum string length: 4127
format
enum<string>
default:json

Response-only export format. JSON retains the envelope; CSV/NDJSON contain data records, with request/credit metadata in headers. Errors stay JSON.

Available options:
json,
csv,
ndjson

Body

application/json
native_ids
string[]
required
Required array length: 1 - 5 elements
Pattern: ^[1-9][0-9]{0,14}$
transaction
enum<string>
default:sale
Available options:
sale,
rent
status
enum<string>
default:active
Available options:
active,
sold

Response

Source observation; inspect meta for evidence and completeness.

data
object[]
required
meta
object
required