Query Exports

Search…

Query Exports

The platform allows you to export data as ndjson, based on OTQL queries. This action is available in the navigator or through API to automate the process.
For punctual exports, you may want to use the navigator (in Data Studio > Exports) rather than our API for more simplicity.
An export is a definition with:
a name
an output format (always JSON for now)
a type (always QUERY for now)
an associated query
an associated organisation​
an associated datamart​
Each export has executions representing its result at a given time.
An execution goes through different stages:
Pending if the export is not started
Running if the export is started
Succeeded or Failed once the export has been completed
The resulting file is formatted in ndjson, and contains the properties you selected in the SELECT part of the OTQL query.
get
https://api.mediarithmics.com
/v1/exports?organisation_id=:orgId
Listing exports
get
https://api.mediarithmics.com
/v1/exports/:exportId?organisation_id=:orgId
Details of an export
Create an export
You will first need to create a query for your export.
You should check your query and verify its results before creating an export. It is easier to do at this step, as the export would only return an empty file and no message.
post
https://api.mediarithmics.com
/v1/exports?organisation_id=:orgId
Create an export
// Creating an export payload
{
    "name": "<YOUR_EXPORT_NAME>",
    "output_format": "JSON",
    "query_id": "<ID_OF_QUERY_CREATED_IN_PREVIOUS_STEP>",
    "type": "QUERY"
}
post
https://api.mediarithmics.com
/v1/exports/:exportId/executions
Generate an execution
get
https://api.mediarithmics.com
/v1/exports/:exportId/executions
Execution status
If available, the technical name of the file to download is in the result.output_files array
Download the result of an export
The result of an export is saved as a data file in the platform.
You have two methods to retrieve it :
Using the exports API (recommended)
Using the data_file API
get
https://api.mediarithmics.com
/v1/exports/:exportId/executions/:executionId/files/technical_name=:technicalName
Download using the exports API
get
https://api.mediarithmics.com
/v1/data_file/data?uri=mics://data_file/tenants/:organisationId/jobs/executions/:executionId/result/export.data
Download using the data_file API
get
https://api.mediarithmics.com
/v1/data_file/data?uri=mics://data_file/tenants/:organisationId/jobs/executions/:executionId/result/export.error
Download the error file

Advanced usages - Previous

Exporting your data

Datamart replication

Last modified 1yr ago

Copy link

On this page

get

Listing exports

get

Details of an export

Create an export

post

Create an export

post

Generate an execution

get

Execution status

Download the result of an export

get

Download using the exports API

get

Download using the data_file API

get

Download the error file