4.2 How to Access the Data Boutique Dataset Catalog via API
How to Access the Data Boutique Dataset Catalog via API
Data Boutique offers API access to its dataset catalog, allowing users to browse all available data feeds directly. This is facilitated through the Softr API, where Data Boutique provides a Personal Authentication Token to enable secure access to a dedicated base containing all currently active contracts on the platform.
Getting Started with the Softr API
To access the Data Boutique catalog, you will need:
- Personal Authentication Token: Data Boutique will provide you with a token, which you’ll use to authenticate API requests.
- API Documentation: Full documentation for the Softr API is available [here](link to documentation).
- ListRecords Endpoint: Use the
ListRecords
endpoint to pull data from the catalog.
API Configuration Details
- Base ID:
app7DtPHxXIGPxjb9
- Table ID:
tblts91SHwrNOT3zz
Example API Call Using cURL
Here’s a sample API request to access the catalog via cURL:
curl "https://api.airtable.com/v0/app7DtPHxXIGPxjb9/tblts91SHwrNOT3zz" \
-H "Authorization: Bearer YOUR_TOKEN"
Replace YOUR_TOKEN
with the Personal Authentication Token provided by Data Boutique.
How to Read the API Response
The API will return data in JSON format, with each response containing a single page of records (default page size is 100). If there are more records, the response will include an offset
parameter, which you can use to fetch additional pages. Pagination continues until all records are retrieved or until the maxRecords
limit, if specified.
For an example response structure, view this JSON sample.
Data Dictionary
The dataset catalog is organized into the following fields:
Field | Description |
Contract | Data seller contract ID, unique identifier for the data feed |
Title | Short name for the data feed |
Geography Description | Name of the geographical region |
Geography Code | Code of the geography |
Schema Description | Brief description of the schema |
Schema Code | Schema identifier |
Website Name | Name of the source website |
Website Image | URL of the cover image |
Geography Image | URL of the geography’s flag |
Refresh Policy | Frequency of data updates (e.g., daily, weekly, monthly) |
Price | Purchase price in EUR |
Sample File | URL to download a sample of the dataset |
Last Delivered Date | Most recent delivery date of data |
DBQ Product URL | Relative URL for the product page; prepend |
This data structure enables you to efficiently browse and filter the catalog for relevant datasets.
Using the Catalog Data
Through this API integration, you can directly incorporate Data Boutique’s catalog into your applications, enabling users to discover and explore available datasets without leaving your platform. As new datasets are added or updated on Data Boutique, they will be reflected automatically in the API.