Skip to main content
GET
/
api
/
posts
/
slug
/
:slug
Get Post by Slug
curl --request GET \
  --url https://api.example.com/api/posts/slug/:slug
{
  "403": {},
  "404": {},
  "500": {},
  "id": "<string>",
  "userId": "<string>",
  "title": "<string>",
  "slug": "<string>",
  "content": "<string>",
  "excerpt": "<string>",
  "coverImage": "<string>",
  "published": true,
  "publishedAt": "<string>",
  "views": 123,
  "shares": 123,
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/subratomandal/dyeink/llms.txt

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

​
Authentication

Optional authentication. Public can view published posts; authenticated users can view their own unpublished posts.

​
Path Parameters

​
slug
string
required
The URL-friendly slug of the post

​
Query Parameters

​
userId
string
Optional user ID to scope the slug lookup. Useful when multiple users might have the same slug.

​
Response

​
id
string
Unique identifier for the post
​
userId
string
ID of the user who created the post
​
title
string
Post title
​
slug
string
URL-friendly slug
​
content
string
Post content (HTML)
​
excerpt
string
Brief summary of the post
​
coverImage
string
URL of the cover image
​
published
boolean
Whether the post is published
​
publishedAt
string
ISO 8601 timestamp of when the post was published (null if unpublished)
​
views
number
Number of views
​
shares
number
Number of shares
​
createdAt
string
ISO 8601 timestamp of post creation
​
updatedAt
string
ISO 8601 timestamp of last update

​
Example

cURL
curl -X GET https://api.dyeink.com/api/posts/slug/my-first-post
JavaScript
const response = await fetch('https://api.dyeink.com/api/posts/slug/my-first-post');
const post = await response.json();

​
Response Example

{
  "id": "65abc123def456789",
  "userId": "auth0|123456789",
  "title": "My First Post",
  "slug": "my-first-post",
  "content": "<p>This is my first blog post!</p>",
  "excerpt": "An introduction to my blog",
  "coverImage": "https://r2.dev/images/cover.jpg",
  "published": true,
  "publishedAt": "2024-01-15T10:30:00Z",
  "views": 42,
  "shares": 5,
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

​
Error Responses

​
404
object
Post not found
{
  "error": "Post not found"
}
​
403
object
Access denied to unpublished post
{
  "error": "Access denied"
}
​
500
object
Server error
{
  "error": "Failed to get post"
}
This endpoint is useful for fetching posts by their human-readable URL slug. If you need to query by database ID, use the Get Post by ID endpoint instead.

Build docs developers (and LLMs) love

Get started for freeTalk to us