Limits and Pagination for the Intent API

The Demandbase Intent API enforces request limits, date ranges, pagination, and sorting rules to help maintain query performance. Limits vary between the Company Intent and Keyword Sets endpoints.

Company Intent Request Limits

The Company Intent endpoint supports the following 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 date range
`pageSize`	1–100; default 25

Important:

startDate and endDate are required.
You must include at least one of companyIds, keywordSetIds, or keywords.

Company Intent Pagination

During the beta, the Company Intent endpoint returns only the first page of matching results.

pageSize: Specifies the number of records to return, from 1 to 100. The default is 25.
pagination.totalCount: Indicates the total number of matching records, including those not returned in the response.
pageToken: Not supported during the beta. Including a value returns error 400-232.

Important: To retrieve records beyond the first page, narrow your filters or shorten the date range.

Company Intent Sorting

Use sortBy and sortOrder to control the order of Company Intent results.

Parameter	Supported Values
`sortBy`	`startDate`, `endDate`, `intentStrength`, `numPeopleResearching`, `trendingScore`
`sortOrder`	`ASC, DESC`

By default, results are sorted by endDate DESC, with the most recent end dates first.

Keyword Set Limits

The Keyword Sets endpoints enforce the following limits.

Parameter	Limit
Keyword sets per tenant	10 (default)
Keywords per keyword set	300 (default)
Seed URLs per keyword set	2 (default)
`name`	1–255 characters after trimming
`keyword`	1–255 characters after trimming
`seedUrl`	Up to 255 characters

Important:

The limits for keyword sets, keywords, and seed URLs are configurable by tenant. If a request exceeds a configured limit, the API rejects the request and returns an error message indicating the applicable limit.
Contact Demandbase Support to request higher limits.
Keyword Sets endpoints do not consume API credits.

Keyword Sets Pagination

The Keyword Sets list endpoints support page-based pagination.

Parameter	Description
`page`	Page number, starting at 1. Default is 1.
`perPage`	Number of results per page, from 1 to 500. Default is 25.

Responses include the following pagination fields:

pageNo: Current page number.
pageSize: Number of results requested per page.
totalCount: Total number of matching records.

If you request a page beyond the last available page, the API returns 200 OK with an empty array.

Intent API Request Rate Limits

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

If you receive a 429 Too Many Requests error:

Review the response message for details.
Reduce the number of concurrent requests.
Retry using exponential backoff with jitter.
If the error persists, contact Demandbase Support and provide the responsediagnosticCode.