APES DAILY · DEVELOPERS

APES DAILY Developer API

Public, read/self-serve API for the APES DAILY storefront. Machine-readable spec: /openapi.json.

Get started

The public API lives under https://apesdaily.com/api. All public endpoints are unauthenticated and return JSON (errors are structured JSON, never HTML). Test it with curl:

# Health check
curl https://apesdaily.com/api/health

# Structured brand + product data for AI agents
curl https://apesdaily.com/api/ai-info

# Concierge support (natural language)
curl -X POST https://apesdaily.com/api/support \
  -H "Content-Type: application/json" \
  -d '{"message":"show me travel gear"}'

# Submit a contact message
curl -X POST https://apesdaily.com/api/contact \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","message":"Where is my order?"}'

Endpoints

  • GET /api/health — service status + version.
  • GET /api/ai-info — organization + full retail product lineup (id, price, hook, deep-link URL, shipping, payment). Built for AI agents; also the source for /llms.txt.
  • POST /api/support — KONG concierge: order status (PayPal order id), shipping policy, returns, product recommendations, on-demand sourcing.
  • POST /api/contact — submit a customer-support message (replied to within 1–2 business days).

Full operation schemas, parameters, and response types are in /openapi.json (OpenAPI 3.1). Every operation has a unique operationId for LLM function-calling.

Versioning & deprecation

The API is versioned. The current version is v1, advertised on every response via the X-API-Version header (plus Api-Version). Breaking changes ship as a new major version and never land silently on v1. Deprecated endpoints keep working during the overlap period and emit Deprecation: true and Sunset: <date> headers; the minimum overlap is 30 days after first announcement.

Rate limits

Public endpoints are rate-limited (default 600 requests / 60 seconds per IP). Every response carries standard headers — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — so agents can self-throttle in real time. A 429 response adds Retry-After (seconds) and a structured JSON body.

Authentication & access

Public endpoints require no API key. The payment, fulfillment, CJ-webhook, and UCP endpoints are not public and are not listed here. To request access or report a bug, email contact@apesdaily.com.

Error format

Errors are JSON with a stable code, message, and resolution hint:

{
  "ok": false,
  "error": "MISSING_FIELDS",
  "message": "`email` and `message` are required.",
  "resolution": "Provide both an `email` address and a `message`."
}

CLI

Script the API from the terminal with the apes CLI (Python). Install via pipx install apesdaily-cli (PyPI) or from source (see llms.txt). Example:

# Health
apes health

# AI product brief (JSON)
apes ai-info

# Ask the concierge
apes ask "where is my order 123456789012"?

More resources