addgene.md
40 lines · skills/database-lookup/references/addgene.md at 5f2bc03
Addgene Catalog API
Raw lines 1 to 2Access and authentication
Base: https://api.developers.addgene.org. Access requires approval and a license for each requested scope; a normal Addgene account does not grant API access. Use Authorization: Token <ADDGENE_API_KEY>.
Read endpoints
| GET path | Purpose |
|---|---|
/catalog/plasmid/ | Search/list plasmids |
/catalog/plasmid/{id}/ | One plasmid |
/catalog/plasmid-with-sequences/{id}/ | One plasmid with sequences; requires catalog:retrieve-with-sequences |
/catalog/viral-prep/ | List viral preparations |
/catalog/viral-prep/{id}/ | One viral preparation |
Ordinary catalog reads require catalog:retrieve or the sequence-enabled scope. Use q for free text; documented field filters include name, backbone, genes, article_pmid, and species. List responses contain count, next, previous, and results. Follow next; page and page_size control pagination. Use sort_by=id for stable pagination; relevance sorting requires q.
Illustrative authenticated request (not executed):
curl --fail-with-body --get 'https://api.developers.addgene.org/catalog/plasmid/' \
-H "Authorization: Token ${ADDGENE_API_KEY}" \
--data-urlencode 'q=GFP' --data-urlencode 'sort_by=id' \
--data-urlencode 'page_size=5'Plasmid records include cloning, insert, sequence, and article data according to scope; nullable fields and empty arrays are legitimate. Use licensed daily JSON bulk downloads for large retrievals. The old /api/plasmids, /depositors, and /articles routes are not the documented developer API.
Reviewed 2026-09-30: OpenAPI schema and access requirements.
Raw lines 9 to 40