Create & manage accounts
Provision contractor accounts programmatically. Set company profiles, service areas, and preferences — no browser required.
Developer API
NeedsDirt is Agent-Ready
The contractor marketplace for dirt, fill, and dump sites — now fully accessible via API.
Create accounts, post listings, search the marketplace, and handle billing programmatically. Build procurement agents, ERP integrations, or workflow automations on top of real contractor inventory.
Capabilities
The full marketplace, available via API
Everything a contractor can do in the app, your code can do too.
Post and browse listings
Create dirt available, dump site, dirt needed, and dump site needed listings. Search and filter by location, distance, type, and availability.
Handle billing end-to-end
Set up Stripe-powered subscriptions and payment methods via API. No manual checkout flow — billing is fully scriptable.
Build procurement agents
Connect NeedsDirt to your AI agent, ERP system, or operations platform. Automate material sourcing and vendor contact.
API keys
Scoped keys. Billing required.
API keys are issued after billing is confirmed — this is a production platform, not a sandbox.
1
Provision a token
Start the registration process via API
2
Register your account
Company info, service area, preferences
3
Add payment
Stripe-powered, handled via API
4
Receive your key
Scoped to READ, WRITE, and/or BILLING
Key Scopes
| Scope | What it unlocks |
|---|---|
| READ | Browse listings, search, account info |
| WRITE | Post listings, manage accounts, send messages |
| BILLING | Stripe billing setup, subscription management, payments |
Keys are issued per account. Rotate them anytime from your dashboard.
Reliability
Rate Limits
60 req/min per key. Built for real workloads.
| Limit | Value |
|---|---|
| Per key | 60 req/min |
| Provisioning (per IP) | 3 req/min |
| Global circuit breaker | 500 req/min |
Rate limit headers are returned on every response. NeedsDirt is contractor infrastructure — we take stability seriously.
Machine-Readable Docs
NeedsDirt publishes its API reference in llms.txt format — the emerging standard for machine-readable documentation. Your agent can reference the full API spec directly, without parsing HTML.
Use cases
Built for builders
Procurement agents
AI agents that monitor available listings, match material needs to supply, and surface deals automatically.
ERP integrations
Connect NeedsDirt to project management, job cost tracking, or fleet dispatch. Material logistics, automated.
Operations dashboards
Pull listing data, track material movement across sites, report on procurement in your own tooling.
Multi-site operators
Large excavation firms can script bulk listing creation, updates, and searches across their full project portfolio.
curl
# 1. Get a provisioning token
curl -X POST https://needsdirt.com/api/agent/provision \
-H "Content-Type: application/json" \
-d '{"email": "agent@example.com"}'
# 2. Browse listings (once you have a key)
curl https://needsdirt.com/api/listings \
-H "X-Agent-Key: nd_your_key_here"Ready to build?
NeedsDirt is the only contractor marketplace with a production-ready API. Built on Next.js 15, Stripe Connect, and real contractor inventory.