Rate limit

Total API Requests

Your total API requests are governed by the specifics of your current Pubrio plan. To understand your monthly request limits, be sure to check out Pubrio’s API pricing details. Pubrio employs a fixed-window rate limiting approach for API calls. For example,

Subscription	API Call (Per Hour)	API Call (Per Day)	API Call (Per Month)
Free	`60`	`1,440`	`44,640`
Growth	`6,000`	`144,000`	`4,464,000`
Business	`60,000`	`1,440,000`	`44,640,000`
Organization	`Custom`	`Custom`	`Custom`

API calls are consumption based, which means if you have multiple users in the same profile (i.e. organization), the API calls will be a multiple of the number of user licences.

The Pubrio API has a rate limit to ensure the stability and reliability of the service. It has a fixed window rate limit of 3,000 requests per minute. This is a soft limit and can be adjusted based on your specific use case; please let the support team know if you have any particular requirements. When you exceed the rate limit, you will receive a 429 response code.

Checking your usage

Call Profile Usage to read your current consumption and ceilings without guessing from the table above.

Field	Meaning
`api_hourly_usage` / `api_daily_usage` / `api_monthly_usage`	API calls consumed in the current window
`max_api_hourly_query` / `max_api_daily_query` / `max_api_monthly_query`	Your plan’s per-licence ceiling for each window
`total_max_api_hourly_query` / `total_max_api_daily_query` / `total_max_api_monthly_query`	The per-licence ceiling multiplied by your seat count — the limit that actually applies to the workspace
`api_last_refreshed`	When the counters were last rolled over

The same four groups exist with a portal_ prefix for dashboard usage, which is metered separately from API usage.

Compare api_monthly_usage against total_max_api_monthly_query, not max_api_monthly_query — the total_ figures already account for the licence multiplier described above.

Plan limits

Every ceiling that can reject a request is returned by Profile under subscription. Read them rather than hard-coding values — they differ by plan.

Field	Governs
`max_search_per_page`	Largest `per_page` accepted. Exceeding it returns HTTP 416 (`41676`, or `41613` on company and people search)
`max_search_page`	Highest `page` accepted on most searches
`max_company_search_page`	Highest `page` accepted on company search specifically
`max_display_search_page`	Page count reported back in `pagination.total_display_pages`
`max_company_search_select_limit` / `max_people_search_select_limit`	Largest `select_size` for bulk selection
`max_export_limit` / `max_statistic_export_limit`	Row ceiling for exports
`max_record_upload_size`	Largest accepted upload
`max_expansion_window_days`	Widest date window on expansion endpoints (`null` = unlimited)
`max_expansion_markets_preview`	Markets returned before `other_markets_locked_count` truncates (`null` = unlimited)
`max_expansion_comparison_peers`	Peers returned by expansion comparison (`null` = unlimited)

A limit breach is HTTP 416, not 400, and the result set is never silently clamped — the request fails outright. See Status Codes.

API Documentation

Endpoint

Rate limit

Total API Requests

Rate limit

Checking your usage

Plan limits

​Total API Requests

​Rate limit

​Checking your usage

​Plan limits

Total API Requests

Rate limit

Checking your usage

Plan limits