---
title: "競合サイト抽出"
method: POST
path: "/v1/competitive"
tags: ["獲得キーワード調査"]
---

# 競合サイト抽出

`POST /v1/competitive`

競合サイト抽出。

指定ドメインのSEOランクインキーワードが重複しているサイトを最大20件抽出する。
競合サイトを把握するのに有用。

キーワード重複率・推定流入数・集客価値・キーワード数・ページ数などの指標で競合サイトを比較分析できる。

当機能で発見したサイトのSEO流入キーワードを調査したい場合はPOST /v1/influx-keywordsを、
主要なSEO流入を獲得しているページを調査したい場合はPOST /v1/influx-pagesを使う。

1リクエストあたり4.5クレジットを消費。

## Request body

- CompetitiveDto
  - `url` string, required — 競合分析を行う対象のドメインURL。対象サイトの競合サイトを抽出し、キーワード重複率や流入数などの指標を比較する。
  - `sortBy` 'duplicate' | 'duplicateRate' | 'competitorUnique' | 'targetUnique' | 'etv' | 'keywordCount' | 'trafficValue' | 'pageCount' — ソート項目。duplicate / duplicateRate / competitorUnique / targetUnique / etv / keywordCount / trafficValue / pageCount。省略時は etv。
  - `orderBy` 'asc' | 'desc' — ソート順。asc: 昇順 / desc: 降順。省略時は desc。

## Response `200`

検索成功

- CompetitiveResponseDto
  - `result` boolean, required — API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required — リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required — このリクエストで消費されたクレジット数。
  - `data` object, required — 競合サイト抽出結果データ
    - `query` object, required — リクエストで指定されたクエリ情報
      - `targets` string[], required — 競合サイト抽出の対象URLまたはドメイン一覧
    - `summary` object, required — 件数サマリー（全体件数とレスポンスに含まれる件数）
      - `totalCount` number, required — 取得対象全体の件数
      - `returnedCount` number, required — このレスポンスに含まれている件数
    - `items` object[], required — 競合サイト抽出結果のリスト。各アイテムにサイト情報と各種指標を含む。
      - `site` object, required — 競合サイト情報（ドメイン・タイトル）
        - `domain` string, required — 競合サイトのドメイン名
        - `title` string, required — 競合サイトのタイトル。SERP データから取得できない場合は空文字。
      - `metrics` object, required — 競合サイトの各種指標（流入数・集客価値・キーワード数・重複率など）
        - `estimatedTraffic` number, required — 競合サイト全体の推定検索流入数（月間）
        - `trafficValue` number, required — 競合サイト全体の集客価値（USD）。推定流入数×CPC で算出される広告換算価値。
        - `keywordCount` number, required — 競合サイトが獲得しているキーワード数
        - `pageCount` number, required — 競合サイトのインデックスされたページ数
        - `duplicateKeywordCount` number, required — 入力対象サイトと競合サイトで重複しているキーワード数
        - `duplicateRate` number, required — 重複キーワード率。0〜1 で表し、高いほど入力対象とのキーワード重複率が高い。
        - `competitorUniqueKeywordCount` number, required — 競合サイトにのみ存在し、入力対象サイトには存在しないキーワード数
        - `targetUniqueKeywordCount` number, required — 入力対象サイトにのみ存在し、競合サイトには存在しないキーワード数
  - `errors` string[], required — エラーメッセージの配列。正常時は空配列。

## Other responses

- `400` — バリデーションエラー
- `402` — クレジット不足
- `403` — 認証エラー
- `429` — レート制限超過
- `500` — Internal Server Error
- `503` — Service Unavailable - データベース接続エラーなど

---

[API](https://skmtc.dev/rakkokeyword/apis/api.md) · [All operations](https://skmtc.dev/rakkokeyword/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rakkokeyword/api/revisions/23e921f5f25c/schema)