# Atlasimex SL

> Atlasimex SL is an international beverage company (energy, soft and functional drinks, private label). Partnering with brands and importers in 21+ countries. Base URL: https://atlasimex.es

## Site

- Homepage (English): https://atlasimex.es/en
- Homepage (Spanish): https://atlasimex.es/es
- Homepage (French): https://atlasimex.es/fr
- Homepage (Arabic): https://atlasimex.es/ar
- About Atlasimex SL: https://atlasimex.es/en/about
- Services (private label, manufacturing, export): https://atlasimex.es/en/services
- Portfolio (beverage brands): https://atlasimex.es/en/portfolio
- Private-label beverages: https://atlasimex.es/en/portfolio/private-label
- Blog: https://atlasimex.es/en/blog
- Logistics & export: https://atlasimex.es/en/logistics
- FAQ (MOQs, sizes, certifications, shipping): https://atlasimex.es/en/faq
- Contact Atlasimex SL: https://atlasimex.es/en/contact

> Per-post bodies: list posts via GET https://atlasimex.es/api/blog?locale=en&limit=20, then
> fetch the canonical HTML URL of each post. HTML pages carry BlogPosting
> JSON-LD (headline, datePublished/dateModified, author, wordCount).

## Developer resources (Atlasimex)

- Human API documentation: https://atlasimex.es/docs (authentication, endpoints, examples), also at https://atlasimex.es/developers
- OpenAPI specification (JSON): https://atlasimex.es/openapi.json
- OpenAPI specification (YAML): https://atlasimex.es/api/openapi.yaml
- API index (machine-readable): https://atlasimex.es/api
- Pinned v1 API index (frozen contract): https://atlasimex.es/api/v1
- API health: https://atlasimex.es/api/status
- MCP server manifest: https://atlasimex.es/mcp.json
- MCP handshake (Streamable HTTP): https://atlasimex.es/.well-known/mcp
- Sitemap: https://atlasimex.es/sitemap.xml
- RSS feeds: https://atlasimex.es/api/rss/en, https://atlasimex.es/api/rss/es, https://atlasimex.es/api/rss/fr, https://atlasimex.es/api/rss/ar

## Portfolio brands & flavors

- PROMAX Drinks (https://atlasimex.es/en/portfolio/promax-drinks): Classic Energy Drink, Apple & Melon, Watermelon & Red Grape, Wild Blackberry, Wild Strawberry, Premium Quality.
- X6 Drinks (https://atlasimex.es/en/portfolio/x6-drinks): Classic, Blue, Mojito.
- MAX TIGER Drinks (https://atlasimex.es/en/portfolio/max-tiger-drinks): Classic, Tutti Frutti, Blackberry, Strawberry.
- NF Energy Drinks (https://atlasimex.es/en/portfolio/nf-energy-drinks): Classic, Apple & Melon, Blackberry, Strawberry Blackberry, Watermelon & Red Grape, Pineapple & Coconut.
- Private Label (https://atlasimex.es/en/portfolio/private-label): .
- NEXOR Drinks (https://atlasimex.es/en/portfolio/nexor-drinks): Classic.

Machine-readable flavor lists: GET https://atlasimex.es/api/portfolio (each brand carries a `flavors` array).

## Atlasimex SL public API
Read endpoints need no authentication. Write endpoints are public but rate-limited. Error responses are JSON with `code`, `message` and `hint` fields.

## API versioning and deprecation (Atlasimex)

Current major: v1. Unversioned /api/* tracks v1; pinned /api/v1/* aliases are frozen, so pin them when you need a stable contract. You may send an `API-Version: v1` request header; every response echoes the served version in `API-Version`. Breaking changes ship as /api/v2 with >=6 months overlap: a deprecated major carries `Deprecation: true` plus a `Sunset` date header.

## Rate limits (Atlasimex)

Every API response carries RFC RateLimit headers (`RateLimit-Limit`, `RateLimit-Policy`, plus `RateLimit-Remaining`/`RateLimit-Reset` where tracked) and `API-Version`. Public reads: 600/minute shared. Contact form: 10/hour per IP. Newsletter: 5/hour per email. A 429 carries `Retry-After` (seconds) — wait that long, then self-throttle on the RateLimit headers.

- GET /api: endpoint index
- GET /api/status: health check
- GET /api/blog?locale=en&limit=20: list blog posts (locales: en, es, fr, ar)
- GET /api/blog/translated-slug?sourceLocale=en&targetLocale=es&slug=...: cross-locale slug resolution
- GET /api/portfolio: beverage portfolio brands
- POST /api/forms/submit: contact form; body: { form_type: "home_contact" | "contact_page", form_data: { email, first_name?, last_name?, subject?, message?, country?, website_hp?: "" }, locale, source_page }. Always send website_hp empty (honeypot); delivered via Stalwart webmail form with EmailJS fallback.
- POST /api/newsletter/subscribe: newsletter; body: { email } (max 5 attempts/email/hour)
- GET /api/rss/{locale}: RSS 2.0 feed

Example: curl https://atlasimex.es/api/blog?locale=en&limit=5

## Auth, webhooks, MCP

- Authentication: none required for read endpoints; no API keys are issued. Contact contact@atlasimex.es for integration questions.
- Webhooks: not offered. Poll the REST endpoints or RSS feeds instead.
- MCP: Atlasimex SL exposes an MCP-compatible manifest at /mcp.json describing the REST tools above for Claude, ChatGPT and other AI agents, with a live Streamable HTTP handshake at /.well-known/mcp.

## Contact

- Email: contact@atlasimex.es
- Phone: +34 951823125
- Address: C. Alejandro Dumas 17, 29004 Málaga, Spain
- YouTube: https://www.youtube.com/@atlasimex
- LinkedIn: https://www.linkedin.com/company/atlasimex/
- Instagram: https://www.instagram.com/atlasimex/
- Facebook: https://www.facebook.com/atlasimex.sl
- Tagline: Where Ideas Become Products