サジェストキーワード取得

サジェストキーワード取得。

あるキーワードの関連語を広く集めたいときにまず使う。 Google/YouTube/Amazon/楽天/Bing等から、modesパラメータで指定（複数可）した検索エンジンのサジェストを返す。

Googleは汎用的、SEO目的に適する。Bingは汎用的だがユーザー層が高齢者層寄り。 YouTube,Google動画は動画リサーチに、Amazonや楽天はECにおすすめ。

サジェストには、検索エンジンが元キーワードを入力した人の検索意図を汲み取って提案する「関連性の高い複合キーワード」が表示される。

キーワードリサーチの最初期に使用すると、ユーザーがどのような掛け合わせワードで検索しているのか、市場需要や検索意図を幅広く把握できる。

サジェスト候補は通常最大1,000件前後、increaseKeyword=trueで最大10,000件前後存在する。

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

さらに大量のキーワードが必要な場合は POST /v1/related-keywordsを使う。元キーワードと検索意図の近いキーワードを取得したい場合は POST /v1/ranking-keywordsを使う。検索意図を深掘りしたい場合は、元キーワードを調べた人が次に調べるKW・抱えている疑問を取得できるPOST /v1/other-keywordsを併用する。

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

post/v1/suggest-keywords

Request body

keywordstring required

サジェスト取得の元となる検索キーワード。1文字以上の文字列を指定する。

modesstring[]

サジェストキーワードを取得する検索エンジン（複数選択可）。google / bing / youtube / googleVideo / amazon / rakuten / googleShopping / googleImage から選択。省略時は google のみ。

increaseKeywordboolean

キーワード増量オプション。true にすると、より多くのサジェストキーワードを取得する。SEOキーワードを網羅的に取得したい場合は、trueにすること。省略時は false。

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

orderBy'asc' | 'desc'

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

limitinteger

取得件数の上限。正の整数を指定。省略時はすべての結果を返す。

Example request

{
  "keyword": "ラッコ",
  "modes": [
    "google",
    "bing"
  ],
  "filter": {
    "suggestClass": [
      0,
      1
    ],
    "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": 10
}

Response

検索成功

resultboolean required

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

errorsstring[] required

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

Example response

{
  "result": true,
  "meta": {
    "consumedCredit": 1.5
  },
  "data": {
    "query": {
      "keyword": "ラッコ",
      "suggestEngines": [
        "google"
      ]
    },
    "summary": {
      "totalCount": 150,
      "returnedCount": 100
    },
    "items": [
      {
        "keyword": "ラッコ 水族館",
        "suggestClass": "＋",
        "metrics": {
          "seoDifficulty": 45,
          "searchVolume": 12000,
          "cpc": 1.5,
          "competition": 2,
          "firstSeenRange": "last_30_days"
        },
        "suggestEngines": {
          "count": 2,
          "active": [
            "google",
            "youtube"
          ]
        }
      }
    ]
  },
  "errors": []
}

Changes

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