Skip to main content
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.

LTL Fuel Surcharge

ladourv/api/ltl-fuel-surcharge-api · $0.03 per request

ABC License Compliance

ladourv/api/abc-license-compliance-api · $0.05 per request
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.
You can subscribe to both listings with the same RapidAPI account. They bill independently.

​
2. Your first LTL fuel surcharge call

curl "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge?carriers=ODFL&weeks=1" \
  -H "X-API-Key: YOUR_KEY"
Expected response shape: 
{
  "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
  }
}
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.
curl "https://api.nexusfeed.dev/v1/abc/search?state=CA&dba_name=TRADER%20JOE" \
  -H "X-API-Key: YOUR_KEY"
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)

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

Authentication

Header formats, error codes, and rate limits.

Verifiability contract

What the confidence score actually means and how to gate on it.

Install MCP server

Use NexusFeed from Claude, Cursor, Cline, Windsurf, Zed.

Full API reference

Every endpoint, every field, generated from the live OpenAPI spec.