Skip to main content

Public API

Machine-readable exports of the curated library. All endpoints are static JSON files published with the site.

Base URL:

https://llazyemail.github.io/awesome-email-marketing/api/v1/

Endpoints

EndpointDescription
catalog.jsonFull tagged resource catalog
metrics.jsonCounts by section and tag
glossary.jsonGlossary terms and definitions
docs-pages.jsonAuto-generated list of every docs markdown page

Catalog item shape

{
"id": "mailchimp",
"name": "Mailchimp",
"url": "https://mailchimp.com/",
"description": "Free emailing software",
"section": "tools",
"sourcePage": "/docs/tools/best-tools",
"tags": ["esp", "free", "newsletter"]
}

Example

curl -s https://llazyemail.github.io/awesome-email-marketing/api/v1/catalog.json | jq '.items | length'

Filter client-side by tag, or use the interactive Explore page.

LLM / agent exports

Built automatically with each site build (see issue #223):

PathDescription
/llms.txtllmstxt.org index of documentation pages
/llms-full.txtFull docs corpus concatenated for LLM context
Doc .md URLsAppend .md to a docs URL (via markdown source plugin), or use per-page markdown files from the LLMs plugin
Copy page buttonOn docs pages — copy clean Markdown or open in ChatGPT / Claude / Gemini / Perplexity
AgentReady MCPDocs are re-indexed after each production build for MCP clients

Regenerating locally

cd website
npm run generate:api

The generator parses selected docs pages into src/data/catalog.json and static/api/v1/*. LLM files (llms.txt, llms-full.txt, per-page markdown) are produced during npm run build.