{"uid":"cap_IYDLwRqF7EL1O5N8LUa9J","slug":"foresight-api-panel-observations-6f3b5241","name":"Foresight API – Panel Observations","description":"Foresight API request","url":"https://api.creativeforesight.io/v1/panel","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["indicators","region"],"properties":{"region":{"type":"string"},"indicators":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":{"type":"json","example":{"meta":{"region":"47187"},"dates":["2025-01-01"],"series":{"PAYEMS":[159000],"UNRATE":[4.1]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uhTTvPYHVisXeOXYPnsLk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves panel-level economic observations (e.g. employment, unemployment rate) for a given region and set of indicators over time.","exampleAgentPrompt":"Pull the latest PAYEMS and UNRATE panel observations for region 47187 from Foresight API so I can see the employment and unemployment trend over time.","exampleUseCases":[{"title":"Regional labor market dashboard","prompt":"Get me the PAYEMS and UNRATE economic indicators for region 47187 — I want to see the full time series so I can build a labor market dashboard for that metro area."},{"title":"Unemployment trend analysis for investors","prompt":"Fetch the unemployment rate (UNRATE) panel data for region 06037 from Foresight so I can analyze how it's trended over the past year for an investment report."},{"title":"Economic signal monitoring for policy team","prompt":"Retrieve the latest PAYEMS employment figures for region 36061 — my policy team needs to track monthly changes in nonfarm payrolls for that region."}],"resultDescription":"Returns a JSON object with a meta field containing the region, an array of date strings representing observation periods, and a series map where each key is an indicator code (e.g. PAYEMS, UNRATE) and each value is an array of numeric readings aligned to the dates array.","failureModes":["Missing required query parameters (indicators or region) returns a 400 or validation error","Invalid or unrecognized region code returns empty or error response","Missing or invalid bearer API key returns 401 Unauthorized","Insufficient x402 payment or payment failure returns 402 Payment Required","Unsupported indicator codes return empty series or error","Rate limiting may return 429 Too Many Requests"],"whenToPreferThis":"Choose this endpoint when you need structured, time-series economic panel data (labor, employment, unemployment) for a specific geographic region identified by a FIPS or ZIP code. It is ideal for agents building economic dashboards, monitoring regional labor markets, or feeding macroeconomic signals into forecasting models. Prefer this over generic data scrapers when you need clean, pre-structured indicator series aligned by date.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:33:00.447Z","isFirstParty":false}