I’m always exploring ways to make content more accessible. This site has a new REST API plugin that delivers rich, structured metadata for my posts in a standardized format.
An API designed benmilne.com content
The API is intended to make machine-readable data about my posts available. The API returns information such as:
- Full Post Content: Clean, decoded, and formatted content ready for consumption.
- Media & Featured Images: URLs for featured images and other media.
- Extracted Links: Lists of links found in the post.
- Taxonomies: Categories and tags that help classify the content.
- Attribution: Clear instructions for citing benmilne.com as the source.
This structured approach makes it easy for large language models and other automated tools to understand the context of my posts and deliver rich summaries or integrated views. Hypothetically.
API Endpoints
The API has several endpoints, each serving a unique purpose:
1. Single Post Endpoint
https://benmilne.com/wp-json/mcp/v1/post/{id}- Usage: Retrieve detailed metadata for a specific post.
- Example:
https://benmilne.com/wp-json/mcp/v1/post/111693
This endpoint returns the full content (decoded and cleaned), media, links, taxonomies, structured sections (headings), relationships (previous and next posts), and an attribution notice.
2. Search Endpoint
https://benmilne.com/wp-json/mcp/v1/search?query=your_keyword- Usage: Retrieve up to 100 posts that match a given search query.
- Example:
https://benmilne.com/wp-json/mcp/v1/search?query=stablecoin
Ideal for integrating with search-based applications, this endpoint returns summary data along with key metadata for each matching post. Popular posts on this blog are stablecoin, brale, bitcoin, dwolla, and value layer.
3. List Posts Endpoint
https://benmilne.com/wp-json/mcp/v1/posts?per_page=10&page=1- Usage: Get a paginated list of posts along with their summaries and essential metadata.
- Example: https://benmilne.com/wp-json/mcp/v1/posts?per_page=10&page=1
This endpoint includes pagination navigation links (next_page_url and prev_page_url) to help external systems navigate through our posts.
4. Category & Tag Endpoints
https://benmilne.com/wp-json/mcp/v1/category/{category-slug}?per_page=10&page=1https://benmilne.com//wp-json/mcp/v1/tag/{tag-slug}?per_page=10&page=1- Category Example: https://benmilne.com/wp-json/mcp/v1/category/brale
- Tag Example:
https://benmilne.com/wp-json/mcp/v1/tag/stablecoin
These endpoints allow you or a random computer to filter posts by a specific category or tag, respectively. They support pagination and return the rich metadata used throughout the API.
How to Use the API
For Developers
It’s as simple as making a GET request to the endpoints shown above. The responses are formatted in JSON and include an attribution field at the top level—reminding consumers to cite this website when using the content.
You can also download the Open API Specification to use your favorite tools.
For AI Integrations
The rich, structured data provided by the API is designed for seamless integration with large language models and other AI tools. These systems can leverage the detailed metadata to better understand the context, structure, and source of our content, ensuring proper attribution and high-quality responses.
If you have feedback please DM me on X or somewhere else.