一括サイト調査

一括サイト調査

一括サイト調査。

複数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 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

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