API Reference

Documentation

Everything you need to integrate Vitki Data's real estate API into your application.

Base URL

All API requests use the following base URL:

https://api.vitkidata.com/api/v1

All endpoints require HTTPS. HTTP requests are rejected.

Authentication

Authenticate every request by including your API key in the X-Api-Key header. API keys use the vtk_live_ prefix.

curl "https://api.vitkidata.com/api/v1/properties?state=TX&city=Austin" \ -H "X-Api-Key: vtk_live_your_key_here"

You receive your API key on the checkout success page immediately after purchase. Store it securely — it is shown only once.

Rate Limits

Rate limits depend on your subscription tier:

Tier Requests Monthly Quota Notes
Starter (no card) 5 req/min 50 / mo Permanent
Starter 15 req/min 2,500 / mo
Pro 60 req/min 10,000 / mo
Enterprise 200 req/min 50,000 / mo

When you exceed the rate limit, the API returns 429 Too Many Requests with a Retry-After header indicating how many seconds to wait.

Error Format

All errors return a consistent JSON structure:

{ "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded. Try again in 30 seconds.", "status": 429 }, "meta": { "timestamp": "2026-04-21T12:00:00.000Z" } }
StatusCodeMeaning
400VALIDATION_ERRORInvalid request parameters
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENTier doesn't have access to this resource
404NOT_FOUNDResource not found
429RATE_LIMIT_EXCEEDEDToo many requests
500INTERNAL_ERRORServer error — contact support

Pagination

List endpoints support limit and offset query parameters for pagination.

ParameterTypeDefaultRange
limitinteger251–100
offsetinteger00+

Responses include total, limit, and offset fields so you can calculate the number of pages.

{ "data": { "properties": [...], "total": 847, "limit": 25, "offset": 50 }, "meta": { "timestamp": "..." } }

Tier-Gated Fields

Some response fields are only available on higher tiers:

Field GroupStarterProEnterprise
Address, price, beds, baths, sqftYesYesYes
Listing status & property typeYesYesYes
Price history & tax historyYesYes
Government enrichment (48 fields)YesYes
Data quality & confidence scoresYesYes
Raw recordYes