Content API, registry, and usage guide built for real integrations.
This is the live reference surface for Upflame's public content platform. Every endpoint, field list, and example here is aligned to the current snapshot version so teams can integrate without guessing.
Endpoint Matrix
Use the right endpoint for the job.
The canonical routes are intentionally purpose-specific: browse with the catalog endpoint, fetch one canonical page with the detail route, search with lightweight summaries, and use the AI feed or registry when you need structured ingestion or platform-wide discovery.
| Endpoint | Purpose | Notes |
|---|---|---|
| /api/content | Browse the public content catalog with filters and cursor pagination. | ETag enabled, snapshot-versioned, and public-safe by allowlist. |
| /api/content/[...slug] | Retrieve one canonical public content page by path or alias. | ETag enabled, snapshot-versioned, and public-safe by allowlist. |
| /api/search | Run lightweight query-first search over summary fields and tags. | ETag enabled, snapshot-versioned, and public-safe by allowlist. |
| /api/ai-feed | Consume structured, HTML-reduced sections for AI or workflow ingestion. | ETag enabled, snapshot-versioned, and public-safe by allowlist. |
| /api/content/schema | Discover the live contract, filters, limits, and compatibility mapping. | ETag enabled, snapshot-versioned, and public-safe by allowlist. |
| /api/content/registry | Inspect the registry snapshot, indexability state, and sitemap-facing page inventory. | ETag enabled, snapshot-versioned, and public-safe by allowlist. |
Quick Start
Go from zero to a working client fast.
The examples below are aligned to the live schema and registry. Use them as the baseline integration path, then move to conditional requests and cursor pagination once you are in production.
Browse content
curl "https://www.upflame.in/api/content?cluster=brand&view=summary&limit=5"Fetch the registry
curl "https://www.upflame.in/api/content/registry"Conditional request with ETag
curl -H 'If-None-Match: "previous-etag"' "https://www.upflame.in/api/content"Browser fetch example
const response = await fetch("/api/content?view=summary&limit=10");
const payload = await response.json();
console.log(payload.items);Schema And Registry
The platform describes itself.
Schema discovery is the contract surface. The registry is the inventory surface. Together they let external teams understand the platform without scraping or reverse-engineering responses.
Discovery summary
- Views: summary, detail, ai
- Pagination: cursor by path
- Catalog filters: cluster, pageFamily, market, persona, q, limit, cursor, view
- Docs page: /developers/api
Registry sample
[
{
"id": "upflame-about__team",
"path": "about/team",
"slug": "team",
"cluster": "brand",
"pageFamily": "conversion",
"market": "india",
"schemaType": "Service",
"indexable": true,
"indexabilityReason": "publish_allow",
"canonicalUrl": "https://www.upflame.in/about/team/",
"title": "About the Upflame Team for enterprise buyers",
"metaDescription": "Upflame team: enterprise governance, implementation risks, decision criteria, and next steps. About the Upflame Team is framed for Buying Committee teams tha...",
"HeroIMG": "https://res.cloudinary.com/dufzctlaj/image/upload/v1774294126/Whisk_5b988cbb720b63198df4435c805b4f55dr_hnkvle.jpg",
"sitemapShard": "conversion",
"contentVersion": "033d79c00b87c741"
},
{
"id": "upflame-advisory",
"path": "advisory",
"slug": "advisory",
"cluster": "advisory_services",
"pageFamily": "pillar",
"market": "global",
"schemaType": "Service",
"indexable": true,
"indexabilityReason": "publish_allow",
"canonicalUrl": "https://www.upflame.in/advisory/",
"title": "Enterprise Advisory Services: enterprise strategy and operating g...",
"metaDescription": "Enterprise Advisory Services for CFO teams: Enterprise Advisory Services is framed for CFO teams that need to compare options with clear governance and execu...",
"HeroIMG": "https://res.cloudinary.com/dufzctlaj/image/upload/v1774293677/Whisk_eceb2e9cc2cce599dd94a206b61fa400dr_1_z4ekba.jpg",
"sitemapShard": "advisory",
"contentVersion": "033d79c00b87c741"
},
{
"id": "upflame-advisory__ai-compliance",
"path": "advisory/ai-compliance",
"slug": "ai-compliance",
"cluster": "ai_governance_sovereignty",
"pageFamily": "advisory_hub",
"market": "india",
"schemaType": "Service",
"indexable": true,
"indexabilityReason": "publish_allow",
"canonicalUrl": "https://www.upflame.in/advisory/ai-compliance/",
"title": "AI Compliance Consulting for risk-aware enterprise decisions",
"metaDescription": "AI compliance consulting India: enterprise governance, implementation risks, decision criteria, and next steps.",
"HeroIMG": "https://res.cloudinary.com/dufzctlaj/image/upload/v1774294127/Whisk_97a571d5d2361e2913846b7f0e938afddr_cdxf8z.jpg",
"sitemapShard": "core",
"contentVersion": "033d79c00b87c741"
}
]Operational Notes
Caching, limits, and migration are explicit.
This platform is meant to be predictable under load. Read endpoints return cache headers, ETags, and stable error bodies. Compatibility routes remain available, but the canonical routes and the registry should be the default path for all new work.
Caching
Every read endpoint supports ETag, If-None-Match, and cache-control hints so clients can avoid unnecessary re-fetches between snapshot versions.
Rate limits
Limits are route-specific and exposed through headers. The discovery endpoint documents the current default ceiling for each public route.
Migration
Legacy /api/content/pages* wrappers remain available during transition, but new consumers should move directly to /api/content and /api/content/registry.