music nerd
music nerd

ResearchLook again

Research

Look again

The "Look again" button normally rebuilds the artist's Lore from current stored sources and re-reads recent posts. Omit the body for that existing behavior. To recover Lore from already stored sources without a social scrape or caption re-extraction, send { "mode": "lore-only" }. Both modes require the approved claimant or an admin. The Lore request is claim-checked and deduplicated while live; repeated manual requests within 30 minutes do not queue another rebuild. The normal social mode retains its separate 30-minute cooldown and waits while Update Latest checks Instagram. A response says what was queued, not that a rebuild has already completed.

POST/api/artist/{id}/research/refresh
POST/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/research/refresh

The "Look again" button normally rebuilds the artist's Lore from current stored sources and re-reads recent posts. Omit the body for that existing behavior. To recover Lore from already stored sources without a social scrape or caption re-extraction, send { "mode": "lore-only" }. Both modes require the approved claimant or an admin. The Lore request is claim-checked and deduplicated while live; repeated manual requests within 30 minutes do not queue another rebuild. The normal social mode retains its separate 30-minute cooldown and waits while Update Latest checks Instagram. A response says what was queued, not that a rebuild has already completed.

Authorization

Authorizationstringrequired

The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. The user must be the artist's approved claimant or a Music Nerd admin. Kept in this tab only.

Path

idstringrequired

The artist's ID (a UUID). Staging and production IDs differ.

Body
cURL
curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/research/refresh' \
  --header 'Content-Type: application/json' \
  --data '{
  "mode": "lore-only"
}'

Send the request to see the live response here.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. The user must be the artist's approved claimant or a Music Nerd admin.

Path Parameters

idstringrequired

The artist's ID (a UUID). Staging and production IDs differ.

Body

application/json
modestring · enum

Optional stored-source-only recovery. Omit for the existing Lore plus social refresh.

Values: "lore-only"

Response

application/json

What was started, in words for the artist.

statusstring · enumrequired

Values: "ok"

messagestringrequired