Open In Colab
GitHub
Export as JSON
# Set the export params to include/exclude certain fields.
export_params= {
"attachments": True,
"metadata_fields": True,
"data_row_details": True,
"project_details": True,
"label_details": True,
"performance_details": True,
"interpolated_frames": True
}
# Note: Filters follow AND logic, so typically using one filter is sufficient.
filters= {
"last_activity_at": ["2000-01-01 00:00:00", "2050-01-01 00:00:00"],
"workflow_status": "<wkf-status>"
}
export_task = project.export(params=export_params, filters=filters)
export_task.wait_till_done()
# Stream the export using a callback function
def json_stream_handler(output: labelbox.BufferedJsonConverterOutput):
print(output.json)
export_task.get_buffered_stream(stream_type=labelbox.StreamType.RESULT).start(stream_handler=json_stream_handler)
# Collect all exported data into a list
export_json = [data_row.json for data_row in export_task.get_buffered_stream()]
print("file size: ", export_task.get_total_file_size(stream_type=lb.StreamType.RESULT))
print("line count: ", export_task.get_total_lines(stream_type=lb.StreamType.RESULT))
Annotation export formats
Global and temporal classifications share the same export format for each type. In the export JSON file, temporal classifications are nested under atimestamp field, while global classifications appear directly under the classifications field, segments are per feature_id and represent the beginning and the end of the temporal classification in milliseconds. See the Sample project export to learn how each type is organized in the export.
Classification - radio
{
"feature_id": "clnus73114gc4143u2dux654s",
"feature_schema_id": "clnus6slv06xo07yja7l47gtw",
"name": "radio_audio",
"value": "radio_audio",
"radio_answer": {
"feature_id": "clnus73114gc5143u2jadnt6r",
"feature_schema_id": "clnus6slv06xr07yj24yp1gdk",
"name": "second_radio_answer",
"value": "second_radio_answer",
"classifications": []
}
}
Classification - checklist
{
"feature_id": "clnus73114gc1143u7fzf4ebv",
"feature_schema_id": "clnus6slu06xi07yj7m9d7rft",
"name": "checklist_audio",
"value": "checklist_audio",
"checklist_answers": [
{
"feature_id": "clnus73114gc2143u6ah5wdhn",
"feature_schema_id": "clnus6slu06xj07yj9eb7dpvp",
"name": "first_checklist_answer",
"value": "first_checklist_answer",
"classifications": []
},
{
"feature_id": "clnus73114gc3143uq755vkzi",
"feature_schema_id": "clnus6slu06xl07yjdab4gxe8",
"name": "second_checklist_answer",
"value": "second_checklist_answer",
"classifications": []
}
]
}
Classification - free-form text
{
"feature_id": "clnus73114gc0143urjlfk558",
"feature_schema_id": "clnus6slu06xg07yjcg87apa0",
"name": "text_audio",
"value": "text_audio",
"text_answer": {
"content": "free text audio annotation"
}
}
Sample project export
[
{
"data_row": {
"id": "clzc6xfbealyn0713j929vdch",
"external_id": "example.mp3",
"row_data": "https://storage.googleapis.com/labelbox-datasets/audio-sample-data/sample-audio-1.mp3"
},
"media_attributes": {
"asset_type": "audio",
"mime_type": "audio/mpeg"
},
"projects": {
"clzc89nk900l707zmamti5zi0": {
"name": "Example audio project",
"labels": [
{
"label_kind": "Audio",
"version": "1.0.0",
"id": "cm8x9w1xj00h307ev0jmh8648",
"annotations": {
"classifications": [
{
"feature_id": "cm8xa12hd00023b6t0t3zirna",
"feature_schema_id": "cm8x9zz4d04ed071363gvhh5j",
"name": "Example global free text",
"value": "example_global_free_text",
"text_answer": {
"content": "Example global free text label",
"classifications": []
}
},
{
"feature_id": "cm8xa164700043b6t7wyqo0vv",
"feature_schema_id": "cm8x9zz4e04ef0713db9vea0f",
"name": "Example global radio",
"value": "example_global_radio",
"radio_answer": {
"feature_id": "cm8xa164600033b6tvz63hfqi",
"feature_schema_id": "cm8x9zz4e04eg0713hsxe3t0d",
"name": "Option 1",
"value": "option_1",
"classifications": []
}
},
{
"feature_id": "cm8xa17ps00063b6txb4g30fw",
"feature_schema_id": "cm8x9zz4e04er0713fc6fcs2r",
"name": "Example global checklist",
"value": "example_global_checklist",
"checklist_answers": [
{
"feature_id": "cm8xa17ps00053b6tc2skf6oh",
"feature_schema_id": "cm8x9zz4f04es0713g860a82c",
"name": "Option 1",
"value": "option_1",
"classifications": []
},
{
"feature_id": "cm8xa181c00083b6t7i9pixsb",
"feature_schema_id": "cm8x9zz4f04eu0713b95l1u2f",
"name": "Option 2",
"value": "option_2",
"classifications": []
}
]
}
],
"timestamp": {
"90697": {
"classifications": [
{
"feature_id": "cm8xa1k8600093b6tnrzpuq1n",
"feature_schema_id": "cm3jdcfpg0m6m07081ju276sz",
"name": "Example temporal free text",
"value": "free_text",
"text_answer": {
"content": "Example temporal free text label 1",
"classifications": []
}
},
{
"feature_id": "cm8xa2d2u000a3b6tk29o8u48",
"feature_schema_id": "cm8x9zz4e04el07135zmghx1q",
"name": "Example temporal radio",
"value": "example_temporal_radio",
"radio_answer": {
"feature_id": "cm8xa2d2u000b3b6ti9kszxcg",
"feature_schema_id": "cm8x9zz4e04em07132athat2z",
"name": "Option 1",
"value": "option_1",
"classifications": []
}
},
{
"feature_id": "cm8xa2hhh000c3b6tzeluuhpt",
"feature_schema_id": "cm8x9zz4f04ex0713f5rehhp0",
"name": "Example temporal checklist",
"value": "example_temporal_checklist",
"radio_answer": {
"feature_id": "cm8xa2ila000e3b6t410j19ir",
"feature_schema_id": "cm8x9zz4f04f00713drwj6qpb",
"name": "Option 2",
"value": "option_2",
"classifications": []
}
}
]
},
"23890": {
"classifications": [
{
"feature_id": "cm8xa1k8600093b6tnrzpuq1n",
"feature_schema_id": "cm3jdcfpg0m6m07081ju276sz",
"name": "Example temporal free text",
"value": "free_text",
"text_answer": {
"content": "Example temporal free text label 1",
"classifications": []
}
}
]
},
"6157": {
"classifications": [
{
"feature_id": "cm8xa1k8600093b6tnrzpuq1n",
"feature_schema_id": "cm3jdcfpg0m6m07081ju276sz",
"name": "Example temporal free text",
"value": "free_text",
"text_answer": {
"content": "Example temporal free text label 2",
"classifications": []
}
}
]
},
"33496": {
"classifications": [
{
"feature_id": "cm8xa2d2u000a3b6tk29o8u48",
"feature_schema_id": "cm8x9zz4e04el07135zmghx1q",
"name": "Example temporal radio",
"value": "example_temporal_radio",
"radio_answer": {
"feature_id": "cm8xa2d2u000b3b6ti9kszxcg",
"feature_schema_id": "cm8x9zz4e04em07132athat2z",
"name": "Option 1",
"value": "option_1",
"classifications": []
}
}
]
},
"60711": {
"classifications": [
{
"feature_id": "cm8xa2hhh000c3b6tzeluuhpt",
"feature_schema_id": "cm8x9zz4f04ex0713f5rehhp0",
"name": "Example temporal checklist",
"value": "example_temporal_checklist",
"radio_answer": {
"feature_id": "cm8xa2ila000e3b6t410j19ir",
"feature_schema_id": "cm8x9zz4f04f00713drwj6qpb",
"name": "Option 2",
"value": "option_2",
"classifications": []
}
}
]
}
},
"segments": {
"cm8xa1k8600093b6tnrzpuq1n": [
[
6157,
90697
]
],
"cm8xa2d2u000b3b6ti9kszxcg": [
[
33496,
90697
]
],
"cm8xa2ila000e3b6t410j19ir": [
[
60711,
90697
]
]
}
}
}
],
"project_tags": []
}
}
}
]