Importing via JSON
Uploading your data with a JSON file provides most flexibility. When you import your external image URLs with a JSON file, you have the option to attach an external ID and metadata information to each of your assets.
Step 1: Format JSON file
imageUrl (REQUIRED): HTTP or HTTPS path to the external image URL.
externalId: Allows the user to tie a piece of data in the Labelbox database to a piece of data in a database outside of Labelbox.
info: The JSON object where a user can assign the metaType a metaValue to provide more information about the asset.
type: Allows the user to specify the media type attached to your asset: IMAGE, VIDEO, or TEXT.
value: Paths to external URLs are rendered on the web page as a video or image embed. Text strings that are not paths are simply rendered as text.
[
{
"externalId": "ab65d5e99w13",
"imageUrl": "https://storage.googleapis.com/labelbox-a.jpg",
"info": {
"type": "IMAGE",
"value": "https://firebasestorage.googleapis.com/v0/b/"
}
},
{
"externalId": "ljk6s544a7f8",
"imageUrl": "https://storage.googleapis.com/labelbox-b.jpg",
"info": {
"type": "VIDEO",
"value": "http://commondatastorage.googleapis.com/b.mp4"
}
},
{
"externalId": "ljk6s544a7f8",
"imageUrl": "https://storage.googleapis.com/labelbox-c.jpg",
"info": {
"type": "TEXT",
"value": "Lorem ipsum dolor sit amet."
}
}
]
Step 2: Import JSON file
There are three methods for importing your data via JSON.
Labelbox web app
If you have a paid Labelbox account, you can upload new data via JSON or CSV in the Labelbox web app.
Note: this is only available in our legacy image editor.
Python API
If you have an API key, you may import data as a JSON file using our Python API. For more detail, see the documentation for the create_data_rows() method in our Python API reference.
GraphQL API
To learn how to use the appendRowsToDataset GraphQL mutation to import a JSON file, see How to import data.
