# FusionWW Public Content API

> Programmatic access to FusionWW's electronic component catalog, search, and marketing content.

FusionWW is a global distributor of electronic components. This API provides:

## Catalog Browsing
- GET /v1/catalog/categories — Full category tree
- GET /v1/catalog/categories/{id} — Single category
- GET /v1/catalog/categories/{id}/products — Products in a category (paginated)
- GET /v1/catalog/manufacturers — All manufacturers (alphabetical)
- GET /v1/catalog/manufacturers/{id}/products — Products by manufacturer (paginated)
- GET /v1/catalog/products/{mpn} — Product by Manufacturer Part Number
- GET /v1/catalog/products/id/{id} — Product by internal ID

## Product Data Model
Each product includes:
- **Core fields**: productId, mpn, name, description, countryOfOrigin, tag, isActive, relevance
- **Availability**: quantity (stock quantity), leadTimeDays (estimated lead time in days)
- **Manufacturer**: id, name, code (e.g. "AMD", "INTEL")
- **Category**: id, name (with full taxonomy breadcrumb)
- **Attributes**: Structured array of all product attributes with metadata:
  - name, value, isFilter, typeId, heroIndex, displayIndex, isHidden
- **Images**: Array of product images with name and url
- **Documents**: Array of datasheets with id, url, isActive, createdOn, updatedOn
- **SEO**: Structured SEO content with description, keyFeatures, h2, applicationData
- **Backward-compat**: productInfo (flat "Name:Value" strings), imageUrl (first image URL)

Note: Pricing and offer details require authenticated access. Contact contact@fusionww.com to request credentials.

## Full-Text Search
- GET /v1/search?q={term} — Search products (Algolia-powered)
- GET /v1/search/suggest?q={prefix} — Autocomplete suggestions

## Marketing Content
- GET /v1/content/navigation — Site navigation tree (includes category mega-menu + featured manufacturers)
- GET /v1/content/homepage — Homepage sections and configuration
- GET /v1/content/pages — Available page types
- GET /v1/content/pages/{pageType} — Page slugs for a type
- GET /v1/content/pages/{pageType}/{slug} — Full page with sections
- GET /v1/content/categories/{categoryId}/seo — Category SEO content (eyebrow, title, description, sections)
- GET /v1/content/industries — All industry pages
- GET /v1/content/industries/{slug} — Single industry page
- GET /v1/content/services — All service pages
- GET /v1/content/services/{slug} — Single service page
- GET /v1/content/announcements — Active site announcements

## Blog
- GET /v1/content/blog — Paginated blog posts (newest first); gated posts marked with `gated: true`
- GET /v1/content/blog/{slug} — Single blog post; premium/time-gated posts return summary only (no htmlContent)

## Documentation
- GET /docs — Interactive Swagger UI
- GET /redoc — ReDoc documentation
- GET /openapi.json — OpenAPI 3.1 specification
- GET /v1/meta/stats — Catalog statistics (product count, last sync)

## Response Format
All responses use JSON with Schema.org @context/@type annotations and HATEOAS _links for navigation.