Research

Request question research

Enqueue or reuse bounded public-evidence research. Checks saved originals first. No scraping in enqueue. Never approves Lore or attaches a profile.

POST/api/artist/{id}/research/questions

POST

POST/api/artist/{id}/research/questions

Enqueue or reuse bounded public-evidence research. Checks saved originals first. No scraping in enqueue. Never approves Lore or attaches a profile.

Authorization

Authorizationstringrequired

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

Bearer

Path

idstringrequired

Body

bodyapplication/json

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/artist/{id}/research/questions' \
  --header 'Content-Type: application/json' \
  --data '{
  "topic": "string",
  "evidenceNeed": "reporting"
}'

Send the request to see the live response here.

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/artist/YOUR_ID/research/questions' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "topic": "string",
  "evidenceNeed": "reporting"
}'

{
  "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

Body

application/jsonrequired

topicstringrequired

Neutral public work/topic terms, not private visitor chat.

minLength: 3 · maxLength: 160

evidenceNeedstring · enumrequired

Values: "reporting", "release_date", "credits", "social_caption", "spoken_content"

freshnessstring · enum

Values: "stored", "recent"

Default: "stored"

targetUrlstring

format: uri · maxLength: 2048

platformstring · enum

Values: "instagram", "tiktok", "x"

fromDatestring

format: date

toDatestring

format: date

Response

application/json

Persisted acknowledgement

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