Limits and Pagination

The Intent API validates request size, date ranges, pagination, and sorting to keep queries responsive.

Request limits

Parameter	Limit
`companyIds`	Up to 10 values
`keywordSetIds`	Up to 10 values
`keywords`	Up to 50 values
`startDate` to `endDate`	Maximum 12-month window
`pageSize`	1–100; default 25

startDate and endDate are required. Include at least one of companyIds, keywordSetIds, or keywords.

Cursor pagination

Responses include a pagination object:

after: token for the next page; null when there is no next page
before: token for the previous page; null on the first page
totalCount: total number of matching records

Pass an after or before value back as pageToken to retrieve the corresponding page. Treat page tokens as opaque strings and do not modify or decode them.

Sorting

Supported sortBy values are startDate, endDate, intentStrength, numPeopleResearching, and trendingScore. Supported sortOrder values are ASC and DESC.

The default sort is endDate DESC.

Request-rate guidance

The Intent API does not currently publish a standalone fixed requests-per-minute limit. Access may still be subject to your account entitlements and platform protections.

If you receive 429 Too Many Requests, inspect the response message, reduce concurrency, and retry with exponential backoff and jitter. If the error persists, contact Demandbase Support and include the response diagnosticCode.