The Scope3 AI API implements an open source modeling methodology. Pull requests and issues are appreciated and may be provided via GitHub.
The AI API is currently in active development and historical data is not consistent with methodology changes. When the methodology and API are ready for production use, we will start to publish monthly updates and provide historical consistency.
There are no hard limits, and the API was designed with scale in mind. That said, it is not designed to be a real-time system.
The Scope3 API does not have a strict rate-limiting policy; instead, the API infrastructure will scale to meet the demand. During high load, the API may return a “429 Too Many Requests” HTTP response code. If your application receives a 429 response, it should retry the request after a small delay.
For best performance, we suggest sending 4,000 to 8,000 rows per request. The API will accept and process more than this, but your overall throughput will be higher if you split your workload into the suggested batch sizes above.
In general, we do not recommend caching. If you are looking for ways to reduce the number of requests, please reach out to Scope3 support for best practices based on your use case.
There are four dimensions to how well we support a country:
We have good coverage across the above dimensions in the US, Canada, Europe, Australia, and New Zealand. We have limited electricity grid, telco, and consumer device data in Latin America and Southeast Asia, so our data will be less accurate in those cases. We have not worked directly with publishers outside these regions, so there may be local differences that we are not tracking.
We have real-time grid mix data for 28 countries with region-level data in the US, CA, and AU. For the 200 other supported countries, we use yearly emissions data sourced from the UN Climate Change.