---
title: "検索順位チェックステータス取得"
method: GET
path: "/v1/search-rank/{requestId}/status"
tags: ["検索順位チェック"]
---

# 検索順位チェックステータス取得

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

検索順位チェック処理ステータス確認。POST /v1/search-rank で登録した検索順位チェックの処理ステータスを確認する。
isCompleted が true になるまでポーリングすること（推奨間隔: 30秒）。
isCompleted=true になったら POST /v1/search-rank/{requestId}/results で結果を取得できる。

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

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

## Path parameters

- `requestId` string, required

## Response `200`

ステータス取得成功

- SearchRankStatusResponseDto
  - `result` boolean, required — API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required — リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required — このリクエストで消費されたクレジット数。
  - `data` object, required — ステータス情報
    - `isCompleted` boolean — 全処理完了フラグ。statuses.serp が processed かつ statuses.searchVolumeAndSeoDifficulty が processed またはなし の場合に true。failed または integration_failed の場合は false。
    - `statuses` object — 各処理のステータス情報
      - `serp` 'unprocessed' | 'processing' | 'processed' — SERP取得ステータス。unprocessed: 未処理 / processing: 処理中 / processed: 完了。
      - `searchVolumeAndSeoDifficulty` 'unprocessed' | 'processing' | 'processed' | 'failed' | 'integration_failed' — 月間検索数/SEO難易度ステータス。unprocessed: 未処理 / processing: 処理中 / processed: 完了 / failed: 失敗 / integration_failed: 統合失敗。
  - `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.dev/rakkokeyword/apis/api/revisions/6b6ac57e0064?raw)