{"name":"Bloomingdale's Coupons Public API","version":"1.0","site":"https://bloomingdalescoupons.xyz","language":"ar","documentation":"https://bloomingdalescoupons.xyz/llms.txt","license":"CC-BY-4.0 — attribution required, non-commercial reuse OK","contact":"https://bloomingdalescoupons.xyz/contact","endpoints":[{"path":"/api/public/coupons.json","method":"GET","description":"Active Bloomingdale's coupon codes for Gulf countries","cache_seconds":1800},{"path":"/api/public/brands.json","method":"GET","description":"Brand catalog with Arabic names, categories, and official URLs","cache_seconds":3600},{"path":"/api/public/posts.json","method":"GET","description":"Blog post index (metadata only; full text at /llms-full.txt)","cache_seconds":3600},{"path":"/api/public/lp.json","method":"GET","description":"Landing pages index with FAQs (long-tail SEO pages)","cache_seconds":3600},{"path":"/api/public/stats.json","method":"GET","description":"Aggregated site counts and last-updated timestamps","cache_seconds":1800},{"path":"/api/public/categories.json","method":"GET","description":"Brand & post category taxonomy with counts and slug lists","cache_seconds":3600},{"path":"/api/public/countries.json","method":"GET","description":"Gulf countries catalog: currency, cities, locale, canonical URL","cache_seconds":3600},{"path":"/api/public/faqs.json","method":"GET","description":"Unified Q/A dataset aggregated from landing pages and brand pages","cache_seconds":1800},{"path":"/api/public/openapi.json","method":"GET","description":"Formal OpenAPI 3.1 specification for tool discovery","cache_seconds":86400},{"path":"/api/public/postman.json","method":"GET","description":"Postman Collection v2.1.0 for one-click import","cache_seconds":86400},{"path":"/api/public/search.json?q={query}&type={all|brand|post|lp|coupon}&limit={1-50}","method":"GET","description":"One-shot full-text search across brands, posts, landing pages, and coupons","cache_seconds":600},{"path":"/api/public/coupon/{code}.json","method":"GET","description":"Single-coupon lookup by code (verify a specific code without downloading the full list)","cache_seconds":1800},{"path":"/api/public/brand/{slug}.json","method":"GET","description":"Single-brand lookup with FAQs and official URL","cache_seconds":3600},{"path":"/api/public/post/{slug}.json","method":"GET","description":"Single blog post lookup with full content sections","cache_seconds":3600},{"path":"/api/public/lp/{slug}.json","method":"GET","description":"Single landing-page lookup with sections and FAQs","cache_seconds":3600},{"path":"/api/public/latest.json?limit={1-50}","method":"GET","description":"Aggregated 'what's new' feed: newest posts, landing pages, and coupons in one payload","cache_seconds":1800},{"path":"/api/public/sitemap.json","method":"GET","description":"Machine-readable sitemap listing every URL (pages, brands, posts, LPs) as JSON","cache_seconds":3600},{"path":"/api/public/coupons/random.json","method":"GET","description":"Random active coupon — great for widgets and 'coupon of the moment' integrations","cache_seconds":0},{"path":"/api/public/health.json","method":"GET","description":"Health & inventory ping (status + dataset counts) for uptime monitors and LLM agents","cache_seconds":0},{"path":"/api/public/embed.js","method":"GET","description":"One-liner JS widget: <div id=\"bdxyz-coupons\"></div><script src=\".../embed.js\" async></script>","cache_seconds":1800},{"path":"/api/public/badge.svg","method":"GET","description":"Shields-style SVG badge with the current active coupon count (embeddable in READMEs)","cache_seconds":1800},{"path":"/api/public/go/{code}","method":"GET","description":"302 redirect helper — resolves a coupon code and bounces to the site with it highlighted","cache_seconds":300},{"path":"/api/public/copy/{code}","method":"GET","description":"Plain-text coupon lookup for shell pipelines (curl … | pbcopy)","cache_seconds":1800},{"path":"/api/public/mcp.json","method":"GET","description":"MCP-style tool manifest — describes every API as a callable tool with JSON Schema inputs","cache_seconds":86400},{"path":"/api/public/glossary.json","method":"GET","description":"Arabic e-commerce & coupon glossary (definitions + related links) for AEO/LLM grounding","cache_seconds":3600},{"path":"/api/public/deals-calendar.json","method":"GET","description":"Annual Bloomingdale's deals calendar with the next 3 upcoming events pre-computed","cache_seconds":3600},{"path":"/api/public/country/{slug}.json","method":"GET","description":"Single-country lookup (ksa, uae, kuwait, bahrain, qatar) with currency, locale, cities","cache_seconds":3600},{"path":"/api/public/similar/{brand-slug}.json","method":"GET","description":"Related-brands recommender — returns sibling brands in the same category","cache_seconds":3600},{"path":"/api/public/oembed.json?url={site-url}","method":"GET","description":"oEmbed 1.0 provider — rich URL unfurls for Slack, Discord, WordPress, Notion, etc.","cache_seconds":3600},{"path":"/api/public/related/{post-slug}.json","method":"GET","description":"Related-posts recommender — top 5 similar posts scored by category + keyword overlap","cache_seconds":3600},{"path":"/api/public/coupons.csv","method":"GET","description":"CSV export of active coupons (UTF-8 BOM, RFC 4180) — pipe into Excel or Google Sheets IMPORTDATA","cache_seconds":1800},{"path":"/api/public/brands.csv","method":"GET","description":"CSV export of the brand catalog with official URLs — offline snapshot for BI tools","cache_seconds":3600},{"path":"/api/public/coupons.md","method":"GET","description":"Markdown export of coupons + brands — paste-ready for LLM prompts, GitHub READMEs, Notion/Obsidian","cache_seconds":1800},{"path":"/api/public/coupons.rss","method":"GET","description":"RSS 2.0 feed dedicated to coupon updates — subscribe in any reader for live code changes","cache_seconds":1800},{"path":"/api/public/qr/{code}.svg","method":"GET","description":"QR code (SVG) for a coupon — scanning opens the site with the coupon highlighted; print/share ready","cache_seconds":86400},{"path":"/api/public/coupon-of-the-day.json","method":"GET","description":"Deterministic daily-rotating coupon (UTC) — cache-friendly featured slot for widgets and daily emails","cache_seconds":3600},{"path":"/og/coupon/{code}.svg","method":"GET","description":"Per-coupon 1200×630 OG image (Arabic RTL) — social share card when a coupon deep-link is shared","cache_seconds":86400},{"path":"/api/public/widget.html?limit={1-20}&theme={light|dark}","method":"GET","description":"Standalone HTML widget for <iframe> embedding — RTL, responsive grid of active coupons","cache_seconds":1800},{"path":"/api/public/verify/{code}.json","method":"GET","description":"Verify a coupon code (returns valid:true|false + details) — for chatbots and browser extensions","cache_seconds":1800}],"feeds":{"rss":"https://bloomingdalescoupons.xyz/rss.xml","atom":"https://bloomingdalescoupons.xyz/atom.xml","json_feed":"https://bloomingdalescoupons.xyz/feed.json","ical":"https://bloomingdalescoupons.xyz/deals-calendar.ics"},"sitemaps":{"index":"https://bloomingdalescoupons.xyz/sitemap-index.xml","text":"https://bloomingdalescoupons.xyz/sitemap.txt"},"llm_manifests":{"short":"https://bloomingdalescoupons.xyz/llms.txt","full":"https://bloomingdalescoupons.xyz/llms-full.txt"}}