{"uid":"cap_P4y67mUgobbBXJESmqLHw","slug":"financial-datasets-ai-kpi-forward-guidance-8a741ad5","name":"Financial Datasets AI — KPI Forward Guidance","description":"Forward guidance from a US-listed company's earnings releases, structured: metric, period, the low and high of the range or the point estimate, the change direction versus prior guidance and a link to the source text. Period quarterly or annual; filter by metric_name or report_period. Use when an agent needs what management guided to, not what was reported. Non-Professional use; Professional use needs a plan at financialdatasets.ai.","url":"https://api.financialdatasets.ai/kpi/guidance?utm_source=zero.xyz","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"},"queryParams":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":4,"description":"Number of periods to return."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response's next_page_url."},"period":{"enum":["quarterly","annual"],"type":"string","default":"quarterly","description":"Filter by period type: quarterly or annual."},"ticker":{"type":"string","description":"The ticker symbol."},"metric_name":{"type":"string","description":"Filter to a specific metric."},"report_period_gte":{"type":"string","description":"Only return guidance on or after this date (YYYY-MM-DD)."},"report_period_lte":{"type":"string","description":"Only return guidance on or before this date (YYYY-MM-DD)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.16","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.16/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cWbz5-vmC8DhT3kG3uiwn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.16","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured forward guidance from US-listed companies' earnings releases, including metric, period, low/high range or point estimate, and change direction versus prior guidance.","exampleAgentPrompt":"Pull Apple's quarterly forward guidance from their earnings releases — I want to see the last 4 periods, specifically any revenue guidance, including the low and high of the range and whether it changed direction from prior guidance.","exampleUseCases":[{"title":"Earnings season guidance tracker","prompt":"Show me Nvidia's quarterly guidance for the last 4 periods — I want to see every metric management guided to, the range they gave, and whether they raised or lowered their outlook compared to the prior quarter."},{"title":"Annual EPS guidance comparison","prompt":"What annual EPS guidance has Microsoft given? Pull the most recent annual periods and show me the point estimates or ranges along with the source text links."},{"title":"Guidance revision monitoring for portfolio","prompt":"Get me Tesla's quarterly forward guidance for any report periods from 2024-01-01 onward — I want to see all metrics and which direction management changed their guidance versus what they said before."}],"resultDescription":"A paginated list of forward guidance records for the requested ticker, each containing the metric name, guidance period, low and high range values or a point estimate, direction of change versus prior guidance, and a link to the original source text in the earnings release. Supports filtering by period type (quarterly or annual), specific metric name, and date range.","failureModes":["Invalid or unsupported ticker symbol returns an empty dataset or 404","No guidance data available for the requested period or metric returns an empty list","Malformed date strings in report_period_gte or report_period_lte cause a 400 validation error","Exceeding rate limits without a paid plan returns a 402 or 429 error","Professional-use access attempted without a qualifying plan results in an authorization error","Invalid pagination cursor returns an error or unexpected results"],"whenToPreferThis":"Use this endpoint when you specifically need what management guided to (forward-looking projections) rather than what was actually reported (historical actuals). It is the right choice when an agent needs to compare analyst consensus to management outlook, track whether guidance was raised or lowered, or assess management credibility by comparing guidance to eventual results. Prefer this over earnings actuals endpoints when the user's question is about expectations, projections, or management outlook for a future period.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T18:26:13.733Z","isFirstParty":false,"canonicalSlug":"financial-datasets-ai-kpi-forward-guidance-8a741ad5"}