> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusfeed.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get a working fuel surcharge or liquor license call in under a minute.

This guide assumes you want one of two things: a live LTL fuel surcharge rate or a current ABC liquor license status. Both follow the same pattern — get a key, send one request, read the `_verifiability` block.

## 1. Get an API key

NexusFeed is provisioned through RapidAPI in the MVP phase. There are two separate listings — one per product. Subscribe to the one you need.

<CardGroup cols={2}>
  <Card title="LTL Fuel Surcharge" icon="truck" href="https://rapidapi.com/ladourv/api/ltl-fuel-surcharge-api">
    `ladourv/api/ltl-fuel-surcharge-api` · \$0.03 per request
  </Card>

  <Card title="ABC License Compliance" icon="id-card" href="https://rapidapi.com/ladourv/api/abc-license-compliance-api">
    `ladourv/api/abc-license-compliance-api` · \$0.05 per request
  </Card>
</CardGroup>

After subscribing, RapidAPI shows you an `X-RapidAPI-Key` on the listing page. That is your API key. It is also valid as `X-API-Key` when calling `api.nexusfeed.dev` directly.

<Tip>
  You can subscribe to both listings with the same RapidAPI account. They bill independently.
</Tip>

## 2. Your first LTL fuel surcharge call

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge?carriers=ODFL&weeks=1" \
    -H "X-API-Key: YOUR_KEY"
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.get(
      "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge",
      params={"carriers": "ODFL", "weeks": 1},
      headers={"X-API-Key": "YOUR_KEY"},
  )
  data = resp.json()
  print(data["weeks"][0]["fuel_surcharge_pct"])
  print(data["_verifiability"]["extraction_confidence"])
  ```

  ```javascript Node theme={null}
  const resp = await fetch(
    "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge?carriers=ODFL&weeks=1",
    { headers: { "X-API-Key": "YOUR_KEY" } }
  );
  const data = await resp.json();
  console.log(data.weeks[0].fuel_surcharge_pct);
  console.log(data._verifiability.extraction_confidence);
  ```
</CodeGroup>

Expected response shape:

```json theme={null}
{
  "carrier": "ODFL",
  "weeks": [
    {
      "effective_date": "2026-04-07",
      "fuel_surcharge_pct": 42.3,
      "doe_diesel_price_usd": 3.812
    }
  ],
  "_verifiability": {
    "source_timestamp": "2026-04-10T14:22:11Z",
    "extraction_confidence": 1.0,
    "raw_data_evidence_url": "https://api.odfl.com/tools/fuel-history/v1.0/fuel-history.list",
    "extraction_method": "api_mirror",
    "data_freshness_ttl_seconds": 604800
  }
}
```

<Warning>
  Always check `_verifiability.extraction_confidence >= 0.90` before using a rate in a billing decision or invoice audit. Lower confidence means one or more required fields could not be extracted cleanly from the upstream source.
</Warning>

## 3. Your first ABC license search

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.nexusfeed.dev/v1/abc/search?state=CA&dba_name=TRADER%20JOE" \
    -H "X-API-Key: YOUR_KEY"
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.get(
      "https://api.nexusfeed.dev/v1/abc/search",
      params={"state": "CA", "dba_name": "TRADER JOE"},
      headers={"X-API-Key": "YOUR_KEY"},
  )
  data = resp.json()
  for record in data["results"]:
      print(record["license_number"], record["status"], record["expiration_date"])
  ```

  ```javascript Node theme={null}
  const resp = await fetch(
    "https://api.nexusfeed.dev/v1/abc/search?state=CA&dba_name=TRADER%20JOE",
    { headers: { "X-API-Key": "YOUR_KEY" } }
  );
  const data = await resp.json();
  data.results.forEach((r) =>
    console.log(r.license_number, r.status, r.expiration_date)
  );
  ```
</CodeGroup>

At least one of `dba_name`, `owner_name`, or `address` is required. Results are cached for 24 hours keyed on the query parameters.

## 4. Direct license lookup (already know the license number)

```bash theme={null}
curl "https://api.nexusfeed.dev/v1/abc/license/47-123456?state=CA" \
  -H "X-API-Key: YOUR_KEY"
```

This is the precise version — one license number in, one record out. The `_verifiability.raw_data_evidence_url` in the response links directly to the state agency's record so a human auditor can independently verify.

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Header formats, error codes, and rate limits.
  </Card>

  <Card title="Verifiability contract" icon="shield-check" href="/verifiability">
    What the confidence score actually means and how to gate on it.
  </Card>

  <Card title="Install MCP server" icon="plug" href="/mcp/install">
    Use NexusFeed from Claude, Cursor, Cline, Windsurf, Zed.
  </Card>

  <Card title="Full API reference" icon="book" href="/api-reference">
    Every endpoint, every field, generated from the live OpenAPI spec.
  </Card>
</CardGroup>