---
title: "一括キーワード調査ステータス取得"
method: GET
path: "/v1/search-volume/{requestId}/status"
tags: ["一括キーワード調査"]
---

# 一括キーワード調査ステータス取得

`GET /v1/search-volume/{requestId}/status`

一括キーワード調査処理ステータス確認。POST /v1/search-volume で登録した一括キーワード調査の処理ステータスを確認する。
isCompleted が true になるまでポーリングすること（推奨間隔: 30秒）。
isCompleted=true になったら POST /v1/search-volume/{requestId}/results で結果を取得できる。

何回かステータスをチェックしてもisCompletedがtrueにならない場合は一定の時間が経ってから再度結果をチェックすることを推奨する。
（利用が混雑している場合は、取得完了まで数時間以上時間がかかるケースがあるため）

クレジットは消費しない。

## Path parameters

- `requestId` number, required

## Response `200`

ステータス取得成功

- SearchVolumeStatusResponseDto
  - `result` boolean, required — API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required — リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required — このリクエストで消費されたクレジット数。
  - `data` object, required — ステータス情報
    - `isCompleted` boolean — 全処理完了フラグ。searchVolume が processed かつ seoDifficulty が processed または skip の場合に true。noiseReduction は判定対象外。
    - `statuses` object — 各処理のステータス情報
      - `searchVolume` 'unprocessed' | 'processing' | 'processed' — 月間検索数取得ステータス。unprocessed: 未処理 / processing: 処理中 / processed: 完了。
      - `noiseReduction` 'unprocessed' | 'processing' | 'processed' — ノイズ除去ステータス。unprocessed: 未処理 / processing: 処理中 / processed: 完了。ノイズ除去には時間がかかる可能性があります。
      - `seoDifficulty` 'skip' | 'unprocessed' | 'processing' | 'processed' — SEO難易度取得ステータス。unprocessed: 未処理 / processing: 処理中 / processed: 完了 / skip: スキップ。
  - `errors` string[], required — エラーメッセージの配列。正常時は空配列。

## Other responses

- `400` — バリデーションエラー
- `403` — 認証失敗
- `429` — レート制限超過
- `500` — Internal Server Error

---

[API](https://skmtc.dev/rakkokeyword/apis/api.md) · [All operations](https://skmtc.dev/rakkokeyword/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rakkokeyword/api/revisions/23e921f5f25c/schema)