Advanced Query Patterns

This guide covers advanced API usage patterns for high-performance integrations that need to process large volumes of data efficiently.

Filtering

Use the filter query parameter with operator syntax:

GET /v2/buildings?filter[state]=CA&filter[year_built][gte]=2020&filter[sq_ft][between]=1000,5000

Supported operators: eq, neq, gt, gte, lt, lte, between, in, like.

Pagination

We support both offset and cursor-based pagination:

// Offset pagination\nGET /v2/buildings?page[offset]=100&page[limit]=50\n\n// Cursor pagination (recommended for large datasets)\nGET /v2/buildings?page[after]=cursor_abc123&page[limit]=50

Field Selection

Reduce payload size by requesting only the fields you need:

GET /v2/buildings/bld_123?fields=id,address,coordinates,sq_ft

Batch Operations

Process up to 1,000 items per batch request:

POST /v2/addresses/validate/batch\n{\n "addresses": [\n { "street": "123 Main St", "city": "Austin", "state": "TX" },\n { "street": "456 Oak Ave", "city": "Denver", "state": "CO" }\n ]\n}

Rate Limit Optimization

Batch requests count as a single rate-limited request regardless of batch size. Use batching to maximize throughput within your rate limits.