Grounding With Tako

Tako connects your app with real-time, trusted data that’s often not readily crawlable on the internet. Developers can use Tako’s API to ground their other response sources, and ensure consistency between what’s derived from other sources and what’s displayed in Tako cards. For example, Tako can help ground Nvidia’s stock price analysis you derive from LLMs and web search with Tako’s stock price cards that feature up-to-date pricing data. Tako includes the following information in each API response that can be used to ground answers.

Data Description: A natural language description of the data and visual elements included in the card (including last data point)

Sources: A list of sources, including a description of the source

Methodology: Methodology information for data present in the card

Static Image: A link to a static image of the card

Example API Response With Grounding Information

The following is an example response for a Weather Card from Tako:

{
  "outputs": {
    "knowledge_cards": [
      {
        "card_id": "mA-C6b48zxyU3G33JJdO",
        "title": "San Francisco, CA Weather Metrics",
        "description": "This card displays the weather forecast for San Francisco, CA for today, May 01, 2025, 08:00 PM. Currently, it's 52°F and feels like 52°F. The high for today is 54°F and the low is 50°F. The weather is expected to be partly cloudy. The card is focused on the Temperature tab, which shows the hourly Temperature forecast. The card also displays the weekly forecast for San Francisco, CA. On May 02, 2025, the weather is expected to be clear, with a high of 55°F and a low of 49°F. On May 03, 2025, the weather is expected to be clear, with a high of 53°F and a low of 48°F. On May 04, 2025, the weather is expected to be clear, with a high of 53°F and a low of 49°F. On May 05, 2025, the weather is expected to be clear, with a high of 55°F and a low of 50°F. On May 06, 2025, the weather is expected to be clear, with a high of 55°F and a low of 50°F. And finally on May 07, 2025, the weather is expected to be clear, with a high of 55°F and a low of 50°F. ",
        "webpage_url": "https://trytako.com/card/mA-C6b48zxyU3G33JJdO/",
        "image_url": "https://trytako.com/api/v1/get_image/mA-C6b48zxyU3G33JJdO/",
        "embed_url": "https://trytako.com/embed/mA-C6b48zxyU3G33JJdO/",
        "sources": [
          {
            "source_name": "NOAA National Weather Service",
            "source_description": "The National Weather Service (NWS) is an agency of the United States federal government that is tasked with providing weather forecasts, warnings of hazardous weather, and other weather-related products to organizations and the public for the purposes of protection, safety, and general information. It is a part of the National Oceanic and Atmospheric Administration (NOAA) branch of the Department of Commerce, and is headquartered in Silver Spring, Maryland, within the Washington metropolitan area.",
            "source_index": "tako"
          }
        ],
        "methodologies": [
          {
            "methodology_name": "Data Collection",
            "methodology_description": "This weather visualization utilizes raw meteorological data from the National Oceanic and Atmospheric Administration's (NOAA) National Weather Service (NWS). Hourly and daily forecast data were sourced directly from NWS APIs through their public-facing weather.gov data services. Temperature, precipitation probability, humidity, and wind measurements reflect NOAA's standard meteorological observations and predictive models, which incorporate ground station measurements, radar, satellite imagery, and numerical weather prediction models. The temperature graph displays a 24-hour forecast with readings taken at hourly intervals. All temperatures are displayed in Fahrenheit with Celsius conversion available. Moon phase calculations are derived from NOAA astronomical data. No statistical adjustments or data transformations were applied to the raw NWS datasets. This visualization was last updated on March 14, 2025, at 8:00 PM PDT to reflect the most current forecast information available from NOAA."
          }
        ],
        "source_indexes": [
          "tako"
        ]
      }
    ]
  },
  "request_id": "f20f965b-6bbd-40df-b50b-a8861f34df24"
}

By consuming the grounding information in the Tako API response, you can ensure your content is always up to date and accurate!

Getting Started

Integrating Tako

Popular Integrations and Examples

Grounding With Tako