# Fodda Context & Research API

**Canonical:** https://apis.io/apis/fodda-ai/fodda-context-research-api/  
**Provider:** Fodda (PSFK) — https://apis.io/providers/fodda-ai/  
**Base URL:** https://api.fodda.ai  
**Documentation:** https://www.fodda.ai/api

Fodda Context & Research API is one of 3 APIs that [Fodda (PSFK)](https://apis.io/providers/fodda-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Knowledge Graph, Trend Research, Earnings Intelligence, Brand Intelligence, and Institutional Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

REST interface at api.fodda.ai for expert-curated knowledge graphs (search, node retrieval, neighbor traversal, evidence, statistics, adjacent-trend discovery), autonomous deep research (async job launch + status poll, SSE streaming search, research chat, scheduled briefings delivered by email or Slack webhook), brand intelligence, synthetic and human expert analyst consults, cross-company earnings intelligence, and 100+ supplemental institutional data snapshots. OpenAPI 3.1.0 (info.version 1.7.0, 157 operations) served at https://api.fodda.ai/openapi.json; every operation carries x-fodda-price-usd and x-fodda-billing-type. Auth: X-API-Key header or a Stripe Shared Payment Token bearer via the HTTP 402 Machine Payments Protocol flow; a public tier (health, pricing map, offerings, graph catalog, JSON-LD graph preview) needs no credential.

## Operations (60 of 157)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/health` | V1 API health check |
| GET | `/v1/spt/validate` | Validate SPT |
| GET | `/v1/offerings` | List offerings catalog |
| GET | `/v1/research/pricing` | Get Pricing map |
| GET | `/v1/research/offerings` | Get research offerings catalog |
| POST | `/v1/research/deep-dive` | Launch Autonomous Research Deep Dive |
| GET | `/v1/research/deep-dive/status/{job_id}` | Check Deep Research Status |
| POST | `/v1/research/chat` | Research chat turn |
| GET | `/v1/research/stream` | Streaming research search |
| POST | `/v1/research/schedules` | Create scheduled Briefing |
| GET | `/v1/research/schedules` | List scheduled briefings |
| DELETE | `/v1/research/schedules/{schedule_id}` | Cancel scheduled briefing |
| PATCH | `/v1/research/schedules/{schedule_id}` | Modify scheduled briefing |
| GET | `/v1/research/schedules/{schedule_id}/runs` | Get scheduled briefing runs |
| GET | `/v1/context` | URL context extraction |
| GET | `/v1/graph-slice` | Graph slice JSON-LD |
| POST | `/v1/log/question` | Log search question |
| POST | `/v1/accounts/trial-upgrade` | Upgrade account status |
| POST | `/v1/user/context` | Set user research context profile |
| GET | `/v1/user/usage/export` | Bulk export query and usage history |
| GET | `/v1/user/invoices/export` | Bulk export consolidated invoices and billing summary |
| GET | `/v1/user/briefings/export` | Bulk export research briefings and deliverables |
| GET | `/v1/graphs/catalog` | Graph registry catalog |
| GET | `/v1/graphs/mine` | Get active graphs list |
| GET | `/v1/graphs` | List available context graphs |
| GET | `/v1/graphs/{graph_id}/nodes/{node_id}` | Get node properties |
| POST | `/v1/graphs/{graph_id}/neighbors` | Traverse neighbors |
| GET | `/v1/graphs/{graph_id}/adjacent` | Discover adjacent trends |
| POST | `/v1/graphs/{graph_id}/search` | Search knowledge graph |
| POST | `/v1/graphs/{graph_id}/evidence` | Get evidence |
| GET | `/v1/graphs/{graph_id}/labels/{label}/values` | List label category values |
| GET | `/v1/sources/chunks/{chunk_id}` | Get source chunk content |
| GET | `/v1/graphs/{graph_id}/statistics` | Search statistics |
| POST | `/v1/brand-intelligence/{brandName}` | Get Brand Intelligence profile |
| POST | `/v1/search/domain` | Domain Intelligence parallel search |
| POST | `/v1/search/expert` | Expert Intelligence parallel search |
| POST | `/v1/search/report` | Report Intelligence parallel search |
| POST | `/v1/search/filtered` | Filtered semantic search |
| GET | `/v1/search/filters` | List search filters keys |
| POST | `/v1/user/preferences/toggle` | Toggle user preference setting |
| POST | `/v1/admin/invalidate-registry-cache` | Force registry invalidation |
| GET | `/v1/analysts` | List synthetic expert analysts |
| GET | `/v1/analysts/brands` | List covered analyst brands |
| POST | `/v1/analysts/consult` | Consult analyst turn |
| POST | `/v1/supplemental/context` | Unified Supplemental Context |
| GET | `/v1/supplemental/sources` | List supplemental sources |
| GET | `/v1/supplemental/earnings/snapshot` | Earnings call snapshot intelligence |
| GET | `/v1/supplemental/earnings/analyst-concerns` | Get earnings top analyst concerns |
| GET | `/v1/supplemental/earnings/question-themes` | Get earnings Q&A question themes |
| GET | `/v1/supplemental/earnings/management-themes` | Get management presentation themes |
| GET | `/v1/supplemental/earnings/divergence` | Get earnings concerns divergence |
| POST | `/copilot/search_insights` | Strategic Insight Retrieval (Copilot) |
| POST | `/copilot/get_evidence` | Evidence-Backed Grounding (Copilot) |
| POST | `/copilot/get_statistics` | Quantitative Statistics (Copilot) |
| GET | `/v1/supplemental/suggest` | Supplemental: suggest |
| GET | `/v1/supplemental/census/retail-snapshot` | Supplemental: retail-snapshot |
| GET | `/v1/supplemental/census/demographics-snapshot` | Supplemental: demographics-snapshot |
| GET | `/v1/supplemental/fred/economic-snapshot` | Supplemental: economic-snapshot |
| GET | `/v1/supplemental/wikipedia/pageviews` | Supplemental: pageviews |
| GET | `/v1/supplemental/worldbank/global-snapshot` | Supplemental: global-snapshot |

…and 97 more operations. They are listed in full on the page.

## Machine-readable artifacts (17)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/openapi/fodda-ai-openapi.yml
- **OpenAPI** — https://api.fodda.ai/openapi.json
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/openapi/fodda-ai-context-delivery-openapi.yml
- **OpenAPI** — https://www.fodda.ai/openapi.json
- **Documentation** — https://www.fodda.ai/api
- **APIReference** — https://www.fodda.ai/api
- **GettingStarted** — https://www.fodda.ai/connect-your-agent
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/authentication/fodda-ai-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/conventions/fodda-ai-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/errors/fodda-ai-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/data-model/fodda-ai-data-model.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/overlays/fodda-ai-tags-overlay.yaml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/rate-limits/fodda-ai-rate-limits.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/examples/fodda-ai-examples.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/asyncapi/fodda-ai-event-surface.yml
- **LLMsTxt** — https://www.fodda.ai/llms.txt
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/fodda-ai/refs/heads/main/apis.yml

## Other Fodda (PSFK) APIs (2)

- [Fodda MCP Server](https://apis.io/apis/fodda-ai/fodda-mcp-server/)
- [Fodda Research Agent (A2A)](https://apis.io/apis/fodda-ai/fodda-research-agent-a2a/)

## Tags

Knowledge Graph, Trend Research, Earnings Intelligence, Brand Intelligence, Institutional Data, Machine Payments, agent-native

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/fodda-ai/fodda-context-research-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/fodda-ai/.