Public API

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.