{"uid":"cap_p2qRMHsE82J-jwMSLhrdd","slug":"socialfetch-spotify-album-lookup-5196cdb2","name":"SocialFetch Spotify Album Lookup","description":"Get a Spotify album by id or album URL.","url":"https://api.socialfetch.dev/v1/spotify/album","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"url":{"type":"string","maxLength":4096,"minLength":1,"description":"Optional Spotify album URL for the request."},"albumId":{"type":"string","maxLength":4096,"minLength":1,"description":"Optional Spotify album id for the request."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O2wNkINqIbTy4KT1fZylJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches metadata for a Spotify album given an album ID or Spotify album URL.","exampleAgentPrompt":"Can you pull up the full album details for this Spotify link — https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy — I want to see the track list, release date, and artist info.","exampleUseCases":[{"title":"Track listing for new release","prompt":"I just heard a new album dropped from my favorite artist — here's the Spotify link: https://open.spotify.com/album/3T4tUhGYeRNVUGevb0wThu. Can you pull up all the tracks on it and tell me the release date?"},{"title":"Artist and album info lookup","prompt":"I have this Spotify album ID: 1ATL5GLyefJaxhQzSPVrLX — can you fetch the full metadata for it? I want to know the artist name, album title, and when it came out."},{"title":"Album artwork and details fetch","prompt":"Can you grab the album artwork and general details for this Spotify album? Here's the URL: https://open.spotify.com/album/6dVIqQ8qmQ5GBnJ9shOYss — I need the cover image link and the full track listing."}],"resultDescription":"Returns structured metadata for the Spotify album, including album title, artist name(s), release date, track listing, album artwork URL, and other album-level details from Spotify.","failureModes":["Invalid or malformed albumId returns an error response","Spotify album URL that is not a valid album link (e.g. a track or artist URL) may fail or return unexpected data","Album not found on Spotify returns a not-found error","Neither albumId nor url provided may result in a bad request error","Rate limiting or upstream Spotify unavailability may cause transient failures"],"whenToPreferThis":"Use this endpoint when you need structured metadata for a specific Spotify album and have either the album ID or a Spotify album URL. Prefer this over scraping Spotify directly or using the Spotify API natively when you need a simple pay-per-call REST lookup without OAuth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:18.274Z","isFirstParty":false}