# searchInseeDatasets

**Identifier:** `insee_searchInseeDatasets`

**Provider:** [INSEE Statistics](https://kirha.com/providers/insee.md)

Search the 159 INSEE datasets of the Melodi API (census by commune, salaries, tourism, firms, prices, national accounts, poverty, first names...) by title words, to describe with describeInseeDataset and read with getInseeData.

## Run it with the CLI

```bash
kirha tools run insee_searchInseeDatasets \
  --input '{
    "query": "salaires"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "insee_searchInseeDatasets",
  "input": {
    "query": "salaires"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "description": "French or English words, e.g., salaires, tourisme, prénoms, logements",
      "minLength": 2,
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "datasets": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "datasetId": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "modified": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "datasetId",
          "title"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "total",
    "datasets"
  ],
  "type": "object"
}
```

## Related tools

Other INSEE Statistics tools that this tool refers to, or that refer to it.

- [`getInseeData`](https://kirha.com/providers/insee/getInseeData.md)
- [`describeInseeDataset`](https://kirha.com/providers/insee/describeInseeDataset.md)

-----

[All INSEE Statistics tools](https://kirha.com/providers/insee.md) · [< Back to tools list](https://kirha.com/tools.md)