RArakkokeyword
一括サイト調査

一括サイト調査

Changed on

一括サイト調査。

複数URL（最大100件）をまとめて調査し、各サイトの推定流入数・獲得キーワード数・ページ数などの現在値と、その推移（0〜100の指数）を取得する。 サイト群のSEO規模とトレンドを一括で把握するのに有用。

推移データ（histories）は、現在値スカラー（metrics）とは別ソース・別量のため、系列内最大月を100とする指数（0〜100・小数第2位）に正規化して返す。 etv / keywordCount / pageCount の3系列を各々独立に指数化し、キー名は etvIndex / keywordCountIndex / pageCountIndex とする（現在値との誤読防止）。 現在値・分布・変化率は実数のまま返す（指数化しない）。

urlMatchTypeで調査単位を指定する（url: 完全一致 / forward_url: 前方一致 / domain: ドメイン一致 / sub_domain: サブドメイン一致）。 itemsは入力urlsと同数・同順で返る。 対象URLは最大100件。

入力URL1件あたり0.45クレジットを消費（最低4.5クレジット）。（例: 10URL→4.5クレジット、100URL→45クレジット）。

post/v1/bulk-site-research

Request

Request body

urlsstring[] required

一括サイト調査の対象URL一覧（1〜100件）。各URLの推定流入数・獲得キーワード数・ページ数の現在値と、その推移（0〜100指数）を取得する。

urlMatchType'url' | 'forward_url' | 'domain' | 'sub_domain'

URLのマッチタイプ。url: 完全一致 / forward_url: 前方一致 / domain: ドメイン一致 / sub_domain: サブドメイン一致。省略時は domain。

Example request

{
  "urls": [
    "https://rakkokeyword.com/"
  ]
}

Response

検索成功

resultboolean required

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

errorsstring[] required

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

Example response

{
  "result": true,
  "meta": {
    "consumedCredit": 4.5
  },
  "data": {
    "query": {
      "targets": [
        "*.rakkokeyword.com/*"
      ],
      "urlMatchType": "domain"
    },
    "summary": {
      "totalCount": 150,
      "returnedCount": 100
    },
    "items": [
      {
        "site": {
          "target": "*.rakkokeyword.com/*"
        },
        "metrics": {
          "estimatedTraffic": 15803,
          "estimatedTrafficChangeRate": 0.125,
          "keywordCount": 119,
          "pageCount": 51,
          "trafficValue": 51386,
          "pagesWithTrafficCount": 42,
          "pagesWithTrafficRate": 0.8235,
          "averageEstimatedTrafficPerPage": 309.86,
          "averageRankingKeywordCountPerPage": 2.33,
          "averageTrafficValuePerPage": 1007.57
        },
        "histories": [
          {
            "date": "2026-06-30",
            "etvIndex": 100,
            "keywordCountIndex": 82.35,
            "pageCountIndex": 90.12
          }
        ]
      }
    ]
  },
  "errors": []
}

Changes

  • 084bc7d3e4deRevision changes
    • breaking

      the response property //// became nullable for the status

    • info

      response property data/items/items/metrics/estimatedTrafficChangeRate list-of-types was narrowed by removing types null from media type application/json of response 200

  • 23e921f5f25cRevision changes
    • info

      endpoint added