Discover instead of hard-coding
GET /datasets returns the catalogs visible to the credential. Use the dataset id as the stable integration key; treat the human-readable name and description as display copy.
GET /v1/datasetsInspect the dataset definition
GET /v1/datasets/{dataset_id}Read version, row_entity_type, market, language, jurisdiction, fields, identity_fields, latest_release, and release_count before accepting a catalog in production.
Field descriptors
| Property | Meaning |
|---|---|
| name | Field name in query and download rows |
| type | Logical scalar type |
| format | Optional semantic format such as date-time |
| unit | Optional measurement or currency unit |
| required | Whether every conforming row must contain the field |
Preserve source identity
identity_fields define the source-level key used to reconcile records. Store them even if your application also creates its own surrogate key. A dataset_row_id may identify the normalized row, while source identity lets you trace it back to the originating listing.