Examples

curl -G "https://api.creativeforesight.io/v1/ask" \
  --data-urlencode "q=How does Williamson County Tennessee's economy compare to the rest of the state right now?" \
  -H "X-API-Key: cf_live_..."

{
  "answer": "Williamson County significantly outperforms Tennessee on income and jobs, while both share the broader statewide labor-market recovery trend.\n\n**Income:** Williamson County's real median household income hit an all-time high of $135,594 in 2024, nearly double Tennessee's statewide high of $69,595 in the same year. Both grew steadily over the prior decade — Williamson up 51% since 2013 (3.8%/year), Tennessee up 57% (4.2%/year) — but Williamson's dollar level remains far above the state's throughout.\n\n**Unemployment:** Williamson County's unemployment rate is 2.4% (May 2026), the lowest of all 95 Tennessee counties, ranking 1st. Tennessee's statewide rate is 3.6%, meaning Williamson runs noticeably tighter/stronger in labor-market terms. Both have fallen sharply from their pandemic-era peaks (Williamson from 10.5% in April 2020, Tennessee from 15.7% in April 2020), reflecting a strong statewide recovery, but Williamson's rate has consistently sat below the state average.\n\n**Bottom line:** Williamson County is one of Tennessee's wealthiest and tightest labor markets — income nearly double the state median and the lowest unemployment rate among all 95 counties — while still tracking the same general upward income trend and post-pandemic labor recovery seen statewide.",
  "citations": [
    {
      "tool": "search_indicators",
      "args": {
        "query": "median household income"
      },
      "summary": "{\"data\":[{\"id\":\"1ea921e3-f8c0-41fc-82d4-cd9544a9381e\",\"code\":\"census.acs_median_household_income.real_usd.y\",\"name\":\"ACS – Median Household Income (Real $)\",\"description\":null,\"source\":\"census\",\"categ"
    },
    {
      "tool": "search_indicators",
      "args": {
        "query": "unemployment rate"
      },
      "summary": "{\"data\":[{\"id\":\"86d69c85-8507-4fc1-af32-5d2b49ceb29f\",\"code\":\"unemployment_rate\",\"name\":\"Unemployment Rate\",\"description\":\"Seasonally adjusted unemployment rate\",\"source\":\"bls\",\"category\":\"labor\",\"sub"
    },
    {
      "tool": "search_indicators",
      "args": {
        "query": "gdp"
      },
      "summary": "{\"data\":[{\"id\":\"d9e073d5-7aa8-4fa5-b1f6-189ec706bad9\",\"code\":\"BEA:NIPA:T10101:1:Q\",\"name\":\"Real GDP % change\",\"description\":null,\"source\":\"bea\",\"category\":\"macro\",\"subcategory\":\"national-accounts\",\"ac"
    },
    {
      "tool": "search_indicators",
      "args": {
        "query": "population"
      },
      "summary": "{\"data\":[{\"id\":\"12b4ca36-d4c2-43c9-a5b4-eccbdf18c70c\",\"code\":\"census.acs_foreign_born_share.pct.y\",\"name\":\"ACS – Foreign-Born Population Share (%)\",\"description\":null,\"source\":\"census\",\"category\":\"dem"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "census.acs_median_household_income.real_usd.y",
        "region": "47187"
      },
      "summary": "{\"facts\":[{\"kind\":\"watermark_high_distance\",\"params\":{\"latestDate\":\"2024-01-01\",\"latestValue\":135594,\"watermarkDate\":\"2024-01-01\",\"watermarkValue\":135594,\"distance\":0,\"percentDistance\":0,\"absPercentDi"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "census.acs_median_household_income.real_usd.y",
        "region": "47"
      },
      "summary": "{\"facts\":[{\"kind\":\"watermark_high_distance\",\"params\":{\"latestDate\":\"2024-01-01\",\"latestValue\":69595,\"watermarkDate\":\"2024-01-01\",\"watermarkValue\":69595,\"distance\":0,\"percentDistance\":0,\"absPercentDist"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "unemployment_rate",
        "region": "47187"
      },
      "summary": "{\"facts\":[{\"kind\":\"peer_rank\",\"params\":{\"rank\":95,\"total\":95,\"latestValue\":2.4,\"peers\":[{\"region\":\"47135\",\"value\":5.3},{\"region\":\"47067\",\"value\":4.7},{\"region\":\"47137\",\"value\":4.7},{\"region\":\"47069\",\""
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "unemployment_rate",
        "region": "47"
      },
      "summary": "{\"facts\":[{\"kind\":\"trend\",\"params\":{\"direction\":\"down\",\"startDate\":\"2010-01-01\",\"endDate\":\"2026-05-01\",\"startValue\":10.5,\"endValue\":3.6,\"absoluteChange\":-6.9,\"percentChange\":-0.6571428571428571,\"absPe"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "census.pep_total_population.count.y",
        "region": "47187"
      },
      "summary": "{\"facts\":[],\"signals\":[],\"meta\":{\"indicator\":\"census.pep_total_population.count.y\",\"region\":\"47187\",\"unit\":\"count\",\"window\":\"all\",\"observation_count\":0,\"source_attribution\":\"Source: U.S. Census Bureau"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "census.pep_total_population.count.y",
        "region": "47"
      },
      "summary": "{\"facts\":[],\"signals\":[],\"meta\":{\"indicator\":\"census.pep_total_population.count.y\",\"region\":\"47\",\"unit\":\"count\",\"window\":\"all\",\"observation_count\":0,\"source_attribution\":\"Source: U.S. Census Bureau\"}}"
    }
  ],
  "resolved": {
    "indicators": [
      "census.acs_median_household_income.real_usd.y",
      "unemployment_rate",
      "census.pep_total_population.count.y"
    ],
    "regions": [
      "47187",
      "47"
    ],
    "window": "all"
  },
  "grounded": true,
  "truncated": false,
  "status": "ok",
  "meta": {
    "model": "anthropic/claude-sonnet-5",
    "rounds": 3,
    "toolCalls": 10,
    "depth": "standard"
  }
}

curl -G "https://api.creativeforesight.io/v1/ask" \
  --data-urlencode "q=Give me three data points I can cite in a social media post about how strong Williamson County Tennessee's economy is." \
  -H "X-API-Key: cf_live_..."

{
  "answer": "Here are three citable data points on Williamson County, TN's economy:\n\n1. **Lowest unemployment in the state:** Williamson County posted a 2.4% unemployment rate as of May 2026 — the lowest of all 95 Tennessee counties (ranked 1st of 95).\n\n2. **Record household income:** Real median household income hit an all-time high of $135,594 in 2024, up 51% from $89,779 in 2013 (about 3.8% annualized growth).\n\n3. **Booming population:** The county's population reached an all-time high of 272,061 in 2025, up 48% since 2010 (roughly 2.6% annual growth) — the 6th-largest population among Tennessee's 95 counties.",
  "citations": [
    {
      "tool": "get_insights",
      "args": {
        "indicator": "population",
        "region": "47187"
      },
      "summary": "{\"facts\":[{\"kind\":\"watermark_high_distance\",\"params\":{\"latestDate\":\"2025-01-01\",\"latestValue\":272061,\"watermarkDate\":\"2025-01-01\",\"watermarkValue\":272061,\"distance\":0,\"percentDistance\":0,\"absPercentDi"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "median_income",
        "region": "47187"
      },
      "summary": "{\"facts\":[{\"kind\":\"watermark_high_distance\",\"params\":{\"latestDate\":\"2024-01-01\",\"latestValue\":135594,\"watermarkDate\":\"2024-01-01\",\"watermarkValue\":135594,\"distance\":0,\"percentDistance\":0,\"absPercentDi"
    },
    {
      "tool": "search_indicators",
      "args": {
        "query": "unemployment rate"
      },
      "summary": "{\"data\":[{\"id\":\"86d69c85-8507-4fc1-af32-5d2b49ceb29f\",\"code\":\"unemployment_rate\",\"name\":\"Unemployment Rate\",\"description\":\"Seasonally adjusted unemployment rate\",\"source\":\"bls\",\"category\":\"labor\",\"sub"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "unemployment_rate",
        "region": "47187"
      },
      "summary": "{\"facts\":[{\"kind\":\"peer_rank\",\"params\":{\"rank\":95,\"total\":95,\"latestValue\":2.4,\"peers\":[{\"region\":\"47135\",\"value\":5.3},{\"region\":\"47067\",\"value\":4.7},{\"region\":\"47137\",\"value\":4.7},{\"region\":\"47069\",\""
    }
  ],
  "resolved": {
    "indicators": [
      "population",
      "median_income",
      "unemployment_rate"
    ],
    "regions": [
      "47187"
    ],
    "window": "all"
  },
  "grounded": true,
  "truncated": false,
  "status": "ok",
  "meta": {
    "model": "anthropic/claude-sonnet-5",
    "rounds": 3,
    "toolCalls": 4,
    "depth": "standard"
  }
}

curl -G "https://api.creativeforesight.io/v1/ask" \
  --data-urlencode "q=Is the media mood about the economy more negative than what the economic data actually shows?" \
  -H "X-API-Key: cf_live_..."

{
  "answer": "Yes, media tone is running slightly negative while the underlying data still shows a mostly resilient economy — a modest but real mismatch.\n\n**Media mood:** The economic news tone score (global) sits at -0.02 as of 2026-07-20, on a -1 to 1 scale — i.e., mildly negative. It's actually improved recently, up 68% from a July 2026 low of -0.05 on 2026-07-19, but remains 27% below its July 2026 high of -0.01.\n\n**Actual economic data (US):**\n- GDP: 31,866 (2026-01-01), an all-time series high, up 1.4% from the prior year and up 130% since 1947 (~6.4%/year annualized). However, a signal flags GDP growth as \"Slowing\" — falling faster than its recent trend since July 2026, so there is a genuine deceleration underway.\n- Unemployment rate: 4.2% (June 2026), down slightly from 4.3% the prior month, and 72% below its April 2020 pandemic high — still historically low, though 24% above the April 2023 cyclical low of 3.4%.\n\n**Bottom line:** The hard data (record GDP, low unemployment) doesn't support outright negativity, but there is a real slowdown signal in GDP growth and unemployment ticking up from its 2023 low — so the negative mood isn't baseless, it's just more pessimistic than the level of economic performance itself suggests.",
  "citations": [
    {
      "tool": "get_latest",
      "args": {
        "indicator": "mood",
        "region": "GLOBAL"
      },
      "summary": "{\"status\":\"ok\",\"data\":[{\"period_start\":\"2026-07-20\",\"period_end\":\"2026-07-20\",\"period_type\":\"daily\",\"value\":-0.01611,\"revision\":0,\"is_preliminary\":false,\"source_updated_at\":null}],\"meta\":{\"indicator\":"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "cf:osint.econ_news_tone",
        "region": "US"
      },
      "summary": "{\"facts\":[],\"signals\":[],\"meta\":{\"indicator\":\"cf:osint.econ_news_tone\",\"region\":\"US\",\"unit\":\"score (-1 to 1)\",\"window\":\"all\",\"observation_count\":0,\"source_attribution\":\"Creative Foresight original ind"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "gdp",
        "region": "US"
      },
      "summary": "{\"facts\":[{\"kind\":\"trend\",\"params\":{\"direction\":\"up\",\"startDate\":\"1947-01-01\",\"endDate\":\"2026-01-01\",\"startValue\":243.164,\"endValue\":31865.721,\"absoluteChange\":31622.557,\"percentChange\":130.0462116102"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "unemployment_rate",
        "region": "US"
      },
      "summary": "{\"facts\":[{\"kind\":\"trend\",\"params\":{\"direction\":\"down\",\"startDate\":\"2010-01-01\",\"endDate\":\"2026-06-01\",\"startValue\":9.8,\"endValue\":4.2,\"absoluteChange\":-5.6000000000000005,\"percentChange\":-0.571428571"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "cf:osint.econ_news_tone",
        "region": "GLOBAL"
      },
      "summary": "{\"facts\":[{\"kind\":\"watermark_low_distance\",\"params\":{\"latestDate\":\"2026-07-20\",\"latestValue\":-0.01611,\"watermarkDate\":\"2026-07-19\",\"watermarkValue\":-0.05012,\"distance\":0.03401,\"percentDistance\":-0.678"
    }
  ],
  "resolved": {
    "indicators": [
      "mood",
      "cf:osint.econ_news_tone",
      "gdp",
      "unemployment_rate"
    ],
    "regions": [
      "GLOBAL",
      "US"
    ],
    "window": "all"
  },
  "grounded": true,
  "truncated": false,
  "status": "ok",
  "meta": {
    "model": "anthropic/claude-sonnet-5",
    "rounds": 3,
    "toolCalls": 5,
    "depth": "standard"
  }
}

curl -G "https://api.creativeforesight.io/v1/ask" \
  --data-urlencode "q=Where in America is unemployment still painfully high even though the national rate is near record lows?" \
  -H "X-API-Key: cf_live_..."

{
  "answer": null,
  "status": "no_data",
  "message": "— I searched for regional/state/county-level unemployment_rate data (California, Nevada, New Mexico, D.C., Illinois, and several specific counties) to identify pockets of high unemployment, but no sub-national observations were returned (either empty results or \"provisioning\" status with no data yet held). Only the national unemployment_rate series was available, showing the U.S. rate at 4.2% as of June 2026 — I cannot verify which specific regions remain elevated without that data."
}

{
  "answer": "National unemployment sits near historic lows at **4.2%** (June 2026, U.S., BLS, seasonally adjusted). But that headline number masks sharp regional divergence.\n\n**Imperial County, California** stands out as one of the most persistently distressed labor markets in the country: its unemployment rate was **16.9%** in May 2026 — roughly four times the national rate. This gap has been a long-standing feature of the region, driven by its agriculture-dependent, seasonal economy along the border.\n\nOther traditionally high-unemployment areas (e.g., counties in Arizona, New Mexico, and West Virginia) are still being provisioned in this dataset and weren't available to pull specific current figures for this answer, so I can't cite exact numbers for them right now. Based on available data, Imperial County, CA is the clearest documented case of \"painfully high\" local unemployment persisting despite the strong national rate.",
  "citations": [
    {
      "tool": "search_indicators",
      "args": {
        "query": "unemployment rate"
      },
      "summary": "{\"data\":[{\"id\":\"86d69c85-8507-4fc1-af32-5d2b49ceb29f\",\"code\":\"unemployment_rate\",\"name\":\"Unemployment Rate\",\"description\":\"Seasonally adjusted unemployment rate\",\"source\":\"bls\",\"category\":\"labor\",\"sub"
    },
    {
      "tool": "get_latest",
      "args": {
        "indicator": "unemployment_rate",
        "region": "US"
      },
      "summary": "{\"status\":\"ok\",\"data\":[{\"period_start\":\"2026-06-01\",\"period_end\":null,\"period_type\":\"monthly\",\"value\":4.2,\"revision\":0,\"is_preliminary\":false,\"source_updated_at\":null}],\"meta\":{\"indicator\":\"unemployme"
    },
    {
      "tool": "get_active_signals",
      "args": {
        "indicators": [
          "unemployment_rate"
        ],
        "type": "extreme",
        "strength": "strong"
      },
      "summary": "{\"data\":[],\"meta\":{\"count\":0,\"limit\":12,\"filters\":{\"indicator\":[\"unemployment_rate\"],\"type\":\"extreme\",\"strength\":\"strong\",\"active\":true}}}"
    },
    {
      "tool": "get_active_signals",
      "args": {
        "indicators": [
          "unemployment_rate"
        ],
        "strength": "neutral"
      },
      "summary": "{\"data\":[],\"meta\":{\"count\":0,\"limit\":12,\"filters\":{\"indicator\":[\"unemployment_rate\"],\"strength\":\"neutral\",\"active\":true}}}"
    },
    {
      "tool": "get_active_signals",
      "args": {
        "indicators": [
          "unemployment_rate"
        ],
        "type": "extreme",
        "strength": "weak"
      },
      "summary": "{\"data\":[],\"meta\":{\"count\":0,\"limit\":12,\"filters\":{\"indicator\":[\"unemployment_rate\"],\"type\":\"extreme\",\"strength\":\"weak\",\"active\":true}}}"
    },
    {
      "tool": "get_latest",
      "args": {
        "indicator": "unemployment_rate",
        "region": "06025"
      },
      "summary": "{\"status\":\"ok\",\"data\":[{\"period_start\":\"2026-05-01\",\"period_end\":\"2026-05-01\",\"period_type\":\"monthly\",\"value\":16.9,\"revision\":0,\"is_preliminary\":false,\"source_updated_at\":null}],\"meta\":{\"indicator\":\"u"
    },
    {
      "tool": "get_latest",
      "args": {
        "indicator": "unemployment_rate",
        "region": "54047"
      },
      "summary": "{\"status\":\"provisioning\",\"message\":\"No data held yet for unemployment_rate in 54047; automatic provisioning has started — retry this question later and the series should be available.\"}"
    },
    {
      "tool": "get_latest",
      "args": {
        "indicator": "unemployment_rate",
        "region": "04027"
      },
      "summary": "{\"status\":\"provisioning\",\"message\":\"No data held yet for unemployment_rate in 04027; automatic provisioning has started — retry this question later and the series should be available.\"}"
    },
    {
      "tool": "get_latest",
      "args": {
        "indicator": "unemployment_rate",
        "region": "35039"
      },
      "summary": "{\"status\":\"provisioning\",\"message\":\"No data held yet for unemployment_rate in 35039; automatic provisioning has started — retry this question later and the series should be available.\"}"
    }
  ],
  "resolved": {
    "indicators": [
      "unemployment_rate"
    ],
    "regions": [
      "US",
      "06025",
      "54047",
      "04027",
      "35039"
    ],
    "window": "all"
  },
  "grounded": true,
  "truncated": false,
  "status": "ok",
  "meta": {
    "model": "anthropic/claude-sonnet-5",
    "rounds": 5,
    "toolCalls": 9,
    "depth": "standard"
  }
}

curl -G "https://api.creativeforesight.io/v1/ask" \
  --data-urlencode "q=What changed in the economy this month — which indicators broke from trend, and what is the economic news tone right now?" \
  -H "X-API-Key: cf_live_..."

{
  "answer": "## Economic News Tone: Right at Neutral, Recovering from a Recent Low\n\nThe global economic news tone score sits at **-0.02** as of July 20, 2026 — essentially neutral (scale is -1 to 1). This is up 68% from its July 2026 low of **-0.05** (July 19), but still 27% below its July 2026 high of **-0.01** (July 10). Tone rose over a 4-day run from July 12–15, and over the broader July 7–20 window, tone is up 25% (from -0.02 to -0.02, i.e., a small absolute move of 0.005). Bottom line: sentiment is mixed-to-flat, drifting slightly positive off a recent dip, not decisively bullish or bearish.\n\n## What Broke From Trend\n\n**Strong trend breaks (most notable):**\n- **Euro-area corporate lending (France):** outstanding bank loans to non-financial corporations reversed direction as of October 2024.\n- **Italy & Spain short-term corporate lending rates:** both reversed trend in October 2024, moving from rising to falling.\n- **Ireland & France inflation:** Irish HICP and French core HICP both broke trend in 2024 (May 2024), turning from rising to falling.\n- **Williamson County, TX — company management employment:** sharp reversal starting December 2023.\n\n**Neutral-strength breaks worth flagging:**\n- **US building permits** reversed trend in October 2024.\n- **US crude oil production** changed direction in December 2024.\n- **Germany unemployment rate** shifted trend in October 2024.\n- **US 3-month T-bill rate** and **US CPI inflation** both show long-standing trend breaks (1936 and 2008 respectively — likely structural, not new news).\n- **Turkish lira/EUR exchange rate** broke trend as recently as **June 2026** — the most current of the group.\n\n## What's Accelerating Right Now (last few weeks)\n\n- **Euro-area government bond yields (1Y, 2Y, 5Y, 10Y, and AAA-rated equivalents)** are all falling faster than their recent trend since **July 9, 2026** — a synchronized, strong move down across the curve.\n- **US 2-year Treasury yield** has been falling faster than trend since **June 23, 2026**.\n- **US crude oil production** is rising faster than trend (strong signal, since October 2024).\n- **US GDP** is sliding — falling faster than trend since **October 2025** (flagged negative tone).\n- **Germany core inflation** is easing faster than trend since **February 2025** (flagged positive).\n- **UK central bank policy rate** has been rising faster than trend since early 2026.\n- **Williamson County, TX employment rate** is picking up, accelerating since May 2026 (positive).\n\nNo indicators currently show \"extreme\" readings (outside historical bounds).\n\n**Net read:** The most current, live-market signal is the euro-area yield curve dropping sharply since July 9 alongside a weakening Turkish lira trend break in June — both pointing to shifting rate expectations in Europe. US GDP deceleration is the key negative macro signal, while news tone itself remains close to flat/neutral.",
  "citations": [
    {
      "tool": "get_latest",
      "args": {
        "indicator": "tone",
        "region": "GLOBAL"
      },
      "summary": "{\"status\":\"ok\",\"data\":[{\"period_start\":\"2026-07-20\",\"period_end\":\"2026-07-20\",\"period_type\":\"daily\",\"value\":-0.01611,\"revision\":0,\"is_preliminary\":false,\"source_updated_at\":null}],\"meta\":{\"indicator\":"
    },
    {
      "tool": "get_active_signals",
      "args": {
        "type": "trend_break",
        "limit": 20
      },
      "summary": "{\"data\":[{\"id\":\"b65f4abd-b544-43bd-9271-385eb90c7e40\",\"indicator\":{\"code\":\"une_rt_m:M.SA.TOTAL.PC_ACT.T\",\"name\":\"Unemployment by sex and age - monthly data — Seasonally adjusted data, not calendar adj"
    },
    {
      "tool": "get_insights",
      "args": {
        "indicator": "cf:osint.econ_news_tone",
        "region": "GLOBAL",
        "window": "3m"
      },
      "summary": "{\"facts\":[{\"kind\":\"watermark_low_distance\",\"params\":{\"latestDate\":\"2026-07-20\",\"latestValue\":-0.01611,\"watermarkDate\":\"2026-07-19\",\"watermarkValue\":-0.05012,\"distance\":0.03401,\"percentDistance\":-0.678"
    },
    {
      "tool": "get_active_signals",
      "args": {
        "type": "acceleration",
        "limit": 15
      },
      "summary": "{\"data\":[{\"id\":\"da26aae0-b64e-492a-a97a-794da4f0c4b0\",\"indicator\":{\"code\":\"PAPRPUS\",\"name\":\"Crude oil production, total (thousand barrels/day, monthly)\",\"category\":\"energy\",\"unit\":\"thousand barrels pe"
    },
    {
      "tool": "get_active_signals",
      "args": {
        "type": "extreme",
        "limit": 15
      },
      "summary": "{\"data\":[],\"meta\":{\"count\":0,\"limit\":15,\"filters\":{\"type\":\"extreme\",\"strength\":\"neutral\",\"active\":true}}}"
    }
  ],
  "resolved": {
    "indicators": [
      "tone",
      "cf:osint.econ_news_tone"
    ],
    "regions": [
      "GLOBAL"
    ],
    "window": "all"
  },
  "grounded": true,
  "truncated": false,
  "status": "ok",
  "meta": {
    "model": "anthropic/claude-sonnet-5",
    "rounds": 3,
    "toolCalls": 5,
    "depth": "standard"
  }
}