snpedia.com APIsnpedia.com ↗
Access SNPedia's human genetics database via API. Retrieve SNPs, genotypes, genes, medical conditions, and medicines with 5 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/8273ceb4-f6c9-4d1c-8218-1204790dd5f5/list_snps?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
List all SNPs in SNPedia using pagination. Returns a list of page titles and IDs from the Is_a_snp category.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results per page. |
| continue | string | Continue token for pagination, obtained from a previous response's continue field. |
{
"type": "object",
"fields": {
"snps": "array of objects with pageid, ns, and title fields",
"continue": "string pagination token or null if no more results"
},
"sample": {
"data": {
"snps": [
{
"ns": 0,
"title": "I1000001",
"pageid": 10244
},
{
"ns": 0,
"title": "I1000003",
"pageid": 13450
},
{
"ns": 0,
"title": "I1000004",
"pageid": 19115
}
],
"continue": "page|4931303030303135|12979"
},
"status": "success"
}
}About the snpedia.com API
The SNPedia API exposes 5 endpoints covering the full breadth of SNPedia's human genetics wiki, from paginated SNP listings to per-variant detail pages. The get_snp endpoint returns genomic coordinates, associated genes, chromosome orientation, and all known genotypes for a given rsID. Other endpoints cover genotype-level properties, category browsing across genes and medical conditions, and full-text search across all SNPedia content.
SNP and Genotype Data
The get_snp endpoint accepts an rsID (case-insensitive, e.g. rs334 or Rs334) and returns the canonical SNP title, chromosome identifiers, numeric chromosome positions, strand orientation, associated gene names, and a genotypes array. Each genotype object in that array includes the genotype string, magnitude score, repute classification, and a human-readable summary. The get_genotype endpoint goes one level deeper, accepting a full genotype page title like Rs334(A;A) and returning individual alleles (allele1, allele2), magnitude, repute, summary, and the parent rsID.
Listing and Browsing Categories
list_snps paginates the full Is_a_snp category, returning pageid, ns, and title for each SNP page. Pagination is cursor-based: each response includes a continue token that you pass back to retrieve the next page, or null when the list is exhausted. The list_category endpoint generalizes this pattern to any SNPedia category — pass Is_a_gene, Is_a_medical_condition, Is_a_medicine, or Is_a_genoset in the category parameter to enumerate those collections with the same paginated response shape.
Full-Text Search
The search endpoint accepts a query string and returns a hits array of matching pages. Each hit includes title, pageid, snippet (a text excerpt), size, wordcount, and timestamp. The total field indicates the overall result count; pagination uses a numeric offset parameter drawn from the previous response's continue field rather than an opaque token, making it straightforward to page through large result sets programmatically.
- Build a variant annotation tool that maps rsIDs to chromosome positions, genes, and strand orientation using
get_snp. - Enumerate all SNPedia gene pages via
list_categorywithIs_a_geneto build a reference index of covered loci. - Retrieve magnitude and repute scores for specific genotypes via
get_genotypeto power a personal genomics interpretation layer. - Cross-reference medical conditions from
Is_a_medical_conditioncategory members against SNP summaries for a disease-variant lookup. - Search SNPedia content by keyword using the
searchendpoint to surface relevant variant pages for a given trait or condition name. - Page through the complete SNP catalog with
list_snpsand cursor-based pagination to seed a local genetics database. - Map medicine names from
Is_a_medicinecategory listings to associated SNPs for pharmacogenomics research workflows.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SNPedia have an official developer API?+
genotypes, magnitude, repute, and chromosome without that overhead.What does `get_snp` return beyond basic rsID metadata?+
genotypes array for the SNP, where each object includes the genotype string, a numeric magnitude value, a repute label (e.g. Good, Bad), and a plain-text summary. It also returns chromosome, position, orientation, gene, and a direct url to the SNP page.Does the API return genoset or haplotype data beyond individual SNPs?+
list_category endpoint can enumerate pages in the Is_a_genoset category, returning page titles and IDs. Detailed structured data for genosets (e.g. combined SNP rules, genoset summaries) is not returned by a dedicated endpoint currently. You can fork the API on Parse and revise it to add a get_genoset endpoint covering those fields.How does pagination work across the listing and search endpoints?+
list_snps and list_category use an opaque cursor string: pass the continue value from one response as the continue input on the next call. The search endpoint uses a numeric offset instead. All three return null in the continue field when no further results exist.Does the API cover population frequency data or clinical significance scores for variants?+
magnitude and repute fields, plus free-text summary values. You can fork the API on Parse and revise it to integrate a population frequency source as an additional endpoint.