AlphaLoops Developer SDKs and CLI — Now Available

We just shipped three new packages that make working with the AlphaLoops API dramatically easier. Python SDK, TypeScript SDK, and a command-line tool. No more hand-rolling HTTP requests, managing pagination, or parsing raw JSON. Install, authenticate, and start pulling carrier data in under a minute.

Why we built this

Our platform already delivers carrier intelligence into Salesforce and HubSpot. But we kept hearing the same request from engineering and data teams: "Can we just hit an API?"

Now you can. The SDKs wrap our REST API with typed methods, automatic pagination, built-in retries, and rate-limit handling so you can focus on what you're building instead of plumbing. Whether you're enriching a data pipeline, building internal tools, or prototyping an integration, you get direct access to carrier profiles, fleet data, inspections, crash history, contacts, and authority records across 2.3M+ carriers.

What's included

Python SDK

pip install alphaloops-freight-sdk

Five resource modules covering the full AlphaLoops API surface:

• Carriers — profiles by DOT or MC number, fuzzy company search with confidence scoring, authority history, and news mentions

• Fleet — truck and trailer registrations with full pagination

• Inspections — roadside inspection history and violation details

• Crashes — crash records with date range and severity filters (fatal, injury, tow, property damage)

• Contacts — people search by DOT number, company name, or seniority level, plus enrichment for verified emails, phones, and work history

Every resource includes _iter helpers that handle pagination automatically. Config resolution is layered: pass a key directly, set ALPHALOOPS_API_KEY, or drop a ~/.alphaloops file. Built-in retries, rate-limit handling, and typed exceptions (AlphaLoopsAuthError, AlphaLoopsRateLimitError, etc.) are included out of the box.

python

from alphaloops.freight import AlphaLoops

al = AlphaLoops()  # reads from ~/.alphaloops or ALPHALOOPS_API_KEY

carrier = al.carriers.get("2247505")
print(carrier.legal_name, carrier.total_trucks)

# Fuzzy search with confidence scoring
results = al.carriers.search("Werner Enterprises", state="NE")

# Iterate all inspections without worrying about pagination
for inspection in al.inspections.list_iter("2247505"):
    print(inspection)

# Find decision-makers
contacts = al.contacts.search(dot_number="2247505", job_title_levels="c_suite")

TypeScript SDK

npm install alphaloops-freight-sdk

Same API surface, zero dependencies. Works in Node.js, Deno, Bun, or any TypeScript project.

typescript

import AlphaLoops from "alphaloops";

const al = new AlphaLoops();

const carrier = await al.carriers.get("2247505");
console.log(carrier.legalName, carrier.totalTrucks);

CLI — loopsh

pip install alphaloops-freight-cli

A terminal-first interface for carrier lookups, prospecting, and scripting. Rich-formatted tables for humans, --json output for machines.

bash

# Authenticate once
loopsh login

# Look up a carrier
loopsh carriers 2247505

# Fuzzy search
loopsh carriers search "JB Hunt" --state AR

# Pipe JSON into scripts or agents
DOT=$(loopsh --json carriers search "Swift" | jq -r '.results[0].dot_number')
loopsh fleet trucks "$DOT"
loopsh inspections list "$DOT"
loopsh crashes list "$DOT" --severity FATAL

One of our favorite features: the --python and --typescript flags. Instead of executing the command, they print the equivalent SDK code. Great for prototyping in the terminal and then dropping the code into your project.

bash

loopsh --python carriers get 2247505
# Outputs:
# from alphaloops.freight import AlphaLoops
# al = AlphaLoops()
# result = al.carriers.get("2247505")
# print(result)

Who this is for

Data and engineering teams building carrier scoring models, risk pipelines, or custom integrations. Pull fleet size, inspection history, crash severity, and authority changes directly into your stack.

RevOps and sales engineers scripting account enrichment or CRM sync workflows. Use the CLI to do quick carrier lookups from the terminal, or automate nightly enrichment runs with the SDK.

AI and automation builders using agents or MCP tools. The --json flag and structured error handling make AlphaLoops easy to plug into agentic workflows.

Get started

1. Grab an API key (or reach out if you're an existing customer)

2. Install:

bash

pip install alphaloops-freight-sdk   # Python
pip install alphaloops-freight-cli   # CLI
npm install alphaloops-freight-sdk   # TypeScript

1. Authenticate and go:

bash

export ALPHALOOPS_API_KEY="ak_..."
# or
loopsh login

Full API reference and docs are available at runalphaloops.com/docs.

Links: Python SDK on PyPI · CLI on PyPI · TypeScript SDK on npm