International Variable Star Index (VSX) — Known and Suspected Variable Stars

One row per known or suspected variable-star object in AAVSO's International Variable Star Index, mirrored from the VizieR bulk table B/vsx/vsx. The catalog covers 10,304,568 objects with J2000 sky positions, designations, variability classifications, magnitude-range attributes, ephemeris fields, periods, and spectral types where known. Magnitude and period fields describe cataloged object attributes, not individual AAVSO photometric observations or light-curve measurements.

aavso-vsx-catalog·17 columns·399.0 MB·AAVSO VSX copyright terms / AAVSO Data Usage Guidelines·updated 6d ago

Schema

recnoBIGINT
oidBIGINT
nameVARCHAR
variability_flagBIGINT
ra_degDOUBLE
dec_degDOUBLE
variability_typeVARCHAR
max_mag_limit_flagVARCHAR
max_magDOUBLE
max_mag_bandVARCHAR
min_is_amplitude_flagVARCHAR
min_mag_limit_flagVARCHAR
min_magDOUBLE
min_mag_bandVARCHAR
epoch_jdDOUBLE
period_daysDOUBLE
spectral_typeVARCHAR

Get this dataset on your machine

subsets sync --bundle medium clones the mid-size tiers as queryable local tables — use --bundle large for the widest tier

pip install subsetsio
subsets sync --bundle small # or medium, or large
subsets serve # search + SQL at http://localhost:8080

Free and open — the data syncs straight from the public bucket, and search + SQL run entirely on your machine. See docs →

Query it locally

Full docs →
Bash
subsets serve   # local API on http://localhost:8080
curl -s -X POST "http://localhost:8080/query" \
  -H "Content-Type: application/json" \
  -d '{"sql": "SELECT * FROM \"aavso-vsx-catalog\" LIMIT 5"}'

No account, no API key — the data syncs straight from bundles.subsets.io and every query runs on your machine. See the local API reference.