Fodda

Expert-curated knowledge graphs for grounded RAG — PSFK domain trends, expert specialist graphs, industry reports, and institutional market data (US Census, FRED, BLS, BEA, OpenAlex, Google Trends). Every trend ships pre-bundled with evidence tagged by type (case study / statistic / analysis / interview) so agents can cite sources instead of paraphrasing them. Use when defensibility matters: board-ready briefs, competitive intel, strategy memos — not open-web Q&A. 7 endpoints available through Lava’s AI Gateway. See the Fodda API docs for full documentation.

Supports both managed (Lava’s API keys) and unmanaged (bring your own credentials) mode.

Endpoints

List every available knowledge graph with graph_id, domain, curator, and example_queries. Free (0 tokens). Call first to discover valid graph_ids for other endpoints.

GET https://api.fodda.ai/v1/graphs — Free

SDK
cURL

const data = await lava.gateway('https://api.fodda.ai/v1/graphs', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fgraphs" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Search PSFK curated domain graphs (retail, beauty, sports, fashion) for trends with bundled evidence. No graph_id needed — searches all relevant domain graphs automatically. Primary workhorse for topic research.

POST https://api.fodda.ai/v1/search/domain — $0.0014 / request

SDK
cURL

const data = await lava.gateway('https://api.fodda.ai/v1/search/domain', {
  body: {
"query": "sustainable packaging trends",
"limit": 10,
"include_evidence": true,
"max_evidence_per_trend": 5,
"min_score": 0.6
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fsearch%2Fdomain" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable packaging trends","limit":10,"include_evidence":true,"max_evidence_per_trend":5,"min_score":0.6}'

Search expert specialist graphs authored by individual strategists (Ben Dietz, Juan Isaza, etc.). Same request shape as /v1/search/domain — fires against expert graphs automatically.

POST https://api.fodda.ai/v1/search/expert — $0.0014 / request

SDK
cURL

const data = await lava.gateway('https://api.fodda.ai/v1/search/expert', {
  body: {
"query": "sustainable packaging trends",
"limit": 10,
"include_evidence": true,
"min_score": 0.6
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fsearch%2Fexpert" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable packaging trends","limit":10,"include_evidence":true,"min_score":0.6}'

Search industry report graphs (Deloitte, WEF, Mintel, PwC, 60+ others). Same request shape as /v1/search/domain. Use alongside /search/domain and /search/expert for full topic-research coverage.

POST https://api.fodda.ai/v1/search/report — $0.0014 / request

SDK
cURL

const data = await lava.gateway('https://api.fodda.ai/v1/search/report', {
  body: {
"query": "sustainable packaging trends",
"limit": 10,
"include_evidence": true,
"min_score": 0.6
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fsearch%2Freport" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable packaging trends","limit":10,"include_evidence":true,"min_score":0.6}'

Enrich a topic with institutional market data from up to 8 sources (Google Trends, US Census, BEA, FRED, BLS, OpenAlex, etc.). Returns demand_signals, economic_context, market_data, research_signals categorized with _source fields for citation. Bills at 0.5 tokens per call (half-rate).

POST https://api.fodda.ai/v1/supplemental/context — $0.0014 / request

SDK
cURL

const data = await lava.gateway('https://api.fodda.ai/v1/supplemental/context', {
  body: {
"query": "sustainable packaging trends",
"domain": "retail",
"brands": [
  "Loop",
  "TerraCycle"
]
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fsupplemental%2Fcontext" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable packaging trends","domain":"retail","brands":["Loop","TerraCycle"]}'

Single-hop brand footprint across all graphs — trends the brand is connected to, co-occurring brands (competitive context), cross-graph presence. Brand name goes in the path; tuning via ?maxEvidence and ?limit query params.

POST https://api.fodda.ai/v1/brand-intelligence/Patagonia?maxEvidence=10&limit=50 — $0.0014 / request

SDK
cURL

const data = await lava.gateway('https://api.fodda.ai/v1/brand-intelligence/Patagonia?maxEvidence=10&limit=50', { method: 'POST' });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fbrand-intelligence%2FPatagonia%3FmaxEvidence%3D10%26limit%3D50" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Graph traversal from seed trend nodes. Returns adjacent trends, brands, and technologies with their relationship type. Use to answer “what else connects to this?” after a search. Depth 1-3 (default 1), up to 50 results.

POST https://api.fodda.ai/v1/graphs/retail/neighbors — $0.0014 / request

SDK
cURL

const data = await lava.gateway('https://api.fodda.ai/v1/graphs/retail/neighbors', { body: {"seed_node_ids":["6445"],"depth":2,"limit":30} });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fgraphs%2Fretail%2Fneighbors" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed_node_ids":["6445"],"depth":2,"limit":30}'

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

Endpoints

List every available knowledge graph with graph_id, domain, curator, and example_queries. Free (0 tokens). Call first to discover valid graph_ids for other endpoints.

Search PSFK curated domain graphs (retail, beauty, sports, fashion) for trends with bundled evidence. No graph_id needed — searches all relevant domain graphs automatically. Primary workhorse for topic research.

Search expert specialist graphs authored by individual strategists (Ben Dietz, Juan Isaza, etc.). Same request shape as /v1/search/domain — fires against expert graphs automatically.

Search industry report graphs (Deloitte, WEF, Mintel, PwC, 60+ others). Same request shape as /v1/search/domain. Use alongside /search/domain and /search/expert for full topic-research coverage.

Enrich a topic with institutional market data from up to 8 sources (Google Trends, US Census, BEA, FRED, BLS, OpenAlex, etc.). Returns demand_signals, economic_context, market_data, research_signals categorized with _source fields for citation. Bills at 0.5 tokens per call (half-rate).

Single-hop brand footprint across all graphs — trends the brand is connected to, co-occurring brands (competitive context), cross-graph presence. Brand name goes in the path; tuning via ?maxEvidence and ?limit query params.

Graph traversal from seed trend nodes. Returns adjacent trends, brands, and technologies with their relationship type. Use to answer “what else connects to this?” after a search. Depth 1-3 (default 1), up to 50 results.

Next Steps

All Providers

Forward Proxy

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

Documentation Index

​Endpoints

​List every available knowledge graph with graph_id, domain, curator, and example_queries. Free (0 tokens). Call first to discover valid graph_ids for other endpoints.

​Search PSFK curated domain graphs (retail, beauty, sports, fashion) for trends with bundled evidence. No graph_id needed — searches all relevant domain graphs automatically. Primary workhorse for topic research.

​Search expert specialist graphs authored by individual strategists (Ben Dietz, Juan Isaza, etc.). Same request shape as /v1/search/domain — fires against expert graphs automatically.

​Search industry report graphs (Deloitte, WEF, Mintel, PwC, 60+ others). Same request shape as /v1/search/domain. Use alongside /search/domain and /search/expert for full topic-research coverage.

​Enrich a topic with institutional market data from up to 8 sources (Google Trends, US Census, BEA, FRED, BLS, OpenAlex, etc.). Returns demand_signals, economic_context, market_data, research_signals categorized with _source fields for citation. Bills at 0.5 tokens per call (half-rate).

​Single-hop brand footprint across all graphs — trends the brand is connected to, co-occurring brands (competitive context), cross-graph presence. Brand name goes in the path; tuning via ?maxEvidence and ?limit query params.

​Graph traversal from seed trend nodes. Returns adjacent trends, brands, and technologies with their relationship type. Use to answer “what else connects to this?” after a search. Depth 1-3 (default 1), up to 50 results.

​Next Steps

All Providers

Forward Proxy

Endpoints

List every available knowledge graph with graph_id, domain, curator, and example_queries. Free (0 tokens). Call first to discover valid graph_ids for other endpoints.

Search PSFK curated domain graphs (retail, beauty, sports, fashion) for trends with bundled evidence. No graph_id needed — searches all relevant domain graphs automatically. Primary workhorse for topic research.

Search expert specialist graphs authored by individual strategists (Ben Dietz, Juan Isaza, etc.). Same request shape as /v1/search/domain — fires against expert graphs automatically.

Search industry report graphs (Deloitte, WEF, Mintel, PwC, 60+ others). Same request shape as /v1/search/domain. Use alongside /search/domain and /search/expert for full topic-research coverage.

Enrich a topic with institutional market data from up to 8 sources (Google Trends, US Census, BEA, FRED, BLS, OpenAlex, etc.). Returns demand_signals, economic_context, market_data, research_signals categorized with _source fields for citation. Bills at 0.5 tokens per call (half-rate).

Single-hop brand footprint across all graphs — trends the brand is connected to, co-occurring brands (competitive context), cross-graph presence. Brand name goes in the path; tuning via ?maxEvidence and ?limit query params.

Graph traversal from seed trend nodes. Returns adjacent trends, brands, and technologies with their relationship type. Use to answer “what else connects to this?” after a search. Depth 1-3 (default 1), up to 50 results.

Next Steps