Public Articles
Retrieve Tradebird Articles as selected, agent-readable Markdown and typed public context.
Public Articles are reader-first marketplace resources. The website renders the same selected version returned by the public API and MCP tools.
List Articles
GET /api/v1/marketplace/articles returns summaries in reverse publication
order. Use limit and offset for ordinary pagination.
Get an Article
GET /api/v1/marketplace/articles/{articleSlug} returns:
- title, summary, publisher, optional author, and public dates;
- canonical
bodyMarkdown; - selected lead, inline, and social-preview media metadata;
- typed relationships to Categories, Products, Services, companies, and other Articles;
- canonical public URLs and safe next actions.
Rendered HTML, draft or generation state, source dossiers, internal version identifiers, and private workspace data are never part of the response.
Rendering safely
Treat bodyMarkdown as content, not executable code. Tradebird's reader ignores
raw HTML, MDX, JSX, expressions, and unregistered images. Integrations should
apply an equivalent safe Markdown policy or present the source as plain text.