> ## 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.

# 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).

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](https://www.fodda.ai/api) for full documentation.

<Info>Supports both **managed** (Lava's API keys) and **unmanaged** (bring your own credentials) mode.</Info>

## 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

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.fodda.ai/v1/graphs', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.fodda.ai%2Fv1%2Fgraphs" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### 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/\{graph\_id}/neighbors using the returned trend\_ids as seed\_node\_ids to traverse adjacent territories.

**POST** `https://api.fodda.ai/v1/search/domain` — \$0.20 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    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
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    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}'
    ```
  </Tab>
</Tabs>

### 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.

**POST** `https://api.fodda.ai/v1/search/expert` — \$0.20 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    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
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    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}'
    ```
  </Tab>
</Tabs>

### 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.

**POST** `https://api.fodda.ai/v1/search/report` — \$0.20 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    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
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    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}'
    ```
  </Tab>
</Tabs>

### 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.

**POST** `https://api.fodda.ai/v1/supplemental/context` — \$0.20 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.fodda.ai/v1/supplemental/context', {
      body: {
    "query": "sustainable packaging trends",
    "domain": "retail",
    "brands": [
      "Loop",
      "TerraCycle"
    ]
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    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"]}'
    ```
  </Tab>
</Tabs>

### 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.

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

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.fodda.ai/v1/brand-intelligence/Patagonia?maxEvidence=10&limit=50', { method: 'POST' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    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"
    ```
  </Tab>
</Tabs>

### 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`).

**POST** `https://api.fodda.ai/v1/graphs/retail/neighbors` — \$0.20 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.fodda.ai/v1/graphs/retail/neighbors', { body: {"seed_node_ids":["6445"],"depth":2,"limit":30} });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    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}'
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>