---
title: "集客コンテンツ検索"
method: POST
path: "/v1/content-search"
tags: ["集客コンテンツ検索"]
---

# 集客コンテンツ検索

`POST /v1/content-search`

集客コンテンツ検索。

指定キーワードをタイトル/ディスクリプション/主なSEO流入キーワードに含むWEBページを検索する。
寄稿/広告掲載先探しや、参考記事探し・競合コンテンツの把握に使う。

最大5,000件取得。各ページの推定流入数・集客価値・ランクインキーワード数・トップキーワードなどのSEO指標を返す。
SEO指標は最新でない可能性がある。
この指標を重要視する用途なら、データ取得後にPOST /v1/search-volumeで最新のSEO指標を取得すること。

topKeywordCollapseをtrueにした際のトップキーワードには、元キーワードをタイトル/ディスクリプションに含むページが、SEO流入を獲得している主要なキーワードが重複無しで抽出される。
検索意図の近いキーワードを探したり、弱いサイトが意図せずランクインしているニッチキーワードを抽出したりするのに役立つ。

当機能で発見したページの、2位以降のSEO流入キーワードを確認したい場合はPOST /v1/influx-keywordsをmatchType=urlで使う。

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

## Request body

- ContentSearchDto
  - `keyword` string, required — 集客コンテンツ検索の検索キーワード。指定キーワードに関連する上位表示コンテンツを検索する。1文字以上の文字列を指定する。
  - `searchTarget` 'title' | 'keyword' | 'description' | 'titleAndKeyword' | 'titleAndKeywordAndDescription' — 検索対象。title / keyword / description / titleAndKeyword / titleAndKeywordAndDescription。省略時は titleAndKeywordAndDescription。
  - `isAdvancedSearch` boolean — 拡張検索の有効/無効。true にするとキーワードを形態素解析して検索精度を高める。省略時は true。
  - `topKeywordCollapse` boolean — トップキーワード除去の有効/無効。true にすると同一トップキーワードの重複を除去する。省略時は false。
  - `filter` object — 結果のフィルタリング条件。推定流入数・ランクインキーワード数・集客価値・タイトル・URL・トップキーワード・ディスクリプション・SEO難易度で絞り込む。
    - `estimatedTraffic` object — 推定流入数フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `rankingKeywordCount` object — ランクインキーワード数フィルタ（0〜の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `trafficValue` object — 集客価値（USD）フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `title` object — タイトルフィルタ（含む/含まないキーワード指定）
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `url` object — URLフィルタ（含む/含まないURL指定）
      - `includes` string[] — 含むURLのリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まないURLのリスト（複数入力時はOR）
    - `topKeyword` object — トップキーワードフィルタ（含む/含まないキーワード指定）
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `description` object — ディスクリプションフィルタ（含む/含まないキーワード指定）
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `seoDifficulty` object — SEO難易度フィルタ（0〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
  - `sortBy` 'estimatedTraffic' | 'trafficValue' | 'rankingKeywordCount' — 結果のソート項目。estimatedTraffic / trafficValue / rankingKeywordCount。省略時は trafficValue。
  - `orderBy` 'asc' | 'desc' — ソート順。asc: 昇順 / desc: 降順。省略時は desc。
  - `limit` integer — 取得件数。1〜5000 の整数を指定する。省略時は 100。

## Response `200`

検索成功

- ContentSearchResponseDto
  - `result` boolean, required — API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required — リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required — このリクエストで消費されたクレジット数。
  - `data` object, required — 集客コンテンツ検索結果データ
    - `query` object, required — リクエストで指定された検索クエリ情報
      - `keyword` string, required — 集客コンテンツ検索の元になった検索キーワード
    - `summary` object, required — 件数サマリー（全体件数とレスポンスに含まれる件数）
      - `totalCount` number, required — 取得対象全体の件数
      - `returnedCount` number, required — このレスポンスに含まれている件数
    - `items` object[], required — 集客コンテンツ検索結果のリスト。各アイテムにページ情報・指標・トップキーワードを含む。
      - `page` object, required — ページ情報（ドメイン・URL・タイトル・ディスクリプション）
        - `domain` string, required — ページのドメイン名
        - `url` string, required — ページの完全なURL
        - `title` string, required — ページのタイトル
        - `description` string, required — ページの説明文
      - `metrics` object, required — ページの各種指標（推定流入数・集客価値・ランクインキーワード数）
        - `estimatedTraffic` number, required — このページの推定検索流入数（月間）
        - `trafficValue` number, required — このページの集客価値（USD）。推定流入数×CPC で算出される広告換算価値。
        - `rankingKeywordCount` number, required — このページでランクインしているキーワード数
      - `topKeyword` object, required — トップキーワード情報（キーワード・単語数・順位・指標）
        - `keyword` string, required — このページで最もSEO流入を獲得しているトップキーワード
        - `wordCount` number, required — トップキーワードを構成する単語数（スペース区切り）
        - `position` number, required — トップキーワードでの検索順位
        - `metrics` object, required — トップキーワードの各種指標（SEO難易度・月間検索数）
          - `seoDifficulty` number, nullable, required — SEO難易度。1–100で表し、高いほど難易度が高い（1–33:低 / 34–66:中 / 67–100:高）。不明な場合は null。
          - `searchVolume` 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)