DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google App List タスクの設定
Google Play 自身のキュレーションコレクション（無料上位、売上上位、トレンド）の 1 つを app_collection で選んでキューに登録し、タスク id を返します。depth はチャートをどこまで読むかを制限します。非同期です。送信すると tasks[0].id にタスク id が返り、フェッチツールは準備ができ次第結果を返します。get_dataforseo_app_google_app_list_fetch で取得します。これはチャート表示です。キーワード検索には post_dataforseo_app_google_app_searches_submit を使用してください。
料金の参考情報
- 計測方法: 報告されたレスポンスコスト。
- 参考リクエスト見積もり: 0.012 USD。
- 参照用の顧客乗数: 1.0。確定済みの顧客金額に再度適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- age型: string | null
_rating 年齢レーティングで結果をフィルタリング
任意フィールド
このフィールドを使用して、年齢レーティングで結果をフィルタリングできます；
指定可能なフィルタリングの種類：ages_up_to_5— 5 歳以下の子ども向けに承認されたアプリを返します；ages_6_8— 6〜8 歳の子ども向けに承認されたアプリを返します；ages_9_12— 9〜12 歳の子ども向けに承認されたアプリを返します；
デフォルトでは、API は全年齢向けのアプリを返します；
注意：このフィルターは"category": "family"パラメーターと組み合わせて使用した場合にのみ機能します - app型: string | null
_category Google Play のアプリケーションカテゴリ
任意フィールド
アプリのカテゴリで結果をフィルタリングできます；
例：family；
利用可能なカテゴリの完全なリストは、https://api.dataforseo.com/v3/app_data/google/categoriesに個別にリクエストして取得できます
注意：app_collectionパラメーターがfeaturedに設定されている場合、app_categoryは使用できません - app型: string
_collection アプリコレクション
必須フィールド
アプリを収集する Google Play 上のアプリコレクション；
次の値を指定できます：featured、topselling_paid、topselling_free、topselling_new_free、topselling_new_paid、topgrossing、movers_shakers
注意：featuredを選択した場合、app_categoryパラメーターは使用できません - depth型: integer | null
- language型: string
_code 検索エンジンの言語コード
language_nameを指定しない場合は必須フィールド
このフィールドを使用する場合、language_nameを指定する必要はありませんlanguage_codeを付した利用可能な言語のリストは、https://api.dataforseo.com/v3/app_data/google/languagesに個別にリクエストして取得できます
例：en - language型: string
_name 検索エンジンの言語の正式名
language_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、language_codeを指定する必要はありませんlanguage_nameを付した利用可能な言語のリストは、https://api.dataforseo.com/v3/app_data/google/languagesに個別にリクエストして取得できます
例：English - location型: integer
_code 検索エンジンの所在地コード
location_nameを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameを指定する必要はありませんlocation_codeを付した検索エンジンの利用可能な所在地のリストは、https://api.dataforseo.com/v3/app_data/google/locationsに個別にリクエストして取得できます
例：9061121 - location型: string
_name 検索エンジンの所在地の正式名
location_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、location_codeを指定する必要はありませんlocation_nameを付した検索エンジンの利用可能な所在地のリストは、https://api.dataforseo.com/v3/app_data/google/locationsに個別にリクエストして取得できます
例：West Los Angeles,California,United States - pingback型: string | null
_url 完了したタスクの通知 URL
任意フィールド
タスクが完了すると、指定した URL に GET リクエストを送信して通知します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストを送信する前に必要な値を設定します。
例：http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
注意：pingback_urlの特殊文字は URL エンコードされます；
たとえば、#文字は%23にエンコードされます - postback型: string
_data postback_url のデータ型
postback_urlを指定する場合は必須フィールド
サーバーに送信されるデータ型に対応します
指定可能な値：advanced、html - postback型: string | null
_url タスク結果を送信する URL
任意フィールド
タスクが完了すると、結果をgzip形式で圧縮し、指定したpostback_urlに POST リクエストで送信します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストを送信する前に必要な値を設定します。
例：http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
注意：postback_urlの特殊文字は URL エンコードされます；
たとえば、#文字は%23にエンコードされます - priority型: integer | null
- tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_AppDataGoogleAppListTaskPostResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_AppDataGoogleAppListTaskPostTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: object | null
結果の配列
この場合、値はnullになります - result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_list/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_collection": "topselling_free",
"location_code": 2840,
"language_code": "en",
"depth": 100
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}