Skip to content

Getting started

Production:

https://api.shishapp.es/api/public/v1

All commercial Public API routes live under this prefix. The OpenAPI contract documents this production server only.

Subscribe from shishapp.es/pricing. There is no free plan or sandbox in this product model.

Starter and Pro are self-serve on the pricing page. Business is sales-configured — contact support@shishapp.es.

After payment is confirmed, ShishApp provisions access and delivers your key through a secure channel. The key is never shown in full on the pricing page. Rotation, suspension, and revocation are handled by ShishApp (there is no Public API for key management).

Keys look like:

ska_v1_…_…

Treat the key as a secret. Call the API only from your server — never from a public frontend, never as a query parameter.

Active key limits (per subscription):

PlanMax active keys
Starter1
Pro3
Business10

For key delivery, rotation, or support: support@shishapp.es.

Terminal window
BASE_URL="https://api.shishapp.es/api/public/v1"
API_KEY="ska_v1_…"
curl -i -H "X-API-Key: $API_KEY" "$BASE_URL/brands"

A successful response includes rate-limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).

Search example (requires .enriched — Pro / Business):

Terminal window
curl -H "X-API-Key: $API_KEY" \
"$BASE_URL/tobaccos/search?q=kent&grams=50&page=1&pageSize=20"

Import the JSON into Postman, Insomnia, or your codegen tooling.