Dermal Vectors Forecast API

Quick start

No codes needed. Ask for the metro nearest a location, like a weather API. Here is this week's Dry Skin Index for Boston (latitude 42.36, longitude −71.06):

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?near=42.36,-71.06"

Keep your key in an environment variable, for example export DV_API_KEY="…", never in shared code. Each forecast call uses one read from your monthly allowance.

Products

To check in code which products your brand can use right now, call GET /api/v1/products (one lookup, not a forecast read).

Daily Metro DSI Forecast

Endpoints

Choosing places

Use one of these per request. The response always lists the exact metro codes it used in markets.requested.

Examples

Every Connecticut metro, as JSON:

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?state=CT"

Four Northeast metros by code:

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?markets=14460,35620,37980,25540"

Other parameters

What you get back

The response has two parts: information about the issue (which forecast this is, when it was made, where it came from) and rows: one row per metro per day. The arrows mark each part. This example is for near=42.36,-71.06 (Boston), shortened:

{
  "schemaVersion": "dv-product-response-v1",
  "product": {                                   ← which forecast issue this is
    "productId": "daily_metro_dsi_forecast",
    "issueId": "dsi-20261006T140100Z-3824fb7ca0b601ee",
    "issuedAt": "2026-10-06T14:01:00.000Z",
    "validFrom": "2026-10-06T00:00:00Z",
    "validUntil": "2026-10-07T14:01:00.000Z",
    "geography": "us_census_cbsa_metro",
    "coverage": { "expected": 371, "completed": 371 },
    "modelVersion": "residential-dsi-hierarchy-v1",
    "recipeVersion": null,
    "formats": ["json", "csv"]
  },
  "freshness": "current",
  "access": "full",
  "release": "customer_released",
  "geography": { "type": "us_census_cbsa_metro", "code": "5-digit CBSA",
                 "note": "U.S. Census metro areas, not DMAs." },
  "provenance": {                                ← where the numbers came from
    "runId": "signal-20261006T1401Z",
    "noaaCycle": "2026-10-06T00:00:00+00:00",
    "noaaModel": "gfs",
    "targetDates": ["2026-10-06", "2026-10-07", "…", "2026-10-12"],
    "catalogMetros": 384, "modeledMetros": 371,
    "manifestSha256": "3824fb7c…", "artifactSha256": "be261f7c…",
    "excludedCbsas": ["14100", "…"], "validationStatus": "shadow_verified"
  },
  "markets": { "requested": ["14460"], "returned": 1 },   ← the metros used
  "units": { "dsi": "Dry Skin Index (dimensionless, 0-10)", "leadDay": "1 = issue date",
             "forecastConfidence": "reduced from lead day 6", "coveredPopulation": "people" },
  "rows": [                                      ← the forecast: one row per metro per day
    { "cbsa": "14460", "metroName": "Boston-Cambridge-Newton, MA-NH", "date": "2026-10-06",
      "leadDay": 1, "forecastConfidence": "standard",
      "dsi": 5.915614, "dsiLow": 4.881779, "dsiHigh": 7.168575, "coveredPopulation": 4917438.333 },
    { "cbsa": "14460", "metroName": "Boston-Cambridge-Newton, MA-NH", "date": "2026-10-07",
      "leadDay": 2, "forecastConfidence": "standard",
      "dsi": 5.408925, "dsiLow": 4.482004, "dsiHigh": 6.527612, "coveredPopulation": 4917438.333 }
    … 5 more rows, one per day to 2026-10-12
  ]
}

Headers: X-DV-Issue-Id (same as product.issueId) and Cache-Control: private, no-store.

Full data dictionary, CSV headings and downloadable definitions

Data dictionary: rows

Data dictionary: issue information

CSV

With format=csv you get a file with one line per metro per day. Columns match the row fields in snake_case:

cbsa,metro_name,date,lead_day,forecast_confidence,dsi,dsi_low,dsi_high,covered_population
14460,"Boston-Cambridge-Newton, MA-NH",2026-10-06,1,standard,5.915614,4.881779,7.168575,4917438.333
14460,"Boston-Cambridge-Newton, MA-NH",2026-10-07,2,standard,5.408925,4.482004,6.527612,4917438.333
…

Summary measures (7-day)

Add view=summary to get one line per metro with the 7-day measures below, computed on our side from the same issue, instead of 7 daily rows you would have to add up yourself. It is smaller and faster to read for code and AI agents. Combine with sort and top to rank metros, for example the 10 driest in the country, in one read.

Examples

This week's summary for Boston:

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?near=42.36,-71.06&view=summary"

The 10 driest metros in the country this week:

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?view=summary&sort=mean7&top=10"

Texas metros with the highest 65+ exposure, as a spreadsheet:

curl -H "Authorization: Bearer $DV_API_KEY" -o texas-65plus-exposure.csv \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?state=TX&view=summary&sort=exposure65&top=5&format=csv"

Example response 200 OK real values, Sept 29 issue; shortened

{
  "schemaVersion": "dv-product-response-v1",
  "view": "summary",
  "summaryVersion": "dsi-summary-v1",
  "product": { "issueId": "dsi-20260929T191051Z-9d3005985574912e", "issuedAt": "2026-09-29T19:10:51Z", … },
  "freshness": "current",
  "markets": { "requested": ["14460"], "returned": 1 },
  "provenance": { "runId": "signal-delivery-20260929-1200", "targetDates": ["2026-09-29", "…", "2026-10-05"] },
  "units": { "mean7": "mean daily DSI, 0-10", "excessAbove4": "sum of max(DSI-4,0), index-days", … },
  "summaries": [
    { "cbsa": "14460", "metroName": "Boston-Cambridge-Newton, MA-NH", "days": 7,
      "firstDate": "2026-09-29", "lastDate": "2026-10-05",
      "mean7": 4.205,
      "peak": { "dsi": 4.595, "date": "2026-10-05" },
      "excessAbove4": 1.705,
      "population65plus": 818502,
      "exposure65plus": 1395836,
      "trend": { "slopePerDay": 0.107, "label": "steady" } }
  ]
}

With sort, each summary also has a rank. The summary CSV has one row per metro: rank,cbsa,metro_name,first_date,last_date,days,mean7,peak_dsi,peak_date,excess_above_4,population_65plus,exposure_65plus,trend_slope_per_day,trend. Full provenance (hashes, excluded metros) is in view=daily or view=both.

These are weather-derived summaries of the Dry Skin Index, not medical, sales or audience measures.

Find a market

Look up any supported metro and copy its code, or download the full list. No key is needed for either.

Download all 371 metros (CSV)

GET /api/v1/markets

The same list for your code. Public, cacheable, and not counted against your allowance.

curl \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/markets?near=42.36,-71.06&limit=2"

{
  "schemaVersion": "dv-markets-v1",
  "productId": "daily_metro_dsi_forecast",
  "geography": "us_census_cbsa_metro",
  "totalSupported": 371,
  "count": 2,
  "markets": [
    { "cbsa": "14460", "name": "Boston-Cambridge-Newton, MA-NH", "states": ["MA", "NH"],
      "latitude": 42.3739, "longitude": -71.141, "population": 4917661, "distanceKm": 7 },
    { "cbsa": "49340", "name": "Worcester, MA-CT", "states": ["MA", "CT"],
      "latitude": 42.2784, "longitude": -71.7038, "population": 861664, "distanceKm": 54 }
  ]
}

Recipes

This week for one city

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?near=32.78,-96.80"

Which of several metros is driest this week

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?markets=14460,35620,37980,25540&view=summary&sort=mean7"

The driest metros in the whole country (one read)

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?view=summary&sort=mean7&top=10"

Where dryness is rising fastest

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?view=summary&sort=trend&top=10"

Every metro in a state, as a spreadsheet

curl -H "Authorization: Bearer $DV_API_KEY" -o texas-dsi.csv \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?state=TX&format=csv"

Everything, as a spreadsheet

curl -H "Authorization: Bearer $DV_API_KEY" -o all-metros-dsi.csv \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/latest?format=csv"

The same numbers again later

Each day's forecast is published as an issue, like a newspaper edition, with a permanent ID in product.issueId. /latest always returns the newest one. To get a specific past forecast again, unchanged (for example to re-check last week's report), put its ID in the address:

curl -H "Authorization: Bearer $DV_API_KEY" \
  "https://YOUR-DERMAL-VECTORS-SITE/api/v1/products/daily_metro_dsi_forecast/issues/dsi-20261006T140100Z-3824fb7ca0b601ee?markets=14460"

Errors

Errors use standard HTTP status codes and a JSON body with a stable code and a plain-language message that says when retrying won't help.

HTTP/1.1 422 Unprocessable Entity
{
  "error": {
    "code": "unsupported_market",
    "message": "Some requested markets are not supported CBSA metros in this issue.",
    "unsupportedMarkets": ["99999"]
  }
}

Limits

• Monthly allowance per brand, shared by every API key and AI app: forecast reads, lookups and data returned. Current usage is on the Integrations page. It resets on the 1st of each month (UTC). There are no overage charges; requests are refused until the reset.
• Per-minute limit per brand. Wait for Retry-After.
• Up to 100 metros per request (10 per AI-agent tool call). Leave places out to get all metros in one read.
• The market list (/api/v1/markets) is free and needs no key.

Tip: one call without places returns every metro for one read. Fetch once a day after about 12:35 UTC and reuse your copy.

Use of forecasts, allowances and limits: Terms of Service and API and Data-use Terms.

For AI agents (MCP)

AI apps connected to https://YOUR-DERMAL-VECTORS-SITE/mcp see read-only tools with the same data and allowance, and receive a short briefing on what DSI means, citing the issue ID and saving allowance. Setup is in the guide.

Changes

• 2026-10-06: 7-day summary measures (view=summary, sort, top): mean7, peak, excessAbove4, exposure65plus, trend; MCP returns summaries by default and adds rank_metros.
• 2026-10-06: choose places by near or state; new public /api/v1/markets; separate allowance_exhausted and rate_limited codes; MCP tools accept places and send a briefing.