Artist knowledge

Research status

Strict storage read with sanitized job fields and current evidence coverage. Does not run workers, create jobs or expose raw provider state.

GET/api/artist/{id}/research/status

GET

GET/api/artist/{id}/research/status

Strict storage read with sanitized job fields and current evidence coverage. Does not run workers, create jobs or expose raw provider state.

Authorization

Authorizationstringrequired

Existing authenticated Music Nerd user, approved artist claimant or admin. Credentials remain outside model arguments. Kept in this tab only.

Bearer

Path

idstringrequired

Artist ID in this deployment environment. Authorize claimant/admin on each call.

Query

limitinteger

Maximum records; response character/byte budgets may require an earlier continuation.

cursorstring

Opaque artist/filter-bound continuation. A changed ordered corpus returns 409.

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/{id}/research/status?limit=20'

Send the request to see the live response here.

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/YOUR_ID/research/status' \
  --header 'Authorization: Bearer YOUR_TOKEN'

{
  "status": "ok",
  "jobs": [
    {
      "jobId": "YOUR_ID",
      "kind": "social_ingest",
      "status": "pending",
      "cursor": 0
    }
  ],
  "coverage": {
    "eligibleSources": 0,
    "readableSources": 0,
    "searchedSources": 0,
    "complete": true,
    "limitations": [
      "string"
    ]
  },
  "budget": {
    "returnedChars": 0,
    "truncated": true
  }
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. Existing authenticated Music Nerd user, approved artist claimant or admin. Credentials remain outside model arguments.

Path Parameters

idstringrequired

Artist ID in this deployment environment. Authorize claimant/admin on each call.

Query Parameters

limitinteger

Maximum records; response character/byte budgets may require an earlier continuation.

Default: 20

cursorstring

Opaque artist/filter-bound continuation. A changed ordered corpus returns 409.

Response

application/json

Bounded stored evidence; Cache-Control: private, no-store.

statusstring · enumrequired

Values: "ok"

jobsarray<Job>required

maxItems: 50

Item properties

jobIdstringrequired

format: uuid

kindstring · enumrequired

Values: "social_ingest", "caption_extract", "lore_refresh", "source_search", "latest_refresh", "source_extract", "question_research"

statusstring · enumrequired

Values: "pending", "running", "done", "failed"

cursorintegerrequired

minimum: 0

totalinteger | nullrequired

minimum: 0

updatedAtstring | nullrequired

format: date-time

errorCategorystring | nullrequired

extractionOutcomesarray<object>

Present for source_extract. Attempt results; completion does not imply readable or editorially verified evidence.

maxItems: 20

Item properties

sourceIdstringrequired

format: uuid

statusstring · enumrequired

Values: "ready", "blocked", "empty", "unsupported", "unavailable", "too_large", "skipped"

capturedAtstringrequired

format: date-time

httpStatusinteger | nullrequired

minimum: 100 · maximum: 599

storedCharsintegerrequired

minimum: 0 · maximum: 50000

truncatedbooleanrequired

coverageobjectrequired

Coverage of stored eligible records, not a claim that all external material or PDF pages were extracted. For non-search reads, searchedSources is zero. Legacy extraction limits must be explicit.

Properties

eligibleSourcesintegerrequired

minimum: 0

readableSourcesintegerrequired

minimum: 0

searchedSourcesintegerrequired

minimum: 0

completebooleanrequired

limitationsarray<string>required

Item properties

string

budgetobjectrequired

Properties

returnedCharsintegerrequired

minimum: 0

truncatedbooleanrequired

nextCursorstring | nullrequired