Fodda

Documentation Index

Fetch the complete documentation index at: https://lava.so/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

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.

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. Pairs with /v1/search/expert and /v1/search/report when broader topic-research coverage is useful. For ideation, follow up with /v1/graphs//neighbors using the returned trend_ids as seed_node_ids to traverse adjacent territories.

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. Pairs with /v1/search/domain and /v1/search/report when broader topic-research coverage is useful.

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. Pairs with /v1/search/domain and /v1/search/expert when broader topic-research coverage is useful.

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.

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"]}'

​

Reach for this whenever a query names a specific brand or company. Returns a single-hop brand footprint across all graphs — trends the brand is connected to, co-occurring brands (competitive context), and cross-graph presence. Brand name goes in the path; tuning via ?maxEvidence and ?limit query params.

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 other connected nodes with their relationship type. Use to answer “what else connects to this?” after a search. Depth defaults to 1, up to 50 results. Optional filters: relationship_types (e.g. RELATED_TO, EVIDENCED_BY, SEMANTICALLY_SIMILAR, ASSOCIATED_BRAND, MENTIONS_BRAND, IN_LOCATION, VALIDATED_BY — Fodda accepts unknown values silently and returns no matches) and direction (in, out, or both; default out).

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}'

​

Next Steps