API for DataSet tags

Thank you @MarkSnodgrass and @ggenovese.

I had been searching different endpoints and couldn't find the correct one. @ggenovese , the endpoint you listed was what I needed for my search. After a bit of exhaustive code changes, the following will display a list of the datasets with tag "Your_Tag_Goes_Here". And all the information about the datasets. From there, we can gather the specific fields needed.

My specific use for this is to extract my API dataset list (based on name search for a string I include in all my API calls), and my Jupyter dataset list (based on the tag, using code below) and automate them into a scheduling Gantt chart. I've been hoping Domo would create one.

import requests
import json

# 10.03.24 Author: ArborRose
# This Python code uses the Domo API to retrieve
# datasets based on the "tag". 

# Domo API Credentials (replace with your developer token)
developer_token = 'your_developer_token'

# Set headers for the API call
headers = {
    'X-DOMO-Developer-Token': developer_token,
    'Content-Type': 'application/json'
}

# API URL for fetching datasets and their tags
url = 'https://yourinstance.domo.com/api/data/ui/v3/datasources/search'

# Payload for searching datasets by tag
payload = {
    "entities": ["DATASET"],  # Specify that we want datasets
    "filters": [
        {
            "filterType": "facetValue",
            "field": "tag",
            "value": "Your_Tag_Goes_Here"  # Replace with your tag as needed
        }
    ],
    "combineResults": "true",
    "query": "*",  # Use wildcard to match all
    "count": 500,  # Number of datasets to retrieve
    "offset": 0,  # Starting offset for pagination
    "sort": {
        "isRelevance": "false",
        "fieldSorts": [
            {
                "field": "create_date",
                "sortOrder": "DESC"  # Sort by creation date
            }
        ]
    }
}

# Make the API request to search for datasets
response = requests.post(url, json=payload, headers=headers)

# Check if the request was successful
if response.status_code == 200:
    # Print the full response to understand its structure
    response_data = response.json()
    print(json.dumps(response_data, indent=2))  # Pretty-print the JSON response
else:
    print(f"Failed to fetch datasets: {response.status_code} - {response.text}")

Thanks for the note. When I'm debugging code, I often use a temporary token with a quick expiration. One odd thing I found about the API, it doesn't contain information in the field dataLastUpdated.

I assume last updated is when the code was last update, not the data. I need to know the code ran and data was populated via the API it was calling.

@jlrosenlof - The API has the tag list as an array. In my code above, I'm only pulling based on the tag "Jupyter". But the API does show an array for the datasets that have more than one tag.