関連キーワード取得

関連キーワード取得

関連キーワード取得。

指定キーワードに部分一致するキーワードをラッコのDBから大量に取得する。 関連語が欲しい場合はまずPOST /v1/suggest-keywordsを使い、さらに大量にKWを取得したい場合にのみ当機能を使う。

最大25,000件を取得。月間検索数・SEO難易度・CPC・競合性などのSEO指標付きで返却。 SEO難易度はデータがない場合が多い。またSEO指標は最新でない可能性がある。 この指標を重要視する用途なら、データ取得後にPOST /v1/search-volumeで最新のSEO指標を取得すること。

検索意図の近いキーワードを取得したい場合はPOST /v1/ranking-keywordsを、 LSIキーワードを取得したい場合はPOST /v1/other-keywordsを使う。

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

post/v1/related-keywords

Request body

keywordstring required

関連キーワード取得の元となる検索キーワード。1文字以上の文字列を指定する。

matchType'partialMatch' | 'phraseMatch' | 'prefixMatch' | 'suffixMatch' | 'wordMatch'

キーワードのマッチタイプ。partialMatch: 部分一致 / phraseMatch: フレーズ一致 / prefixMatch: 前方一致 / suffixMatch: 後方一致 / wordMatch: 単語一致。省略時は partialMatch。

sortBy'seoDifficulty' | 'searchVolume' | 'cpc' | 'competition' | 'firstSeenRange'

結果のソート項目。seoDifficulty / searchVolume / cpc / competition / firstSeenRange。省略時は searchVolume。

orderBy'asc' | 'desc'

ソート順。asc: 昇順 / desc: 降順。省略時は desc。

limitinteger

取得件数の上限。1〜25000 の整数を指定。省略時は 1000 件。

Example request

{
  "keyword": "ラッコ",
  "filter": {
    "keyword": {
      "includes": [
        "水族館"
      ],
      "notIncludes": [
        "グッズ"
      ]
    },
    "seoDifficulty": {
      "min": 1,
      "max": 100
    },
    "searchVolume": {
      "min": 100,
      "max": 10000
    },
    "cpc": {
      "min": 0.5,
      "max": 10
    },
    "competition": {
      "min": 1,
      "max": 100
    },
    "firstSeenRange": {
      "include": "last_30_days"
    }
  },
  "limit": 100
}

Response

検索成功

resultboolean required

API 呼び出しの成否。正常時は true、エラー時は false。

errorsstring[] required

エラーメッセージの配列。正常時は空配列。

Example response

{
  "result": true,
  "meta": {
    "consumedCredit": 1.5
  },
  "data": {
    "query": {
      "keyword": "ラッコ"
    },
    "summary": {
      "totalCount": 150,
      "returnedCount": 100
    },
    "items": [
      {
        "keyword": "ラッコ 水族館",
        "metrics": {
          "seoDifficulty": 40,
          "searchVolume": 90500,
          "competition": 1,
          "firstSeenRange": "last_30_days"
        }
      }
    ]
  },
  "errors": []
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.