Search

Search for datasets in the database

get

This endpoint allows searching for datasets using various filters and query parameters. You find a full list of potential filters in the response of your query.

Authorizations

OAuth2ClientCredentials

OAuth2clientCredentialsRequired

Token URL:

Query parameters

queryany ofOptional

Free-text search query. You can also provide an activity UUID or product UUID to retrieve the datasets associated with that activity or product.

string · max: 255Optional

or

nullOptional

fromintegerOptional

Pagination start index

Default: 0

limitinteger · max: 100Optional

Number of results to return

Default: 10

sectorany ofOptional

Industrial Sector i.e. Electricity

stringOptional

or

nullOptional

geographyany ofOptional

Geography of production for a product/activity

stringOptional

or

nullOptional

isic_sectionany ofOptional

Standard Classification of all Economic activities, level 1 section

stringOptional

or

nullOptional

isic_classany ofOptional

Standard Classification of all Economic activities, level 4 class

stringOptional

or

nullOptional

cpcany ofOptional

Central product classification, comprehensive classification of all products

stringOptional

or

nullOptional

activity_typeany ofOptional

Type of activity i.e. market or transforming activity

stringOptional

or

nullOptional

versionstringOptional

Version name or 'latest'

Default: latest

system_modelstringOptional

System model name or 'cutoff'

Default: cutoff

Responses

200

Successful search response with matching datasets

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Requested resource not found

application/json

422

Validation Error

application/json

500

Internal Server Error

application/json

get

/v0/datasets

HTTPcURLJavaScriptPython

GET /v0/datasets HTTP/1.1
Host: api.ecoinvent.org
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "total": 1,
  "results": [
    {
      "id": 12345,
      "activity": "electricity production",
      "product": "electricity, high voltage",
      "description": "Generation of high-voltage electricity supplied to the grid",
      "included_activity_starts": "from cradle",
      "included_activity_ends": "to gate",
      "time_period_comment": "Representative for the period 2012-2022",
      "technology_comment": "Average European technology mix",
      "geography": "Switzerland (CH)",
      "unit": "kWh",
      "time_period": "2012-2022",
      "activity_type": "ordinary transforming activity",
      "isic_section": "D - Electricity",
      "isic_class": "3510 - Electric power generation",
      "activity_spold_uuid": "ff12345a-1234-5678-9abc-123456789abc",
      "geography_spold_uuid": "dd12345a-1234-5678-9abc-123456789abc",
      "product_spold_uuid": "ee12345a-1234-5678-9abc-123456789abc",
      "sectors": [
        "Electricity"
      ],
      "url": "https://ecoquery.ecoinvent.org/3.00/cutoff/dataset/12345/documentation",
      "url_history": "https://ecoquery.ecoinvent.org/3.00/cutoff/dataset/12345/history"
    }
  ],
  "filters": {
    "sectors": [
      {
        "name": "Electricity",
        "count": 20
      },
      {
        "name": "Manufacturing",
        "count": 15
      }
    ],
    "geographies": [
      {
        "name": "Global (GLO)",
        "count": 10
      },
      {
        "name": "Switzerland (CH)",
        "count": 5
      }
    ],
    "isic_sections": [
      {
        "name": "D - Electricity",
        "count": 20
      }
    ],
    "isic_classes": [
      {
        "name": "3510 - Electric power generation",
        "count": 12
      }
    ],
    "activity_types": [
      {
        "name": "ordinary transforming activity",
        "count": 25
      }
    ]
  }
}