DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
商品の競合
特定の商品と共通の検索語で競合する Amazon 商品です。limit、offset、offset_token でページングし、最初の数ページを超えたらトークンを使用してください。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。共通の検索語自体が必要な場合は post_dataforseo_labs_amazon_product_kw_overlap_live を使用してください。
料金の参考情報
- 計量方式:レスポンスで報告されるコスト。
- 参考リクエスト見積もり:0.1356 USD。
- 参考顧客乗数:1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- asin型: string
- filters型: array (object | null)[] | null
結果フィルターパラメーターの配列
任意フィールド
複数のフィルターを同時に追加できます(最大 8 個)
条件の間には論理演算子and、orを設定してください
次の演算子がサポートされています:regex、not_regex、<、<=、>、>=、=、<>、in、not_in、ilike、not_ilike、like、not_like、match、not_matchlikeとnot_like、およびilikeとnot_ilikeで%演算子を使用すると、0 文字以上の任意の文字列に一致させられます
例:["full_metrics.amazon_serp.pos_1",">", 20]フィルターの詳細については、Dataforseo Labs のフィルターまたはこちらのヘルプセンターガイドを参照してください
空のオブジェクト - language型: string | null
_code 言語コード
language_nameを指定しない場合は必須フィールド
利用可能な言語とそのlanguage_codeの一覧は、https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesへの別途リクエストで取得できます
例:en - language型: string
_name 言語の正式名称
language_codeを指定しない場合は必須フィールド
利用可能な言語とそのlanguage_nameの一覧は、https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesへの別途リクエストで取得できます
例:English - limit型: integer | null
結果配列内の製品の最大数
任意フィールド
デフォルト値:100
最大値:1000 - location型: integer
_code ロケーションコード
location_nameを指定しない場合は必須フィールド
利用可能なロケーションとそのlocation_codeの一覧は、https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesへの別途リクエストで取得できます
注意: このエンドポイントは現在、米国、エジプト、サウジアラビア、アラブ首長国連邦のロケーションのみをサポートしています
例:2840 - location型: string
_name ロケーションの正式名称
location_codeを指定しない場合は必須フィールド
利用可能なロケーションとそのlocation_nameの一覧は、https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesへの別途リクエストで取得できます
注意: このエンドポイントは現在、米国、エジプト、サウジアラビア、アラブ首長国連邦のロケーションのみをサポートしています
例:United States - offset型: integer | null
返される製品競合の結果配列内のオフセット
任意フィールド
デフォルト値:010を指定すると、結果配列の最初の 10 件の製品競合がスキップされ、後続の製品競合のデータが返されます - order型: array string[] | null
_by 結果の並び替えルール
任意フィールドfilters配列と同じ値を使用して結果を並び替えられます
指定可能な並び替えの種類:asc- 結果を昇順で並び替えますdesc- 結果を降順で並び替えます
並び替えパラメータはカンマで設定します
例:["full_metrics.amazon_serp.pos_1,desc"]
1 回のリクエストで設定できる並び替えルールは 3 つまでです
複数の並び替えルールはカンマで区切ります
例:["full_metrics.amazon_serp.pos_1,desc","avg_position,desc"]
デフォルトのルール:["ranked_serp_element.serp_item.rank_group,asc"] - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_DataforseoLabsAmazonProductCompetitorsLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト(USD)
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_DataforseoLabsAmazonProductCompetitorsLiveTaskInfo
- 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
結果の配列
- asin型: string | null
POST 配列内の ASIN
- items型: array (object | null)[] | null
検出された Amazon 商品の競合他社と関連データを含みます
- asin型: string | null
POST 配列内の ASIN
- avg型: number | null 形式: float
_position Amazon SERP における商品の平均位置
注意: 平均位置はインターセクションのキーワードのみを対象に計算されます
特定の商品の値は、組み合わせるターゲット商品が異なると変わる場合があります - competitor型: object | null · Response36Afe1097B20_AmazonMetricsBundleInfo
_metrics インターセクションのキーワードの指標
指定したasinがターゲットのasinと共有するキーワードに関連するランキングデータ
注意: このオブジェクトのランキングデータは、返された競合他社のasinに対するものです- amazon型: object | null · Response36Afe1097B20_AppMetricsInfo
_paid Amazon 有料 SERP のランキングデータ
- 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 における商品のランキングキーワードの総検索量
- amazon型: object | null · Response36Afe1097B20_AppMetricsInfo
_serp Amazon オーガニック SERP のランキングデータ
- 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 · Response36Afe1097B20_AmazonMetricsBundleInfo
_metrics 商品のすべてのキーワードの指標
指定したasinがランクインしているすべてのキーワードに関連するランキングデータの全体像- amazon型: object | null · Response36Afe1097B20_AppMetricsInfo
_paid Amazon 有料 SERP のランキングデータ
- 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 における商品のランキングキーワードの総検索量
- amazon型: object | null · Response36Afe1097B20_AppMetricsInfo
_serp Amazon オーガニック SERP のランキングデータ
- 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 Amazon SERP における商品の全位置の合計
注意: 平均位置はインターセクションのキーワードのみを対象に計算されます
特定の商品の値は、組み合わせるターゲット商品が異なると変わる場合があります
- items型: integer | null 形式: int64
_count items配列で返される結果の数 - language型: string | null
_code POST 配列内の言語コード
データがない場合、値はnullになります - location型: integer | null
_code POST 配列内のロケーションコード
データがない場合、値はnullになります - 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/amazon/product_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"asin": "019005476X",
"location_code": 2840,
"language_code": "en"
}
]'
{
"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,
"asin": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"asin": null,
"avg_position": null,
"sum_position": null,
"intersections": null,
"competitor_metrics": "[Max Depth Exceeded]",
"full_metrics": "[Max Depth Exceeded]"
}
]
}
]
}
]
}