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

# NexusFeed

> Real-time LTL fuel surcharge and ABC liquor license data built for AI agents. 10 carriers, 5 states, every response signed with a verifiability block.

NexusFeed is a data API for two things that are painful to extract and critical to get right: **LTL freight fuel surcharges** from the ten largest U.S. national carriers, and **ABC liquor license status** from California, Texas, New York, Florida, and Illinois.

Every response carries a `_verifiability` block with a source timestamp, a deterministic confidence score, the raw evidence URL on the upstream agency or carrier site, the extraction method that was used, and a freshness TTL. If you are wiring an agent, a compliance pipeline, or an invoice auditor, that block is the difference between "plausible JSON" and "defensible data."

<CardGroup cols={2}>
  <Card title="LTL Fuel Surcharge API" icon="truck" href="/products/ltl-fuel-surcharge">
    Current and historical fuel surcharge rates for ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt, and FedEx Freight — with the DOE diesel price that triggered each rate.
  </Card>

  <Card title="ABC License Lookup API" icon="id-card" href="/products/abc-license-lookup">
    Search and direct-lookup liquor licenses across CA, TX, NY, FL, and IL. Returns license status, expiration, license type, holder, and address — cached 24 hours.
  </Card>
</CardGroup>

## Who this is for

NexusFeed was built for developers shipping agentic workflows, compliance tooling, and freight-cost automation. The typical consumer is either:

* **An AI agent** calling the API via the MCP server (`pip install nexusfeed-mcp`), during a user-facing conversation about freight rates or liquor license compliance.
* **A backend service** calling the REST endpoints directly from a freight brokerage TMS, a liquor distributor onboarding flow, an insurance underwriting pipeline, or a 3PL invoice auditor.

If you have a human filling out a form on a state ABC website, or a developer copy-pasting fuel surcharge PDFs into a spreadsheet, this API is the replacement.

## What makes it different

<AccordionGroup>
  <Accordion title="Verifiability is a first-class field, not a disclaimer">
    Every response includes `_verifiability.raw_data_evidence_url` pointing directly to the upstream source. Confidence is computed deterministically from the count of required fields that were successfully extracted — it is never hard-coded. If you are pasting license data into a compliance decision, you can cite the source and a timestamp in the same JSON payload. See [Verifiability](/verifiability).
  </Accordion>

  <Accordion title="Built for agents, exposed as both REST and MCP">
    The same data is available over HTTP (X-API-Key) for conventional services and over [Model Context Protocol](/mcp/install) for Claude, Cursor, Cline, Windsurf, Zed, and any other MCP client. Install with `pip install nexusfeed-mcp`, point it at your API key, and the tools appear in your agent.
  </Accordion>

  <Accordion title="Fallbacks everywhere the upstream source is hostile">
    Extractors prefer hidden JSON endpoints (ODFL, Averitt) when available, Playwright DOM parsing when not (Saia, Estes, R+L, TForce, XPO, SEFL), and ScraperAPI render-API bypass for the adversarial ones (FedEx Freight, Illinois ILCC's Akamai-protected Salesforce Experience Cloud portal). TX TABC's image CAPTCHA is solved via 2Captcha. When the primary path fails, fallbacks trigger automatically and the response reports the method that actually ran.
  </Accordion>

  <Accordion title="Redis cache-aside with honest TTLs">
    LTL fuel surcharges cache for 7 days (carriers publish weekly). ABC license data caches for 24 hours. The `_verifiability.data_freshness_ttl_seconds` field tells you exactly how fresh a given response is allowed to be.
  </Accordion>
</AccordionGroup>

## Try it in 60 seconds

<Steps>
  <Step title="Get an API key">
    Subscribe to either listing on RapidAPI — the free tier gives you enough calls to test everything. See [Quickstart](/quickstart).
  </Step>

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

  <Step title="Check the verifiability block">
    Inspect `_verifiability.extraction_confidence` and `_verifiability.raw_data_evidence_url` to confirm the data is usable for your workflow.
  </Step>
</Steps>

## Coverage at a glance

| Product            | Coverage                                                                 | Cache TTL | Unit price       |
| ------------------ | ------------------------------------------------------------------------ | --------- | ---------------- |
| LTL Fuel Surcharge | 10 carriers (ODFL, SAIA, EXLA, ABFS, RLCA, TFIN, CNWY, SEFL, AVRT, FXFE) | 7 days    | \$0.03 / request |
| ABC License Lookup | 5 states (CA, TX, NY, FL, IL)                                            | 24 hours  | \$0.05 / request |

Base URL: `https://api.nexusfeed.dev`. Rate limit: 60 requests per minute per tenant by default.