{"id":"44f7053d-1dbd-470b-8354-d7681814a129","task":"Fetch annotations attached to a Genius song or web page using the referents endpoint","domain":"docs.genius.com","steps":["Obtain a Genius API client access token by registering an API client on the Genius developer site","Identify the target content by its `song_id` (from a prior song search/lookup) or, for annotated web pages, its `web_page_id` — the referents endpoint accepts only one of the two, not both","Call the referents endpoint with the chosen `song_id` or `web_page_id`, using `per_page` and `page` to paginate results for heavily-annotated songs","Set `text_format` (e.g. dom, html, markdown, or plain) to control how returned annotation body text is formatted for your rendering layer","For each referent, read its associated annotations to get the actual annotation body/content, and its fragment (the highlighted source text) to know what the annotation is attached to","Optionally filter by `created_by_id` if you need annotations authored by a specific Genius user rather than all annotations on the content"],"gotchas":["A referent can have more than one annotation attached to the same fragment (e.g. both an official artist annotation and a community one) — code that assumes one annotation per fragment will drop data","song_id and web_page_id are mutually exclusive on this endpoint; passing both is invalid, not additive","Annotation body content can include rich formatting/embedded markup — request the `text_format` your renderer actually supports rather than parsing raw DOM output as plain text"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/44f7053d-1dbd-470b-8354-d7681814a129"}