---
title: "Search for datasets in the database"
method: GET
path: "/v3/api1/datasets"
tags: ["api"]
---

# Search for datasets in the database

`GET /v3/api1/datasets`

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

## Query parameters

- `query` string — Free-text search query.
- `offset` integer — Pagination start index
- `limit` integer — Number of results to return
- `sector` string — Industrial Sector i.e. Electricity
- `geography` string — Geography of production for a product/activity
- `isic_section` string — Standard Classification of all Economic activities, level 1 section
- `isic_class` string — Standard Classification of all Economic activities, level 4 class
- `activity_type` 'TRANSFORMING_ACTIVITY' | 'MARKET_ACTIVITY' | 'IO_ACTIVITY' | 'RESIDUAL_ACTIVITY' | 'PRODUCTION_MIX' | 'IMPORT_ACTIVITY' | 'SUPPLY_MIX' | 'EXPORT_ACTIVITY' | 'RE_EXPORT_ACTIVITY' | 'CORRECTION_ACTIVITY' | 'MARKET_GROUP'
- `activity_spold_uuid` string, uuid — Filter results by activity spold UUID
- `product_spold_uuid` string, uuid — Filter results by product spold UUID
- `version` string — Version name or 'latest'
- `system_model` string — System model name or 'cutoff'

## Response `200`

Successful search response with matching datasets

- SearchResponse
  - `facets` Filters
    - `sectors` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `geographies` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `isic_sections` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `isic_classes` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `activity_types` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `geography_hierarchy` GeographyHierarchyRoot
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required
  - `version` string, required
  - `system_model` string, required
  - `results` ActivityResult[]
    - `name` string, required
    - `activity_type` 'TRANSFORMING_ACTIVITY' | 'MARKET_ACTIVITY' | 'IO_ACTIVITY' | 'RESIDUAL_ACTIVITY' | 'PRODUCTION_MIX' | 'IMPORT_ACTIVITY' | 'SUPPLY_MIX' | 'EXPORT_ACTIVITY' | 'RE_EXPORT_ACTIVITY' | 'CORRECTION_ACTIVITY' | 'MARKET_GROUP', required
    - `time_period` string, required
    - `sectors` string[] — Industrial Sector i.e. Electricity
    - `time_period_comment` string — Time period comment
    - `isic_section` string, required — Standard Classification of all Economic activities, level 1 section
    - `isic_class` string, required — Standard Classification of all Economic activities, level 4 class
    - `products` ProductResult[], required
      - `name` string
      - `unit` string
      - `datasets` DatasetResult[], required
        - `id` union, required
          - integer
          - string, uuid
        - `geography` string, required
        - `impact_score` number
        - `impact_unit` string
        - `description` string
        - `included_activity_starts` string — Included activity starts
        - `included_activity_ends` string — Included activity ends
        - `technology_comment` string — Technology comment
        - `activity_spold_uuid` string
        - `product_spold_uuid` string
        - `geography_spold_uuid` string
        - `ecoquery_url` string, required
        - `ecoquery_history_url` string, required
      - `total_datasets` integer, required
    - `total_products` integer, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Requested resource not found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ecoinvent/apis/ecoquery-user-api.md) · [All operations](https://skmtc.dev/ecoinvent/apis/ecoquery-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ecoinvent/ecoquery-user-api/revisions/8a4aea6b7285/schema)