removedInput schema / $schema
Removed value: -"http://json-schema.org/draft-07/schema#"
addedInput schema / properties / after
Added value: +{
+ "description": "Pagination en profondeur : la valeur à passer est celle du paramètre `after` de l'URL **next** du résultat précédent.\n\n*Automatiquement renseigné par la propriété **next** du résultat de la requête précédente.*",
+ "type": "string"
+}
addedInput schema / properties / bbox / examples
Added value: +[
+ "2.2241,48.8156,2.4699,48.9022"
+]
changedInput schema / properties / datasetId / description
Previous value: -"The exact dataset ID from the \"id\" field in list_datasets results. Do not use the title or slug."New value: +"The \"id\" of a datafair_list_account_datasets result, not its title or slug."
removedInput schema / properties / filters / additionalProperties
Removed value: -{
- "type": "string"
-}
changedInput schema / properties / filters / description
Previous value: -"Column filters as key-value pairs: column_key + suffix, all values strings. Example: { \"ville_eq\": \"Paris\", \"age_lte\": \"30\", \"nom_search\": \"Jean\" }. Suffixes include _eq, _in, _gt/_lt, _search and more; if one is rejected the 400 error lists what the column supports. Never _c_-prefix a column filter (use ville_eq, not _c_ville_eq)."New value: +"Column filters { \"<column key><suffix>\": \"<value as a string>\" }, e.g. { \"ville_eq\": \"Paris\", \"age_lte\": \"30\", \"nom_search\": \"Jean\" }. Suffixes: _eq _neq _in _nin (comma-separated) _gt _gte _lt _lte _starts _exists _nexists _search (words, the default for text) _contains (when enabled). A rejected suffix answers a 400 listing the column's. Never prefix with _c_."
addedInput schema / properties / filters / patternProperties
Added value: +{
+ ".*": {
+ "default": "",
+ "type": "string"
+ }
+}
removedInput schema / properties / filters / propertyNames
Removed value: -{
- "pattern": "^.+_(search|eq|neq|in|nin|starts|contains|gte?|lte?|n?exists)$"
-}
removedInput schema / properties / next
Removed value: -{
- "description": "URL from a previous search_data response to fetch the next page of results. When provided, all other parameters (query, filters, select, sort, size) are ignored since the URL already contains them.",
- "type": "string"
-}
changedInput schema / properties / query / description
Previous value: -"French keywords for full-text search across all dataset columns (simple keywords, not sentences). Can be combined with filters, but prefer filters alone when criteria target specific columns. Use query for broad keyword matching across all columns. Examples: \"Jean Dupont\", \"Paris\", \"2025\""New value: +"Full-text search across all columns. Prefer filters for structured criteria."
addedInput schema / properties / query / maxLength
Added value: +1000
changedInput schema / properties / select / description
Previous value: -"Optional comma-separated list of column keys to include in the results. Useful when the dataset has many columns to reduce output size. If not provided, all columns are returned. Use column keys from describe_dataset. Format: column1,column2,column3 (No spaces after commas). Example: \"nom,age,ville\""New value: +"Column keys to include in the response, as an array. Use column keys from datafair_describe_dataset. If omitted, all columns are returned."
addedInput schema / properties / select / items
Added value: +{
+ "type": "string"
+}
changedInput schema / properties / select / type
Previous value: -"string"New value: +"array"
addedInput schema / properties / size / default
Added value: +12
changedInput schema / properties / size / description
Previous value: -"Number of rows to return per page (default: 10, max: 50). Increase when you know you need more results upfront to avoid multiple pagination round-trips."New value: +"Le nombre de résultats à retourner (taille de la pagination)."
addedInput schema / properties / size / format
Added value: +"int32"
addedInput schema / properties / size / maximum
Added value: +100
addedInput schema / properties / size / minimum
Added value: +0
changedInput schema / properties / size / type
Previous value: -"number"New value: +"integer"
changedInput schema / properties / sort / description
Previous value: -"Sort order for results. Comma-separated list of column keys. Prefix with - for descending order. Special keys: _score (relevance), _i (index order), _updatedAt, _rand (random), _geo_distance:lon:lat (distance from point, for geolocalized datasets — longitude first, then latitude). Examples: \"population\" (ascending), \"-population\" (descending), \"_geo_distance:2.35:48.85\" (closest to lon=2.35, lat=48.85)"New value: +"Array of column keys to sort by, one per element. Prefix a key with - for descending."
addedInput schema / properties / sort / items
Added value: +{
+ "type": "string"
+}
changedInput schema / properties / sort / type
Previous value: -"string"New value: +"array"
changedOutput schema / (root)
Previous value: -{
- "$schema": "http://json-schema.org/draft-07/schema#",
- "additionalProperties": false,
- "properties": {
- "datasetId": {
- "description": "The dataset ID that was searched",
- "type": "string"
- },
- "filteredViewUrl": {
- "description": "Link to view the filtered dataset results in table format (must be included in responses for citation and direct access to filtered view)",
- "type": "string"
- },
- "next": {
- "description": "URL to fetch the next page of results. Absent when there are no more results. Pass this value as the next input parameter to get the next page.",
- "type": "string"
- },
- "results": {
- "description": "An array of data rows matching the search criteria (up to the requested size).",
- "items": {
- "additionalProperties": {},
- "type": "object"
- },
- "type": "array"
- },
- "total": {
- "description": "Number of data rows matching the search criteria and filters",
- "type": "number"
- }
- },
- "required": [
- "datasetId",
- "total",
- "filteredViewUrl",
- "results"
- ],
- "type": "object"
-}New value: +null