# Open Vinyl > Free vinyl record API: look up any record by barcode, catalog number, runout or artist. REST, MCP and CLI. - [Open Vinyl](https://docs.openvinyl.dev/index.md): A free API for vinyl records: identify any record from its barcode, catalog number, runout or artist and title. - [Quickstart](https://docs.openvinyl.dev/quickstart.md): Look up your first vinyl record. - [Catalog in numbers](https://docs.openvinyl.dev/catalog.md): How many vinyl records Open Vinyl covers, by decade, country and genre. - [Albums and pressings](https://docs.openvinyl.dev/concepts/albums-and-pressings.md): How 8.1 million vinyl pressings are grouped into 3.9 million albums, and what the IDs mean. - [Data sources](https://docs.openvinyl.dev/concepts/data-sources.md): Where the data comes from, what each source adds, and how much of it exists. - [Derived fields](https://docs.openvinyl.dev/concepts/derived-fields.md): Values worked out from data we already have, each with the rule that made it and how well that rule tests. - [Connect an agent (MCP)](https://docs.openvinyl.dev/guides/agents.md): Give Claude, Cursor or any MCP client direct access to the vinyl catalog. - [CLI](https://docs.openvinyl.dev/guides/cli.md): ov: look up vinyl records from your terminal and connect your agent in one command. - [Identify a record](https://docs.openvinyl.dev/guides/identify-a-record.md): From a barcode, a code or an artist and title to the album, then to the exact pressing. - [Contributions](https://docs.openvinyl.dev/guides/contributions.md): Send values that are missing or wrong. They're stored for review and never change the catalog directly. - [Introduction](https://docs.openvinyl.dev/api-reference/introduction.md): Base URL, conventions and errors. - [Find albums](https://docs.openvinyl.dev/api-reference/albums/find-albums.md): Find albums by text (`q`) or by `barcode`. Both return the same album cards. - [Get an album](https://docs.openvinyl.dev/api-reference/albums/get-an-album.md): One album with its IDs in other catalogs (Discogs master, MusicBrainz release group, Wikidata), links, genres, cover, and how its pressings were grouped into it. - [List an album's pressings](https://docs.openvinyl.dev/api-reference/albums/list-an-albums-pressings.md): The album's vinyl pressings, filtered by any combination of country, year, label, format, plant and catalog number. `facets` gives the count for each remaining value, so an app can ask the question that narrows the list the most ("Which country does the back say?"). - [Identify an album from a cover photo](https://docs.openvinyl.dev/api-reference/identify/identify-an-album-from-a-cover-photo.md): Upload a photo of the front cover; get back the albums whose cover looks most like it, with a similarity score. The photo is processed in memory and never stored. - [Find pressings by code](https://docs.openvinyl.dev/api-reference/identify/find-pressings-by-code.md): Codes read off a record (barcode, catalog number, or any part of the runout etching) return candidate pressings, each with its album, a score, and which fields matched. Add `label`, `country`, `artist` or `title` to re-rank. `note` says when several pressings tie and what would separate them. - [Get a pressing](https://docs.openvinyl.dev/api-reference/pressings/get-a-pressing.md): Everything known about one pressing, merged from all sources: labels and catalog numbers, formats, identifiers (barcodes, runouts), manufacturing credits, flags (limited, colored vinyl, run size), tracklist, images, conflicts between sources, `derived` values with the rule that produced each one, pe… - [List derived-field rules](https://docs.openvinyl.dev/api-reference/data-quality/list-derived-field-rules.md): How derived values are made (speed from size, pressing plant from runout marks, earliest year, ...) and how well each rule tested on the latest build: values added, rows tested, precision, and holdout precision. - [Submit a contribution](https://docs.openvinyl.dev/api-reference/contributions/submit-a-contribution.md): Submit a missing or corrected value for a pressing or album. It is stored for review and does not change the catalog. - [Get a contribution](https://docs.openvinyl.dev/api-reference/contributions/get-a-contribution.md): One submission, its automatic checks, its review status, and how many different submitters sent the same value. - [Your key and limits](https://docs.openvinyl.dev/api-reference/system/your-key-and-limits.md): Which key you're calling with, its plan's limits, and how many requests it has made today (counted within a few seconds). Calls to this endpoint count too. - [Health and data versions](https://docs.openvinyl.dev/api-reference/system/health-and-data-versions.md): Album, pressing and indexed-cover counts, plus the dump date and status of the latest load of each source. ## OpenAPI Specs - [openapi](/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.