curl -X POST https://api.tryprofound.com/v2/prompt-volumes/intents/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": [
{
"main_classification": "<string>",
"sub_category_classification": "<string>",
"pct_conversation": 123
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Prompt Volumes
Keyword Intent Shares
Intent shares for one keyword across the requested cohort weeks.
Shares are fractions from 0 to 1. Cohorts with two or fewer matching users are omitted for privacy. Doesn’t use the daily keyword allowance.
POST
/
v2
/
prompt-volumes
/
intents
/
on-the-fly
curl -X POST https://api.tryprofound.com/v2/prompt-volumes/intents/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": [
{
"main_classification": "<string>",
"sub_category_classification": "<string>",
"pct_conversation": 123
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}The mix of user intents behind conversations that match one keyword,
averaged across the weeks in your date range. Takes the same
keyword,
matching_type, date range, regions, and platforms as
Keyword Volume.
- Rows: one per intent, with
main_classification, an optionalsub_category_classification, andpct_conversation. pct_conversationis a fraction from 0 to 1 of the classified matching conversations. Multiply by 100 for a percentage.- Privacy: weeks with two or fewer matching users are left out.
This endpoint doesn’t use your daily keyword allowance. It shares a burst
rate limit with Keyword Volume.
curl -X POST https://api.tryprofound.com/v2/prompt-volumes/intents/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
Query for on-the-fly intent shares for a single keyword.
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 Was this page helpful?