Research

Read question research

Safe resumable progress and bounded original references; no raw request, provider payload or private interview memory.

GET/api/artist/{id}/research/questions/{jobId}

GET

GET/api/artist/{id}/research/questions/{jobId}

Safe resumable progress and bounded original references; no raw request, provider payload or private interview memory.

Authorization

Authorizationstringrequired

Current artist claimant or administrator Privy access token. Kept in this tab only.

Bearer

Path

idstringrequired

jobIdstringrequired

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/{id}/research/questions/{jobId}'

Send the request to see the live response here.

cURL

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

{
  "jobId": "YOUR_ID",
  "stage": "checking_saved",
  "message": "string",
  "updatedAt": "string",
  "references": [
    {
      "sourceId": "string",
      "revision": "string",
      "start": 0,
      "end": 0,
      "text": "string",
      "url": "string",
      "curation": "approved"
    }
  ],
  "limitations": [
    "string"
  ]
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. Current artist claimant or administrator Privy access token.

X-MusicNerd-Research-Keystringheaderrequired

Server-only MUSICNERD_RESEARCH_API_KEY. Public evidence research only; never grants review or interview-history access.

Path Parameters

idstringrequired

jobIdstringrequired

Response

application/json

Success

statusanyrequired

jobIdstringrequired

format: uuid

stagestring · enumrequired

Values: "checking_saved", "searching", "reading", "transcribing", "waiting_provider", "complete", "unresolved", "failed", "cancelled"

messagestringrequired

providerstring | null

updatedAtstringrequired

format: date-time

reusedboolean

referencesarray<Reference>required

maxItems: 6

Item properties

sourceIdstringrequired

revisionstringrequired

startintegerrequired

minimum: 0

endintegerrequired

minimum: 0

textstringrequired

urlstringrequired

curationstring · enumrequired

Values: "approved", "pending"

evidenceKindstring · enum

Values: "original_text", "caption", "provider_transcript"

speakerstring · enum

Values: "not_applicable", "unverified"

publishedAtstring | null

retrievedAtstring | null

truncatedboolean | null

limitationsarray<string>required

Item properties

string