curl -X POST https://api.tryprofound.com/v2/prompt-volumes/volume/on-the-fly \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"keyword": "ai search optimization",
"matching_type": "phrase_match",
"start_date": "2026-08-01",
"end_date": "2026-08-31"
}'
{
"info": {
"total_rows": 123,
"truncated": false,
"query": {}
},
"data": [
{
"country_code": "<string>",
"platform": "<string>",
"matching_type": "<string>",
"frequency": "<string>",
"date": "2023-12-25",
"volume": 123
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Prompt Volumes
Keyword Volume
Weekly and monthly volume projections for one keyword.
Each organization can look up 1,000 distinct keywords per UTC day; over the cap returns 429 with Retry-After. Slices with two or fewer users are omitted for privacy.
POST
/
v2
/
prompt-volumes
/
volume
/
on-the-fly
curl -X POST https://api.tryprofound.com/v2/prompt-volumes/volume/on-the-fly \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"keyword": "ai search optimization",
"matching_type": "phrase_match",
"start_date": "2026-08-01",
"end_date": "2026-08-31"
}'
{
"info": {
"total_rows": 123,
"truncated": false,
"query": {}
},
"data": [
{
"country_code": "<string>",
"platform": "<string>",
"matching_type": "<string>",
"frequency": "<string>",
"date": "2023-12-25",
"volume": 123
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Weekly and monthly volume projections for one keyword, looked up on demand.
Pass a
keyword, a matching_type, and a date range; narrow with regions
and platforms.
matching_type:exact_matchorphrase_match.- Rows: one per country, platform, and period. The response has both weekly and monthly rows;
frequencytells them apart (Week - Monday StartorMonth). - Privacy: slices with two or fewer users are left out of the response.
organization_id: required only when your API key has access to more than one organization. It picks the organization whose daily allowance the lookup uses.
Daily keyword allowance. Each organization can look up 1,000 distinct
keywords per UTC day. Repeating a keyword you already looked up that day
is free. A new keyword over the cap returns
429 with X-KeywordQuota-*
and Retry-After headers. A lookup that returns no rows still counts
toward the allowance.curl -X POST https://api.tryprofound.com/v2/prompt-volumes/volume/on-the-fly \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"keyword": "ai search optimization",
"matching_type": "phrase_match",
"start_date": "2026-08-01",
"end_date": "2026-08-31"
}'
Authorizations
APIKeyHeaderBearerAuth
Body
application/json
Available options:
exact_match, phrase_match ISO 3166-1 alpha-3 country codes (e.g. USA). Omit to include every region.
Platforms to restrict to. Omit to include every platform.
Available options:
chatgpt.com, gemini.google.com, perplexity.ai Organization whose daily keyword allowance is used. Required in the JSON request body for API keys with multiple organizations that have API access. If omitted or null, defaults to the API key's sole organization with API access or the token's active organization. For OAuth/M2M tokens, any supplied organization_id must match the token's organization.
Was this page helpful?