Parchment API

Stable green coffee data for sourcing tools, apps, and agents.

The generated Parchment API contract covers normalized pricing, availability, supplier coverage, authorized origin-map projections, roasting workflows, and account-linked resources. Browse the app to evaluate the feed, then move to API keys in the Parchment Console for production usage.

Explore the catalog

Start with the generated OpenAPI reference at api.purveyors.io/docs. Treat this app's /api/* routes as private BFF routes for the web experience. Use /api-dashboard for keys, usage, and billing.

40+
US importers

Every major specialty importer in one normalized schema. Wholesale and retail segmented.

Daily
Normalized updates

Arrivals, delistings, and price changes reflected same-day. 90+ days of price history.

One
Consistent schema

Origin, process, grade, price, and availability mapped consistently across every supplier.

3
Access tiers

Free evaluation, self-serve production, and enterprise. No scraping infrastructure required.

What you can build

  • Sync your internal sourcing dashboard with live offer lists from 40+ importers
  • Flag lots priced below the origin median for immediate buyer review
  • Feed agent and procurement workflows with normalized supplier schemas and arrival data
  • Render named origin groups and elevation profiles without downloading full catalog rows

Built for

  • Green coffee buyers who need market-wide pricing and arrival data before placing orders
  • Roastery software teams shipping sourcing and procurement features without building scrapers
  • Procurement analysts benchmarking bids against origin-level price distributions
  • Developers embedding live offer lists, arrival feeds, and supplier comparisons into internal tools

Plans

PlanPriceMonthly account requestsCollection itemsBest for
GreenFree200 per UTC calendar monthUp to 25 per responseEvaluate the feed, prototype integrations, validate schema fit
Origin$99/month10,000Up to 1,000 per read collection responseProduction sourcing tools, daily sync jobs, and live customer-facing features
EnterpriseCustomUnlimitedUp to 1,000 per read collection responseHigh-volume deployments, custom data agreements, and dedicated support

Green gets you into the full public-data capability family immediately at no cost, with 200 requests shared by every key on the account per UTC calendar month and up to 25 items per read collection response. Origin is $99/month for production integrations with up to 1,000 items per read collection response and 10,000 monthly account requests. Enterprise keeps the same per-request ceiling while covering unlimited request volume, custom data terms, and dedicated support. Manage keys and monitor usage in the Parchment Console.

Read collection limits apply to endpoints that return item lists. Aggregates such as facets and statistics follow their documented endpoint-specific bounds. Atomic inventory batch receipts remain complete up to their documented 50-item transaction bound.

API docs

Generated OpenAPI reference, schemas, auth modes, limits, and production examples.

Parchment Console

Create and deactivate keys, review usage, and manage billing in one place.

Live catalog

See the buyer-facing catalog experience powered by the same core dataset.

Market Index

Public price and market overview charts, with supplier movement, arrivals, and delistings in gated Parchment Intelligence modules.