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": {}
}
]
}Volúmenes de prompts
Volumen de palabras clave
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": {}
}
]
}Proyecciones de volumen semanales y mensuales para una palabra clave, consultadas bajo demanda.
Pasa un
keyword, un matching_type y un rango de fechas; acota con regions
y platforms.
matching_type:exact_matchophrase_match.- Filas: una por país, plataforma y período. La respuesta tiene filas semanales y mensuales;
frequencylas distingue (Week - Monday StartoMonth). - Privacidad: los segmentos con dos usuarios o menos se omiten de la respuesta.
organization_id: obligatorio solo cuando tu clave de API tiene acceso a más de una organización. Selecciona la organización cuya cuota diaria usa la consulta.
Cuota diaria de palabras clave. Cada organización puede consultar 1,000 palabras clave
distintas por día UTC. Repetir una palabra clave que ya consultaste ese día
es gratis. Una palabra clave nueva que supere el límite devuelve
429 con los encabezados X-KeywordQuota-*
y Retry-After. Una consulta que no devuelve filas también cuenta
para la cuota.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"
}'
Autorizaciones
APIKeyHeaderBearerAuth
Cuerpo
application/json
Opciones disponibles:
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.
Opciones disponibles:
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.
¿Esta página le ayudó?