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
キーワードボリューム
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": {}
}
]
}1 つのキーワードについて、週次および月次のボリューム予測をオンデマンドで取得します。
keyword、matching_type、期間を指定し、regions
と platforms で絞り込みます。
matching_type:exact_matchまたはphrase_match。- 行: 国、プラットフォーム、期間ごとに 1 行です。レスポンスには週次と月次の両方の行が含まれ、
frequency(Week - Monday StartまたはMonth) で区別します。 - プライバシー: ユーザーが 2 人以下のスライスはレスポンスから除外されます。
organization_id: API キーが複数の組織にアクセスできる場合にのみ必須です。どの組織の 1 日あたりの利用枠を消費するかを指定します。
1 日あたりのキーワード利用枠。 各組織は、UTC の 1 日あたり 1,000 件の異なる
キーワードを検索できます。同じ日に既に検索したキーワードを再度検索しても
利用枠は消費されません。上限を超えて新しいキーワードを検索すると、
X-KeywordQuota-*
および Retry-After ヘッダーとともに 429 が返されます。行が返されなかった検索も
利用枠にカウントされます。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"
}'
承認
APIKeyHeaderBearerAuth
ボディ
application/json
利用可能なオプション:
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.
利用可能なオプション:
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.
このページは役に立ちましたか？