Pitchfork API: Get album review
Finds Pitchfork's newest review that matches an album title and artist, and returns the review's rating and details.
Unofficial. Not affiliated with or endorsed by Pitchfork.
Inputs
Values from the run on Oct 27, 2026, shown under Output.
- Album, required
album Album title, for example Blonde.
To Pimp a Butterfly
- Artist, required
artist Recording artist, for example Frank Ocean.
Kendrick Lamar
Input as JSON
{ "album": "To Pimp a Butterfly", "artist": "Kendrick Lamar"}Output
{ "album": "To Pimp a Butterfly", "score": 9.3, "artist": "Kendrick Lamar", "genres": [ "Rap" ], "summary": "The dense and complex follow-up to Good Kid, M.A.A.D City is wry, theatrical, chaotic, ironic, and mournful, often all at once.", "reviewer": "Craig Jenkins", "review_date": "2015-03-19", "review_link": "https://pitchfork.com/reviews/albums/20390-to-pimp-a-butterfly/" , "record_label": "Top Dawg Entertainment / Aftermath / Interscope", "release_year": 2015, "best_new_music": true, "cover_image_link": "https://media.pitchfork.com/photos/6616994dee648e2629d84122/master/w_1024,c_limit/Kendrick-Lamar-To-Pimp-a-Butterfly.jpg" }Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"pitchfork.com/get_album_review","input":{"album":"To Pimp a Butterfly","artist":"Kendrick Lamar"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "pitchfork.com/get_album_review" , "input": { "album": "To Pimp a Butterfly", "artist": "Kendrick Lamar" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "pitchfork.com/get_album_review" , "input": { "album": "To Pimp a Butterfly", "artist": "Kendrick Lamar" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run pitchfork.com/get_album_review# with {"album":"To Pimp a Butterfly","artist":"Kendrick Lamar"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "album", "artist" ], "properties": { "album": { "type": "string", "description": "Album title, for example Blonde." }, "artist": { "type": "string", "description": "Recording artist, for example Frank Ocean." } }}Output schema
{ "type": "object", "required": [ "album", "artist", "score", "best_new_music", "reviewer", "review_date", "genres", "record_label", "release_year", "summary", "cover_image_link", "review_link" ], "properties": { "album": { "type": "string" }, "score": { "type": [ "number", "null" ], "description": "Pitchfork score out of 10." }, "artist": { "type": "string" }, "genres": { "type": "array", "items": { "type": "string" } }, "summary": { "type": [ "string", "null" ] }, "reviewer": { "type": [ "string", "null" ] }, "review_date": { "type": [ "string", "null" ], "format": "date" }, "review_link": { "type": "string" }, "record_label": { "type": [ "string", "null" ] }, "release_year": { "type": [ "integer", "null" ] }, "best_new_music": { "type": "boolean" }, "cover_image_link": { "type": [ "string", "null" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
pitchfork.com/get_album_review- Returns
- album, artist, score, best new music, reviewer, date, genres, label, year, summary, cover, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method pitchfork.com/get_album_review with the inputs above.
Ask your agent
- What score did the album Blonde by Frank Ocean get in its latest review?
- Can you find the most recent review of Good Kid, M.A.A.D City by Kendrick Lamar and tell me the rating?
- Did Pitchfork name Rumours by Fleetwood Mac Best New Music, and who reviewed it?
- Show me the review details for Currents by Tame Impala, including genres, label, and release year.
- I want a summary and the link to the newest write-up of To Pimp a Butterfly by Kendrick Lamar on pitchfork.com.
See more
All Pitchfork methodsLists the newest Pitchfork album reviews. You can filter them by genre or limit them to Best New Music.
pitchfork.com/list_latest_reviewsFinds an Apple Music album by title and optional artist, or by album link, and returns its matched release, purchase details and tracks in order.
music.apple.com/get_albumLooks up a Deezer album by name, album link, or ID, optionally matching an artist, and returns its details and ordered tracklist.
deezer.com/get_albumGets a Bandcamp album by title and optional artist, or by album link, with prices, physical formats, tracks and album details. Supporter count covers only profiles shown on the page; copies left is given only when displayed.
bandcamp.com/get_albumGets a Spotify album by name (optionally with the artist), album link or album ID, with its details and ordered track list including play counts.
open.spotify.com/get_albumFinds a Discogs release by title, artist or release link and returns its edition details, tracks, community counts, current price and sold price statistics.
discogs.com/get_releaseGets an Apple Music artist profile by name or artist link. The profile includes the latest release, top songs and albums.
music.apple.com/get_artistGets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful.
podcasts.apple.com/get_podcast_reviews