DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Play アプリの競合（ライブ）
特定のアプリと共通のキーワードで競合する Google Play アプリです。limit、offset、offset_token でページングし、最初の数ページを超えたらトークンを使用してください。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。Apple 版は post_dataforseo_labs_apple_app_competitors_live です。重なりの背景にあるキーワードが必要な場合は post_dataforseo_labs_google_app_intersection_live を使用してください。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.1356 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- app型: string
_id アプリの ID
必須フィールド
Google Play 上のモバイルアプリの ID；
ID は Google Play に掲載されているすべてのアプリの URL で確認できます；
例：
URLhttps://play.google.com/store/apps/details?id=org.telegram.messengerの場合
ID はorg.telegram.messengerです - filters型: array (object | null)[] | null
結果フィルターパラメーターの配列
任意フィールド
複数のフィルターを同時に追加できます（最大 8 個）
条件の間には論理演算子and、orを設定してください
次の演算子がサポートされています：<、<=、>、>=、=、<>、in、not_in
例：["intersections",">",500][["competitor_metrics.google_play_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]][[["intersections",">=",50],"and",["competitor_metrics.google_play_search_organic.pos_1","in",[1,5]]],
"or",
["sum_position",">=","10000"]]フィルターの詳細については、Dataforseo Labs - Filters またはこちらの ヘルプセンターガイドを参照してください
空のオブジェクト - language型: string | null
_code 言語コード
language_nameを指定しない場合は必須フィールド
注意：language_nameまたはlanguage_codeのいずれかを指定する必要があります
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能な言語とそのlanguage_codeの一覧を取得できます；
注意：このエンドポイントは現在、英語のみをサポートしています
例：en - language型: string
_name 言語の正式名称
language_codeを指定しない場合は必須フィールド
注意：language_nameまたはlanguage_codeのいずれかを指定する必要があります
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能な言語とそのlanguage_nameの一覧を取得できます；
注意：このエンドポイントは現在、英語のみをサポートしています；
例：English - limit型: integer | null
返されるアプリの最大数
任意フィールド
デフォルト値：100
最大値：1000 - location型: integer
_code ロケーションコード
location_nameを指定しない場合は必須フィールド
注意：location_nameまたはlocation_codeのいずれかを指定する必要があります
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能なロケーションとそのlocation_codeの一覧を取得できます；
注意：このエンドポイントは現在、米国のロケーションのみをサポートしています；
例：2840 - location型: string
_name ロケーションの正式名称
location_codeを指定しない場合は必須フィールド
注意：location_nameまたはlocation_codeのいずれかを指定する必要があります
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能なロケーションとそのlocation_nameの一覧を取得できます；
注意：このエンドポイントは現在、米国のロケーションのみをサポートしています；
例：United States - offset型: integer | null
返されるアプリの結果配列内のオフセット
任意フィールド
デフォルト値：0
値10を指定すると、結果配列内の最初の 10 個のアプリが省略され、後続のキーワードのデータが提供されます - order型: array string[] | null
_by 結果の並べ替えルール
任意フィールドfilters配列と同じ値を使用して結果を並べ替えられます；
指定可能な並べ替えの種類：asc- 結果は昇順で並べ替えられます；desc- 結果は降順で並べ替えられます；
並べ替えの種類を指定するにはカンマを使用してください；
例：["intersections,asc"]
注意：1 回のリクエストで設定できる並べ替えルールは 3 つまでです；
複数の並べ替えルールはカンマで区切ってください；
例：["intersections,desc","sum_position,asc"]デフォルトのルール：
["intersections,desc"]
注意：item_types配列にorganic以外のアイテムタイプが含まれている場合、結果は配列内の最初のアイテムタイプ順に並べられます - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- app型: string | null
_id POST 配列内のアプリの ID
- items型: array (object | null)[] | null
app_idと競合アプリに関連するデータを含みます- app型: string | null
_id POST 配列内のアプリの ID
- avg型: number | null 形式: float
_position Google Play SERP におけるアプリの平均位置
注意: 平均位置はインターセクションのキーワードのみを対象に計算されます
特定のアプリの値は、組み合わせるターゲットアプリが異なると変わる場合があります - competitor型: object | null
_metrics インターセクションのキーワードの指標
POST リクエストで指定した競合アプリが対象アプリと共有するキーワードに関連するランキングデータ
注意: この配列のランキングデータは、返された競合他社のapp_idに対するものです- property型: object · Response36Afe1097B20_AppMetricsInfo
Name - count型: integer | null 形式: int64
その商品を含む Amazon オーガニック SERP の総数
- pos型: integer | null
_1 商品が #1 にランクインしているオーガニック SERP の数
- pos型: integer | null
_11 _100 商品が #11-100 にランクインしているオーガニック SERP の数
- pos型: integer | null
_2 _3 商品が #2-3 にランクインしているオーガニック SERP の数
- pos型: integer | null
_4 _10 商品が #4-10 にランクインしているオーガニック SERP の数
- search型: integer | null 形式: int64
_volume オーガニック SERP における商品のランキングキーワードの総検索量
- full型: object | null
_metrics アプリのすべてのキーワードの指標
指定したapp_idがランクインしているすべてのキーワードに関連するランキングデータの全体像- property型: object · Response36Afe1097B20_AppMetricsInfo
Name - count型: integer | null 形式: int64
その商品を含む Amazon オーガニック SERP の総数
- pos型: integer | null
_1 商品が #1 にランクインしているオーガニック SERP の数
- pos型: integer | null
_11 _100 商品が #11-100 にランクインしているオーガニック SERP の数
- pos型: integer | null
_2 _3 商品が #2-3 にランクインしているオーガニック SERP の数
- pos型: integer | null
_4 _10 商品が #4-10 にランクインしているオーガニック SERP の数
- search型: integer | null 形式: int64
_volume オーガニック SERP における商品のランキングキーワードの総検索量
- intersections型: integer | null
インターセクションのキーワード数
- se型: string | null
_type 検索エンジンの種類
- sum型: integer | null
_position Google Play SERP におけるアプリの全位置の合計
注意: 合計位置はインターセクションのキーワードのみを対象に計算されます
特定のアプリの値は、組み合わせるターゲットアプリが異なると変わる場合があります
- items型: integer | null 形式: int64
_count items配列で返される結果の数 - language型: string | null
_code POST 配列内の言語コード
- location型: integer | null
_code POST 配列内のロケーションコード
- se型: string | null
_type 検索エンジンの種類
- total型: integer | null 形式: int64
_count 当社データベース内のリクエストに関連する結果の総数
- 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/dataforseo_labs/google/app_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_id": "org.telegram.messenger",
"language_name": "English",
"location_code": 2840,
"limit": 10
}
]'
{
"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": [
{
"se_type": null,
"app_id": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"app_id": null,
"avg_position": null,
"sum_position": null,
"intersections": null,
"competitor_metrics": null,
"full_metrics": null
}
]
}
]
}
]
}