Connecting Marketora via API for Developers

Headless API Overview

Developers can integrate Marketora's headless marketing engine directly into custom frontends, internal marketing automation bots, or command-line workflows. All public endpoints adhere to standard REST conventions and return structured JSON envelopes.

Standard Response Envelope

Every content query returns a standardized envelope:

{
  "data": [...],
  "meta": { "page": 1, "limit": 20 },
  "seo": { "title": "...", "canonical": "..." },
  "jsonld": { "@context": "https://schema.org", "@graph": [...] },
  "breadcrumbs": [...]
}

Core API Endpoints

• GET /api/method/marketora_cms.api.v1.marketing.list_help_articles: Returns published help center articles grouped by category.
• GET /api/method/marketora_cms.api.v1.marketing.get_help_article?slug={slug}: Fetches individual article body, SEO metadata, and schema markup.
• GET /api/method/marketora_cms.api.v1.seo.list_sitemap_entries: Returns complete dynamic sitemap entries with lastmod and alternate hreflang tags.

Authentication & Headers

Public listing endpoints are accessible via guest read access. Administrative or write endpoints require standard Frappe API key and secret headers:

Authorization: token api_key:api_secret