Designing a public cigar API developers can trust
How stable identifiers, curated serializers, and deterministic search create a dependable foundation for cigar apps.
Coming soonRich cigar data, built for developers
Build better cigar apps, faster.
Search and connect a large, structured cigar database—including brands, blends, products, and vitolas for each cigar—through developer-friendly REST, GraphQL, SDKs, and AI tools.
REST + GraphQLOAuth-readyStable public IDsDevelopment keys in minutes
GET /v1/cigars/search
const results = await boxpressd.cigars.search({
query: "Liga Privada",
include: ["brand", "vitolas"]
});
// Rich, structured results
{ id: "cigar_k9P4m...",
name: "Liga Privada No. 9",
vitolas: [{ shape: "Robusto", ... }] }Curated
public schema
Typed
identifiers
Fast
search
Quickstarts
Go from idea to first result.
01
Get an API key
Create a development app and make your first authenticated request.
02Search the database
Find cigars by brand, blend, wrapper, origin, and other useful attributes.
03Try GraphQL
Learn the public schema, connections, cursors, and query-cost controls.
04Connect a user
Add Sign in with Boxpressd using Authorization Code flow and PKCE.
The data advantage
Cigar data with the details your app actually needs.
Vitolas
Model the sizes and shapes available for each cigar instead of treating every blend as a single generic record.
Connected
Move naturally between cigars, brands, products, barcodes, venues, and user-authorized Boxpressd data.
Searchable
Build discovery with fuzzy search, deterministic ranking, filters, and stable cursor pagination.
Curated
Public serializers expose intentional domain models—not raw tables, private fields, or unstable internal names.
Platform
Choose how you build.
SDKs
Build in your language
Typed helpers and practical examples that move your cigar app from idea to first request quickly.
Explore SDKsREST API
Simple, durable endpoints
Search cigars, inspect vitolas, resolve names, and look up products or barcodes with predictable HTTP APIs.
Explore REST APIGraphQL
Request exactly what you need
Explore connected cigar, brand, vitola, product, venue, and authorized user data through a curated schema.
Explore GraphQLAI
Turn messy data into matches
Create intelligent cigar discovery and resolution experiences without exposing private Boxpressd services.
Explore AIBoxpressd API
Integrate cigar intelligence directly into your app.
Use one consistent platform for cigar search, detail pages, vitolas, barcode lookup, name resolution, and authorized user experiences.
View documentationJavaScriptcURLGraphQL
const response = await fetch(
"https://api.boxpressd.com/v1/cigars/search?q=padron",
{ headers: {
"x-boxpressd-key": process.env.BOXPRESSD_API_KEY
} }
);
const { data, pagination } = await response.json();Developer news
Notes for people building cigar apps.
Why vitolas matter in cigar data
A practical look at representing cigar sizes and shapes without flattening the details enthusiasts care about.
Coming soonFrom API key to cigar search in minutes
A forthcoming quickstart for building your first Boxpressd-powered search experience with REST or GraphQL.
Coming soonStart building