Record store data
Every store listed on this site is also available as plain JSON files, free to read from any app, script or AI agent. No key, no sign-up. The files are rebuilt every time the site is.
- Stores
- 2,179
- Cities and towns
- 895
- States and provinces
- 56
Where to start
Fetch the index. It lists every file, the counts and what to credit.
https://findvinylrecords.com/api/index.json
Files
| File | What's in it |
|---|---|
/api/stores.json | Every store (about 1 MB) |
/api/cities.json | Every city and town with stores, its count and its file |
/api/states.json | Every state and province, its count and its file |
/api/record-stores/{state}.json | One state's stores, e.g. tn.json |
/api/record-stores/{state}/{city}.json | One town's stores, e.g. tn/nashville.json |
The paths follow the site's own: a city page at /record-stores/tn/nashville/ has its data at /api/record-stores/tn/nashville.json.
- {state} is the two-letter code:
tn,ca. For Canada, the code or the province's name both work:qc/montreal.jsonandquebec/montreal.json. - {city} is lowercase and hyphenated, with accents dropped:
montreal,st-johns.cities.jsonlists every one with its exact file.
One store
From Grimey's New & Preloved Music's page:
{
"id": "00060cefa7f7",
"name": "Grimey's New & Preloved Music",
"url": "https://findvinylrecords.com/record-stores/tn/nashville/grimeys-new-and-preloved-music/",
"address": {
"street": "1060 E Trinity Ln",
"city": "Nashville",
"state": "TN",
"state_name": "Tennessee",
"postal_code": "37216",
"country": "USA",
"full": "1060 E Trinity Ln, Nashville, TN 37216, USA"
},
"location": {
"lat": 36.203792,
"lon": -86.741006,
"neighbourhood": null
},
"website": "http://grimeys.com/",
"updated": "2026-11-22",
"description": "Grimey's won the Frontline Innovator Award at Music Biz 2025. Weekly BEER:30 events on Saturdays at 4:30 p.m. offer free Tennessee Brew Works beers to those 21+ with valid IDs, often coinciding with early listening opportunities for upcoming releases. The shop hosts listening parties for film soundtracks and album releases, carries new and used records, CDs, and books, and stocks Record Store Day and RSD Black Friday exclusives. It buys collections and accepts records, CDs, and books to sell or trade.",
"facts": {
"stock": "new_and_used",
"buys_collections": true,
"year_opened": null,
"checked": "2026-11-21",
"source": "the store's own website"
},
"quote": {
"text": "We love seeing your faces, catching up, and being part of your community.",
"source": "the store's own website"
}
}
- description, facts and quote appear only for stores whose own website we read and checked. Facts come from that website;
checkedis when. - location is
nullwhen the address couldn't be placed on a map. - updated is when the listing last changed.
Quick start
Shell:
curl -s https://findvinylrecords.com/api/record-stores/tn/nashville.json
JavaScript (works from any website: the files allow cross-origin requests):
const res = await fetch("https://findvinylrecords.com/api/record-stores/tn/nashville.json");
const { stores } = await res.json();
stores.forEach(s => console.log(s.name, s.address.full));
Python:
import json, urllib.request
url = "https://findvinylrecords.com/api/stores.json"
stores = json.load(urllib.request.urlopen(url))["stores"]
print(len(stores), "stores")
With AI agents
Agents that can fetch web pages can use the files directly. Point them at /llms.txt, a short plain-text guide to this data, or paste the index URL into a prompt:
Using https://findvinylrecords.com/api/index.json, find record stores in Nashville that buy collections.
Or try it now: plan a record shopping trip in Nashville with ChatGPT or Claude. Every city page has the same link for its own stores.
What's not included
Google ratings and review counts. They're shown on the store pages, credited to Google, but they're Google's data, so they aren't republished here.
Licence and credit
- Store details, descriptions and facts are licensed under Creative Commons Attribution 4.0 (CC BY 4.0). Use them for anything, including commercially; credit findvinylrecords.com and link to the store's
url. - Coordinates and neighbourhoods: © OpenStreetMap contributors, under the Open Database License (ODbL), not CC BY.
- Quotes are the stores' own words, from their websites. They're not ours to license, so they're not covered by CC BY.