Make Your First API Call

Cafecito uses one gateway (https://api.cafecito.tech) and Authorization: Bearer for authenticated REST and MCP. Health is public. See reusable clients when you need pagination, errors, and retries.

Live products: Beans and Espresso. Cortado is not callable yet.

Code
export CAFECITO_API_KEY="YOUR_API_KEY"
export BASE_URL="https://api.cafecito.tech"

curl -sS "$BASE_URL/beans/health"
curl -sS "$BASE_URL/espresso/health"

Beans: recent news & publisher articles

Code
curl -sS --get "$BASE_URL/beans/articles/latest" \
  --data-urlencode "content_type=news" \
  --data-urlencode "limit=5" \
  -H "Authorization: Bearer $CAFECITO_API_KEY"

Continue with the Beans overview or Beans API reference. Beans collections return pagination.next_cursor.

Espresso: market events and signals

Code
curl -sS --get "$BASE_URL/espresso/events" \
  --data-urlencode "q=semiconductor supply pressure" \
  --data-urlencode "limit=5" \
  -H "Authorization: Bearer $CAFECITO_API_KEY"

Continue with the Espresso overview or Espresso API reference. Espresso collections return pagination.next_cursor. See API conventions.

Unknown or route-inapplicable query parameters return HTTP 400 with the ErrorResponse envelope. Empty searches return HTTP 200 with data: [].

Using the API in production

• Limits: 100 requests/minute and 50,000/month per authenticated user, shared across keys; REST and MCP share the meter. Pricing
• Compatibility is additive; breaking changes get a new version and deprecation notices. Support: Contact
• Operational recovery: Troubleshooting

Next steps

• API keys
• Reusable clients
• MCP and AI agents