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

Query parameters

querystring · max: 255Optional

fromintegerOptional

Pagination start index

Default: 0

limitinteger · max: 100Optional

Number of results to return

Default: 10

sectorstringOptional

geographystringOptional

isic_sectionstringOptional

isic_classstringOptional

cpcstringOptional

activity_typestringOptional

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

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": "Production of high voltage electricity",
      "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
      }
    ]
  }
}