Artist knowledge

Search original evidence

Search all accessible stored source text or declare omitted coverage. Do not search only the start of a long source. Match qualification and source identity survive ranking. History/corrections are loaded with getInterviewHistory, never dependent on a semantic hit.

GET/api/artist/{id}/knowledge/search

GET

GET/api/artist/{id}/knowledge/search

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

querystringrequired

Research question or keywords.

limitinteger

Maximum original passages.

maxCharsinteger

Maximum total evidence text characters.

kindstring

Optional source-kind filter.

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/{id}/knowledge/search?limit=5&maxChars=6000'

Send the request to see the live response here.

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/YOUR_ID/knowledge/search?query=YOUR_QUERY' \
  --header 'Authorization: Bearer YOUR_TOKEN'

{
  "status": "ok",
  "passages": [
    {
      "source": {
        "sourceId": "string",
        "kind": "vault",
        "titleTruncated": true,
        "revision": "string",
        "publishedAt": "string",
        "provenance": {
          "origin": "vault_link",
          "speaker": "not_applicable",
          "relationship": "string"
        },
        "extraction": {
          "readiness": "ready",
          "storedChars": 0,
          "limitations": [
            null
          ]
        },
        "descriptionTruncated": true
      },
      "revision": "string",
      "start": 0,
      "end": 0,
      "text": "string"
    }
  ],
  "coverage": {
    "eligibleSources": 0,
    "readableSources": 0,
    "searchedSources": 0,
    "complete": true,
    "limitations": [
      "string"
    ]
  },
  "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

querystringrequired

Research question or keywords.

limitinteger

Maximum original passages.

Default: 5

maxCharsinteger

Maximum total evidence text characters.

Default: 6000

kindstring · enum

Optional source-kind filter.

Values: "vault", "social_caption", "reel_transcript"

Response

application/json

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

statusstring · enumrequired

Values: "ok"

passagesarray<Passage>required

maxItems: 10

Item properties

sourceobjectrequired

Properties

sourceIdstringrequired

pattern: ^(vault:[0-9a-f-]{36}|social:[0-9a-f-]{36}:(caption|transcript))$

kindstring · enumrequired

Values: "vault", "social_caption", "reel_transcript"

titlestring | nullrequired

maxLength: 300

titleTruncatedbooleanrequired

urlstring | nullrequired

format: uri

revisionstringrequired

Includes empty stored evidence, so unreadable/unknown sources remain identifiable without claiming readable content.

pattern: ^[a-f0-9]{64}$

publishedAtany ofrequired

Preserve available precision; do not invent a time for a date-only publication.

Properties

anyOf · string 1

string

anyOf · string 2

string

anyOf · null 3

null

ingestedAtstring | nullrequired

format: date-time

provenanceobjectrequired

Properties

originstring · enumrequired

Values: "vault_link", "vault_upload", "social_caption", "provider_transcript"

providerstring | nullrequired

methodstring | nullrequired

speakerstring · enumrequired

Values: "not_applicable", "unverified", "verified"

publisherstring | nullrequired

Stored social account username, not a verified speaker identity; null for unestablished publisher.

speakerNamenullrequired

relationshipstringrequired

extractionobjectrequired

Properties

readinessstring · enumrequired

Values: "ready", "queued", "running", "failed", "unknown"

storedCharsintegerrequired

minimum: 0

truncatedboolean | nullrequired

limitationsarray<string>required

Item properties

string

descriptionstring | nullrequired

Publisher metadata; not original body text and never sufficient support for a premise.

maxLength: 600

descriptionTruncatedbooleanrequired

uploadedAtstring | nullrequired

format: date-time

eventDatenullrequired

Unknown in the current schema; never inferred from upload/publication time.

originalSourceUrlnullrequired

No verified original/repost relationship is available in legacy storage.

revisionstringrequired

pattern: ^[a-f0-9]{64}$

startintegerrequired

minimum: 0

endintegerrequired

minimum: 0

textstringrequired

pageinteger | nullrequired

minimum: 1

startSecondsnumber | nullrequired

minimum: 0

endSecondsnumber | nullrequired

minimum: 0

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

returnedCharsintegerrequired

minimum: 0 · maximum: 12000

truncatedbooleanrequired