Skip to main content

Property Search: New Minimum 1-Record Charge for take=0 Requests

Property Search requests that pass take=0 (count-only requests) are now billed for one record at the resolved dataset rate. Here's what's changing and how to anticipate it on your invoice.

Written by Charles Parra

July 2026

We're updating how the Property Search API bills count-only requests. As of the effective date below, a Property Search request that passes take: 0 to retrieve only counts or summaries is billed for one property record.


What's Changing

Previously, Property Search requests with take: 0 were not billed. Going forward, a take: 0 request is billed for one property record. This does not change billing for any other request: a request with take greater than 0 is still billed only for the property records it returns, and a request that returns no matching properties is not charged.

This applies to both:

  • Synchronous Property Search: POST /property/search

  • Asynchronous Property Search: POST /property/search/async

The per-record charge is still determined by the datasets included in your request. If no dataset can be resolved for a request, the single record is billed at the basic property dataset rate.


Why We're Making This Change

Aggregate-only Property Search requests (counts, summaries, market sizing) still touch the same search infrastructure as a full property pull. As usage of the take: 0 pattern has grown, the infrastructure cost of fulfilling those requests has grown with it. The minimum 1-record charge lets us continue to offer aggregate access at a predictable, dataset-aligned rate.


What You'll See on Your Invoice

Examples of how requests are billed after the change:

Request pattern

Billed records (after change)

Rate

take: 0 with datasets: ["core"]

1

Core dataset rate

take: 0 with datasets: ["basic"]

1

Basic dataset rate

take: 5 returning 3 properties

3

Per-record by dataset

take: 5 returning 0 properties

0 (no charge)

Not billed

If you use take: 0 to retrieve counts or summaries at high volume, you may see new line items on your invoice corresponding to one record per such request.


What You Need to Do

No code changes are required. If you currently use take: 0 for aggregate-only requests, you can keep doing so. Just budget for one billed record per request at the appropriate dataset rate.

If you'd like to confirm the rate that will apply to your usage pattern, contact our team using the links below.


Effective Date

This change is effective July 7, 2026. The one-record charge for take: 0 requests applies to Property Search requests made on or after this date. If you'd like to confirm how it affects your usage, contact support using the links below.


Questions?

Contact our support team at support@batchservice.com or visit https://help.batchdata.io for more information.

Did this answer your question?