---
title: "Poll a niche-analysis job"
method: GET
path: "/v1/content-groups/{groupId}/analyze/{jobId}"
tags: ["Content Groups"]
---

# Poll a niche-analysis job

`GET /v1/content-groups/{groupId}/analyze/{jobId}`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/content-groups/{groupId}/analyze/{jobId}`
- Auth: HTTP bearer

Get an analysis job's status, progress, and result. Terminal states: complete, error.

## Path parameters

- `groupId` string, required: Content group ID
- `jobId` string, required: Analysis job ID

## Response `200`

The analysis job.

- object
  - `success` true, required
  - `data` object, required
    - `job` object, required: An async niche-analysis run with progress + result.
      - `id` string, required
      - `app_id` string, required
      - `status` 'pending' | 'running' | 'complete' | 'error', required
      - `progress` number, required
      - `message` string, nullable, required
      - `platforms` string[], required
      - `mode` 'propose' | 'auto', required
      - `result` object, nullable, required
      - `error_message` string, nullable, required
      - `created_at` string, date-time
      - `updated_at` string, date-time

---

[API](https://skmtc.dev/postquick/apis/postquickai-api.md) · [All operations](https://skmtc.dev/postquick/apis/postquickai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postquick/apis/postquickai-api/revisions/d9bc2bcf3042?raw)
