{"uid":"cap_vgq4ede05H8zRgjs9DbNs","slug":"aisa-mpp-data-apis-aisa-kpi-guidance-7f176026","name":"AIsa KPI Guidance","description":"Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/financial/kpi/guidance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":4,"maximum":50,"description":"Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it."},"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","format":"date","description":"Only return guidance on or after this date (YYYY-MM-DD)."},"report_period_lte":{"type":"string","format":"date","description":"Only return guidance on or before this date (YYYY-MM-DD)."}}},"responseSchema":{"type":"object","properties":{"kpi_guidance":{"type":"array","items":{"type":"object","required":["ticker","metric_name","period","period_type"],"properties":{"low":{"type":["number","null"],"example":6,"description":"Low end of guidance range."},"high":{"type":["number","null"],"example":8,"description":"High end of guidance range."},"unit":{"type":"string","example":"%"},"value":{"type":["number","null"]},"period":{"type":"string","example":"Q2 2026"},"ticker":{"type":"string","example":"DAL"},"segment":{"type":["string","null"]},"raw_text":{"type":["string","null"],"description":"Original guidance text from the filing."},"source_url":{"type":["string","null"],"format":"uri"},"metric_name":{"type":"string","example":"Operating Margin"},"period_type":{"enum":["quarterly","annual"],"type":"string"},"prior_value":{"type":["number","null"],"description":"Prior guidance value for revisions."},"source_text":{"type":["string","null"]},"point_estimate":{"type":["number","null"],"description":"Single-point guidance when no range is given."},"change_direction":{"type":["string","null"],"example":"initiated","description":"Direction: raised, lowered, maintained, initiated, withdrawn."}}}},"next_page_url":{"type":"string","description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records."}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CU33sdZInZF2Oltk9E-Yw","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Retrieves structured forward guidance from earnings releases for a given stock ticker, including ranges, point estimates, and directional signals.","exampleAgentPrompt":"Pull the last 4 quarters of operating margin guidance for Delta Air Lines (DAL) from their earnings releases — I want to see the low/high ranges and whether guidance was raised, lowered, or maintained each period.","exampleUseCases":[{"title":"Earnings season guidance tracker","prompt":"Show me all the guidance metrics Apple provided in their most recent quarterly earnings release — I want the ranges, point estimates, and whether anything was raised or lowered compared to prior guidance."},{"title":"Annual EPS guidance comparison","prompt":"Get the last 2 years of annual EPS guidance for Microsoft so I can see how their full-year estimates have trended and whether they've consistently raised or maintained their outlook."},{"title":"Sector margin guidance screen","prompt":"Pull operating margin guidance for NVIDIA for Q1 and Q2 2026 so I can compare the low and high ends of the range against what analysts are expecting."}],"resultDescription":"Returns an array of guidance records, each containing the ticker, metric name, period, period type, low/high range, point estimate, unit, segment, change direction (raised/lowered/maintained/initiated/withdrawn), prior value, raw guidance text from the filing, and source URL. A next_page_url is included when more records remain.","failureModes":["Missing or invalid ticker symbol returns an error or empty result set","Unknown metric_name filter yields an empty array","Date range filters that precede available data return no records","Invalid cursor causes pagination failure","Exceeding limit maximum of 50 returns a validation error","Ticker with no guidance in earnings filings returns empty kpi_guidance array"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable forward guidance extracted directly from earnings releases — including numeric ranges, point estimates, and directional change signals — rather than unstructured analyst estimates or consensus data. Best when you need to track how a company's own stated outlook evolves across periods, or when filtering by a specific KPI metric like operating margin or EPS.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:53.578Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-aisa-kpi-guidance-7f176026"}