API Documentation
Explore the ecosyste.ms APIs to access open source package ecosystem data programmatically.
All APIs follow OpenAPI 3.0.1 specifications and are available under CC-BY-SA-4.0 license. Each service provides both machine-readable specifications and interactive documentation.
Rate limits and pooling
We split API users into two pools: the polite pool, and the common pool.
The polite pool is our priority pool of known users. To access the polite pool you will need to provide an email address so that we can contact you should we need to discuss fair usage and rate limits.
To access the polite pool:
- Add
mailto=you@example.comas a parameter to your API request, or - Add
mailto:you@exmaple.comsomewhere in your user-agent request header, or - Configure your
fromrequest header.
The common pool is for everyone else. It will have less consistent response times, especially during peak periods so that we can prioritise polite requests more easily.
Root OpenAPI Specification
A consolidated specification that references all individual service APIs:
Data
Core ecosyste.ms datasets
Repositories
Metadata for 278m repositories across 1,938 sources
Advisories
Metadata for 24k security advisories across 12 languages (under development)
Tools
Use ecosystems intelligence to get things done
Dependency Parser
Resolve the full dependency tree for a repository
Dependency Resolver
Resolve the full dependency tree for a package
License Parser
Extract license metadata from a package or repository
Indexes
Additional data powering ecosyste.ms core services, provided direct for your own use
Issues
16 million issues and 38 million pull requests across 8.5 million repositories
Docker
755k Docker images and their dependencies from Docker Hub
Open Collective
$48m in open source grants, donations, and sponsorships from Open Collective
Applications
Full applications built by the ecosyste.ms team
Dashboards
Understand the impact of your open source software contributions.
Experiments
The following datasets and services are created as demonstrators or as part of partnerships with ecosystem teams
OST
A curated list of technology projects protecting and sustaining our climate and environment
Papers
Indexing and attributing open source software mentioned in academic papers
Services without APIs
The following services provide web interfaces only:
- Digest - Check the integrity of a package or repository (digest.ecosyste.ms)
- Funds - Support your core open source dependencies (funds.ecosyste.ms)
Getting Started
All APIs follow consistent patterns:
- Base URL:
https://{service}.ecosyste.ms/api/v1 - OpenAPI Spec:
https://{service}.ecosyste.ms/docs/api/v1/openapi.yaml - Interactive Docs:
https://{service}.ecosyste.ms/docs - Format: JSON responses
- Authentication: Most endpoints are public, some may require API keys
Commercial user?
To operate an instance of ecosyste.ms or utilise ecosyste.ms' data for your own use, we offer less restrictive licences and generous rate limits