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.

The GET /blogs/search endpoint filters the in-memory cache by title and returns every post whose title contains the provided query string. The match is case-insensitive and matches anywhere within the title, so a query of fast would match "Getting Started with FastAPI". If no posts match, the endpoint returns a JSON object with a "Blog not found" message instead of an empty array.

​
Endpoint

GET /blogs/search

​
Rate limit

5 requests per minute per IP address. Exceeding this limit returns a 429 Too Many Requests response.

​
Query parameters

​
query
string
required
The search term to match against blog post titles. The match is case-insensitive and checks whether the query appears anywhere in the title.

​
Response

On a successful match, the response is a JSON array of blog post objects. When no posts match, the response is a JSON object with a message field.
​
title
string
The title of the blog post as it appears on project516.dev.
​
link
string
The full URL to the blog post on project516.dev (e.g., https://project516.dev/blog/some-post).
​
date
string
The publish date of the post in ISO 8601 format (e.g., 2024-11-03).

​
Code examples

curl "https://api.project516.dev/blogs/search?query=fastapi"

​
Example responses

Matching results: 
[
  {
    "title": "Getting Started with FastAPI",
    "link": "https://project516.dev/blog/getting-started-with-fastapi",
    "date": "2024-09-15"
  }
]
No matching results: 
{
  "message": "Blog not found"
}
Search is case-insensitive and matches the query string anywhere within the title. For example, scrape, Scrape, and SCRAPE all return the same results.

​
Error codes

StatusDescription
429 Too Many RequestsYou have exceeded the rate limit of 5 requests per minute. Wait before retrying.

Build docs developers (and LLMs) love

Get started for freeTalk to us