Opendatasoft · Example Payload

Dataset Facets

Open DataDatasetsPublic DataODataRESTGovernmentCities

Dataset Facets is an example object payload from Opendatasoft, with 2 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

requestresponse

Example Payload

Raw ↑
{
  "request": {
    "method": "GET",
    "url": "https://{domain}/api/explore/v2.1/catalog/datasets/{dataset_id}/facets",
    "parameters": {
      "facet": [
        "country_code",
        "continent"
      ],
      "where": "population > 1000",
      "lang": "en",
      "timezone": "UTC"
    }
  },
  "response": {
    "facets": [
      {
        "name": "country_code",
        "facets": [
          {
            "name": "US",
            "count": 4122,
            "state": "displayed",
            "facets": []
          },
          {
            "name": "CN",
            "count": 3891,
            "state": "displayed",
            "facets": []
          },
          {
            "name": "IN",
            "count": 3204,
            "state": "displayed",
            "facets": []
          }
        ]
      },
      {
        "name": "continent",
        "facets": [
          {
            "name": "Asia",
            "count": 48312,
            "state": "displayed",
            "facets": []
          },
          {
            "name": "Europe",
            "count": 28450,
            "state": "displayed",
            "facets": []
          },
          {
            "name": "North America",
            "count": 12098,
            "state": "displayed",
            "facets": []
          }
        ]
      }
    ]
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This example
curl "https://apis.io/api/v1/examples/dataset-facets"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.