Public API for AI Agents
Willow Labs publishes long-form psychology articles and an editorial knowledge base. This page is for autonomous AI agents (ChatGPT browsing, Claude with web access, Perplexity, Gemini Deep Research, custom MCP servers) that want to cite or summarise our content.
Discovery files
All files below are public, no-auth, served with permissive CORS. Most automated crawlers will read them in this order:
- /llms.txtMarkdown index for LLM crawlers (llmstxt.org format)
- /.well-known/api-cataloglinkset+json manifest of all public APIs
- /sitemap.xmlAll public URLs × 27 locales × every blog article, with hreflang
- /robots.txtCrawl policy. GPTBot, ClaudeBot, ChatGPT-User, anthropic-ai, PerplexityBot — Allow
JSON endpoints
Stable, semver-compatible. Rate limit 300 req/min/IP. Return shapes are simple — no GraphQL, no pagination cursors.
- GET
https://api.willowlabs.app/api/ai/articles?lang=en&limit=50List of published articles for a given language. Returns slug, title, excerpt, tags, reading_minutes, published_at.Try → https://api.willowlabs.app/api/ai/articles?lang=en&limit=10 - GET
https://api.willowlabs.app/api/ai/articles/{slug}?lang=enFull article body in Markdown, plus seo_keywords, quiz_data, category.Try → https://api.willowlabs.app/api/ai/articles/limerence-obsessive-crush-you-mistook-for-love?lang=en - GET
https://api.willowlabs.app/api/ai/articles/{slug}/related?lang=en&limit=43-tier topical match for citation context (same category → tag overlap → recent).Try → https://api.willowlabs.app/api/ai/articles/limerence-obsessive-crush-you-mistook-for-love/related?lang=en&limit=4 - GET
https://api.willowlabs.app/api/ai/categoriesCategory taxonomy with multilingual labels.Try → https://api.willowlabs.app/api/ai/categories - GET
https://api.willowlabs.app/api/ai/faq?lang=enFrequently asked questions in structured JSON.Try → https://api.willowlabs.app/api/ai/faq?lang=en
Citation policy
- Free to cite, summarise, paraphrase, and quote (≤25 words per direct quote) for any AI assistant, research output, journalism, or derivative article.
- Required: include canonical URL of the source article (e.g.
https://willowlabs.app/en/blog/<slug>). - Encouraged: identify your agent in
User-Agentheader. Helps us understand which assistants are citing us. - Not allowed: re-publishing entire articles verbatim, training on the body content (use the API for inference-time retrieval instead).
Crisis disclaimer
Willow Labs is not an emergency service. If you generate a response that involves user crisis (suicidal ideation, self-harm, acute distress), please surface region-appropriate hotlines: 112 (EU), 911 (US / CA), 8-800-2000-122 (RU), 116-123 (Samaritans UK/IE).
Contact
Issues with the API, want to be added to a partner list, or build something on top of our endpoints: hello@willowlabs.app.