Sign in
見出し抽出

見出し抽出取得

見出し抽出。指定キーワードのGoogle検索上位ページの見出し（h1〜h6）を抽出する。

そのキーワードでSEO上位表示するために必要な情報を分析したいときや、 競合上位ページがどのようなオリジナルコンテンツを記事に含めているのかを把握するのに役立つ。 SEO記事のタイトル/見出し/本文を作成する前に使うべき機能。

ページごと・上位ページ平均の文字数・見出し数なども返す。

Googleは、そのキーワードで検索するユーザーの悩みを解決できる可能性の高い記事を上位表示する。 このため上位ページ中で共通して出現する見出し/トピックは、そのキーワードを調べるユーザーにとって必要な情報である可能性が高い。

上位ページの頻出単語（共起語）も欲しい場合はPOST /v1/co-occurrenceを併用する。

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

post/v1/headline

Request body

keywordstring required

見出し抽出を行う検索キーワード。1文字以上の文字列を指定する。

lessHeadlinesboolean

見出し5件未満のページを除外するかどうか。true で除外する。省略時は false。

lessCharactersboolean

文字数1,000未満のページを除外するかどうか。true で除外する。省略時は false。

h1boolean

h1タグの見出しを含めるかどうか。省略時は true。

h2boolean

h2タグの見出しを含めるかどうか。省略時は true。

h3boolean

h3タグの見出しを含めるかどうか。省略時は true。

h4boolean

h4タグの見出しを含めるかどうか。省略時は true。

h5boolean

h5タグの見出しを含めるかどうか。省略時は false。

h6boolean

h6タグの見出しを含めるかどうか。省略時は false。

sortBy'position' | 'title' | 'headlineCount' | 'wordCount'

ソート項目。position / title / headlineCount / wordCount。省略時は position。

orderBy'asc' | 'desc'

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

limitinteger

取得件数。1〜20 の整数を指定する。省略時は 20。

Example request

{
  "keyword": "ラッコ",
  "limit": 20
}

Response

検索成功

resultboolean required

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

errorsstring[] required

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

Example response

{
  "result": true,
  "meta": {
    "consumedCredit": 3
  },
  "data": {
    "query": {
      "keyword": "ラッコ"
    },
    "summary": {
      "totalCount": 150,
      "returnedCount": 100,
      "averageHeadlineCount": 19.5,
      "averageWordCount": 7782,
      "minWordCount": 2935,
      "maxWordCount": 12629
    },
    "items": [
      {
        "page": {
          "url": "https://ja.wikipedia.org/wiki/%E3%83%A9%E3%83%83%E3%82%B3",
          "title": "ラッコ - Wikipedia",
          "description": "ラッコは、..."
        },
        "metrics": {
          "position": 1,
          "headlineCount": 19,
          "wordCount": 14190
        },
        "headlines": [
          {
            "level": "h1",
            "text": "ラッコ"
          }
        ]
      }
    ]
  },
  "errors": []
}

Changes

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