Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Project516/BlogAPI/llms.txt

Use this file to discover all available pages before exploring further.

Blog API requires no API key or setup on your end — you can start making requests immediately. This quickstart walks you through three common operations: listing all posts, searching by keyword, and fetching the latest post.
All read endpoints are rate-limited to 5 requests per minute per IP address. Space out your requests if you are making multiple calls in quick succession.
1

List all blog posts

Call GET /blogs to retrieve the full list of cached blog posts. Each post includes a title, a link to the full post, and a publish date.
curl https://api.project516.dev/blogs
Example response:
[
  {
    "title": "Building a Static Blog with GitHub Pages",
    "link": "https://project516.dev/blog/static-blog",
    "date": "2024-03-10"
  },
  {
    "title": "Getting Started with FastAPI",
    "link": "https://project516.dev/blog/fastapi-intro",
    "date": "2024-01-15"
  }
]
2

Search for a post by title

Use GET /blogs/search?query=<keyword> to find posts whose titles contain your search term. The match is case-insensitive and checks for the substring anywhere in the title.
curl "https://api.project516.dev/blogs/search?query=fastapi"
Example response when posts are found:
[
  {
    "title": "Getting Started with FastAPI",
    "link": "https://project516.dev/blog/fastapi-intro",
    "date": "2024-01-15"
  }
]
If no posts match, the API returns:
{ "message": "Blog not found" }
3

Fetch the latest post

Call GET /blogs/latest to retrieve only the most recently published blog post. This is the first entry in the cache, which reflects publication order from the blog source.
curl https://api.project516.dev/blogs/latest
Example response:
{
  "title": "Building a Static Blog with GitHub Pages",
  "link": "https://project516.dev/blog/static-blog",
  "date": "2024-03-10"
}
If the cache is empty (before the first POST /blogs/cache call), this endpoint returns null.

​
Next steps

API Reference

Explore full endpoint documentation including all parameters, response shapes, and error codes.

Caching guide

Learn how to populate and refresh the blog cache using POST /blogs/cache.

Build docs developers (and LLMs) love

Get started for freeTalk to us