Skip to content

Music Metadata Scraper API for Region-Locked and JS-Rendered Catalog Pages

Music catalog pages are a moving target: tracklists load after JavaScript runs, some releases only appear in certain countries, and lyrics are often hidden behind a toggle.

OUTPUT FORMATSHTMLJSONMarkdown

This API takes a public music metadata URL, renders it in a real browser, rotates the IP, and returns the page so your scraper can pull track titles, artists, albums, runtime, ISRC, lyrics and region-locked variants in a single call.

What a music metadata request returns

Each public music metadata page can yield track title, artist, album, runtime, ISRC, release date, label, lyrics where the page exposes them, and chart position. The response is the rendered page plus any structured data you asked for through extraction rules. Use the field/control map below to decide which option surfaces which field.

Field and control map

Pick the extraction route based on how the target page exposes data. This is a reader checklist, not a claim that every page exposes every field.

Three common music metadata workflows

Most teams land on one of three jobs. Each has a different failure mode, so check the distinction before choosing options.

Telling the failures apart

A blank tracklist, a missing release, and a throttled request look similar in logs but need different fixes. Use this checklist before changing your request.

Worked example: one album page, three options

Suppose you want the tracklist and ISRCs from a public album page that only renders its tracklist after JavaScript runs, and the page is only served to visitors in one country. Start with JavaScript rendering on, add country_code for the target country, and map CSS selectors to field names with extract_rules. If the selectors are unstable, switch to ai_extract_rules with a natural-language spec. The credit cost follows the options you enable, not the number of fields you request.

Setup in under five minutes

Create an account to get an API key and free test credits. Install the SDK for your stack, or call the endpoint with cURL. Test the request in the dashboard request builder first, then move the generated snippet into your codebase. SDKs are published for Python, Node.js, Go, PHP, Ruby and Java; plain cURL also works.

Pricing and credit costs

Plans are billed monthly and priced by API credits and concurrent requests. Credit cost per request depends on the options you enable: JavaScript rendering costs 5 credits, premium proxies cost 10 or 25 credits depending on whether JS rendering is on, and stealth_proxy costs 75 credits. Credits are valid for one month and do not roll over. All prices are exclusive of VAT. The full plan table is delivered as a protected module so every row and numeric cell stays exact.

Compliance and data handling

The API does not collect or store personal data from scraped sites unless the user explicitly requests it. Proxy rotation and headless browser rendering reduce IP-based blocking. Teams handling personal data should confirm their own legal basis and any data-processing terms before running a pipeline.

Field and control map
Field or outcomeHow to surface itNotes
Track title, artist, album, runtime, ISRC, release date, label, chart positionDefault page renderReturned on public music metadata pages that expose these fields.
LyricsDefault page renderOnly where the page exposes lyrics.
Region-locked variantscountry_codeRoutes the request through a residential IP in the chosen country.
Structured JSONextract_rules with CSS selectors mapped to field namesResponse comes back as parsed JSON.
Structured JSON from natural languageai_extract_rulesUse when selectors are unstable or unknown.
ScreenshotsScreenshot optionCaptures the rendered page for visual checks.

Field availability depends on the target page; not every page exposes lyrics or chart position.

Frequently asked questions

Do I need an account to scrape music metadata?

No external account is required. You sign up for an API key, which comes with free test credits and no card, then send the URL and the API handles rendering and proxies.

Can I scrape music metadata from a specific country?

Yes. Pass country_code on the request to route through a residential IP in that country. This is useful when catalog content varies by geography.

What's the rate limit for scraping music metadata?

The API enforces concurrency limits per plan rather than per-target rate limits. If a target throttles aggressive patterns, space out requests or use multiple sessions.

How do I get structured JSON from music metadata?

You have two routes. Map CSS selectors to field names through extract_rules, or describe the fields you want in plain language with ai_extract_rules. Either way, the response arrives as parsed JSON rather than raw HTML.

Which programming languages can I use to scrape music metadata?

Any language that can make an HTTP request. SDKs are published for Python, Node.js, Go, PHP, Ruby and Java, and plain cURL works too.

How much does it cost to scrape music metadata?

New accounts get free test credits with no card required. Paid plans start at $19/month for higher volume and concurrency. Credit cost per request depends on options: 5 credits for JS rendering, 25 for premium_proxy with JS, and 75 for stealth_proxy.