### User Posts Response Structure

Source: https://share.toopost.us/llms.txt

Example JSON response structure for the GET /api/user/posts endpoint. It includes success status, post data with details like ID, title, content, timestamps, engagement metrics, tags, status, and pagination information.

```json
{
  "success": true,
  "data": [
    {
      "id": "post-123",
      "title": "My First Post",
      "content": "This is the post content...",
      "createdAt": "2026-03-01T10:30:00Z",
      "updatedAt": "2026-03-01T10:30:00Z",
      "views": 245,
      "likes": 42,
      "shares": 8,
      "tags": ["tech", "api"],
      "status": "published"
    },
    {
      "id": "post-124",
      "title": "Second Post",
      "content": "More content here...",
      "createdAt": "2026-02-28T14:15:00Z",
      "updatedAt": "2026-02-28T14:15:00Z",
      "views": 189,
      "likes": 31,
      "shares": 5,
      "tags": ["tutorial"],
      "status": "published"
    }
  ],
  "pagination": {
    "total": 125,
    "page": 1,
    "limit": 20,
    "hasMore": true
  }
}
```

--------------------------------

### API Error Response Example

Source: https://share.toopost.us/llms.txt

Illustrates the standard JSON structure for API error responses. Includes an error message, an error code, and optional details.

```json
{
  "error": "Error message",
  "code": "ERROR_CODE",
  "details": {}
}
```

--------------------------------

### Get Article by ID

Source: https://share.toopost.us/llms.txt

Retrieves complete article information using its unique identifier.

```APIDOC
## GET /api/user/articles/{id}

### Description
Get complete article information by ID.

### Method
GET

### Endpoint
/api/user/articles/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - Article ID

### Request Example
```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/articles/article-456
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains the article details.
  - **id** (string) - The unique identifier of the article.
  - **title** (string) - The title of the article.
  - **slug** (string) - A URL-friendly version of the title.
  - **content** (string) - The full content of the article in markdown format.
  - **description** (string) - A brief description or abstract of the article.
  - **author** (object) - Information about the article's author.
    - **id** (string) - The author's unique identifier.
    - **name** (string) - The author's name.
    - **avatar** (string) - The URL of the author's avatar.
  - **createdAt** (string) - The timestamp when the article was created (ISO 8601 format).
  - **updatedAt** (string) - The timestamp when the article was last updated (ISO 8601 format).
  - **publishedAt** (string) - The timestamp when the article was published (ISO 8601 format).
  - **status** (string) - The publication status of the article (e.g., 'published').
  - **visibility** (string) - The visibility setting of the article (e.g., 'public').
  - **tags** (array of strings) - An array of tags associated with the article.
  - **category** (string) - The category the article belongs to.
  - **readTime** (integer) - Estimated reading time in minutes.
  - **views** (integer) - The number of views the article has received.
  - **likes** (integer) - The number of likes the article has received.
  - **comments** (integer) - The number of comments on the article.
  - **versions** (array of objects) - A history of article versions.
    - **version** (integer) - The version number.
    - **createdAt** (string) - The timestamp when this version was created (ISO 8601 format).
    - **changes** (string) - A description of the changes made in this version.

#### Response Example
```json
{
  "success": true,
  "data": {
    "id": "article-456",
    "title": "API Integration Guide",
    "slug": "api-integration-guide",
    "content": "# API Integration Guide\n\nThis guide covers...",
    "description": "A comprehensive guide to integrating third-party APIs",
    "author": {
      "id": "user-123",
      "name": "Andrew Brown",
      "avatar": "https://example.com/avatar.jpg"
    },
    "createdAt": "2026-02-15T10:00:00Z",
    "updatedAt": "2026-03-01T14:20:00Z",
    "publishedAt": "2026-02-15T11:30:00Z",
    "status": "published",
    "visibility": "public",
    "tags": ["api", "integration", "guide"],
    "category": "Technical",
    "readTime": 12,
    "views": 3420,
    "likes": 287,
    "comments": 45,
    "versions": [
      {
        "version": 3,
        "createdAt": "2026-03-01T14:20:00Z",
        "changes": "Added examples section"
      },
      {
        "version": 2,
        "createdAt": "2026-02-28T09:15:00Z",
        "changes": "Fixed typos and formatting"
      },
      {
        "version": 1,
        "createdAt": "2026-02-15T10:00:00Z",
        "changes": "Initial version"
      }
    ]
  }
}
```
```

--------------------------------

### Retrieve User Posts (API Endpoint)

Source: https://share.toopost.us/llms.txt

Shows how to fetch all user posts using the GET /api/user/posts endpoint. This requires premium or MCP access and uses the Authorization header for authentication.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/posts
```

--------------------------------

### GET /api/user/info

Source: https://share.toopost.us/llms.txt

Retrieves the current authenticated user's account information, including profile details, subscription status, and settings.

```APIDOC
## GET /api/user/info

### Description
Retrieves the current authenticated user's account information, including profile details, subscription status, and settings.

### Method
GET

### Endpoint
/api/user/info

### Parameters
No parameters required.

### Response
#### Success Response (200 OK)
- **success** (boolean) - Indicates if the operation was successful.
- **data** (object) - Contains the user's profile details.
  - **id** (string) - The user's unique identifier.
  - **username** (string) - The user's username.
  - **email** (string) - The user's email address.
  - **displayName** (string) - The user's display name.
  - **avatar** (string) - URL to the user's avatar image.
  - **bio** (string) - A short biography of the user.
  - **subscription** (object) - Details about the user's subscription.
    - **tier** (string) - The subscription tier (e.g., 'free', 'premium').
    - **status** (string) - The status of the subscription (e.g., 'active', 'canceled').
    - **startDate** (string) - The start date of the subscription.
    - **renewalDate** (string) - The renewal date of the subscription.
    - **features** (array of strings) - A list of features included in the subscription.
  - **followers** (integer) - The number of followers the user has.
  - **following** (integer) - The number of users the user is following.
  - **joinedAt** (string) - The timestamp when the user joined.
  - **timezone** (string) - The user's preferred timezone.
  - **language** (string) - The user's preferred language.

#### Response Example
```json
{
  "success": true,
  "data": {
    "id": "user-123",
    "username": "andrew_brown",
    "email": "andrew@example.com",
    "displayName": "Andrew Brown",
    "avatar": "https://example.com/avatars/123.jpg",
    "bio": "Developer and content creator",
    "subscription": {
      "tier": "premium",
      "status": "active",
      "startDate": "2025-12-15T00:00:00Z",
      "renewalDate": "2026-12-15T00:00:00Z",
      "features": ["mcp-access", "unlimited-articles", "api-access", "priority-support"]
    },
    "followers": 2450,
    "following": 890,
    "joinedAt": "2024-01-10T00:00:00Z",
    "timezone": "UTC",
    "language": "en"
  }
}
```
```

--------------------------------

### Get User Stats - GET /api/user/stats

Source: https://share.toopost.us/llms.txt

Fetches statistics for the user's account. This includes post counts, engagement metrics, reading statistics, and quota usage. Requires an Authorization header with a Bearer token.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/stats
```

--------------------------------

### Get Complete Article by ID (Bash)

Source: https://share.toopost.us/llms.txt

Retrieves the full details of an article using its unique ID. The response includes the article's content, metadata, author information, and version history. Authentication is required.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/articles/article-456
```

--------------------------------

### Get User Subscribed Feeds (Bash)

Source: https://share.toopost.us/llms.txt

Fetches a list of all feeds subscribed to by the user. The response contains metadata for each feed, such as title, URL, and unread counts. Authentication is required.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/feeds
```

--------------------------------

### GET /api/user/stats

Source: https://share.toopost.us/llms.txt

Retrieves statistics related to the user's account, including post counts, engagement metrics, and usage data.

```APIDOC
## GET /api/user/stats

### Description
Retrieves statistics related to the user's account, including post counts, engagement metrics, and usage data.

### Method
GET

### Endpoint
/api/user/stats

### Parameters
No parameters required.

### Response
#### Success Response (200 OK)
- **success** (boolean) - Indicates if the operation was successful.
- **data** (object) - Contains the user's statistics.
  - **totalPosts** (integer) - Total number of posts created by the user.
  - **totalArticles** (integer) - Total number of articles created by the user.
  - **totalSavedPosts** (integer) - Total number of posts saved by the user.
  - **totalLikedPosts** (integer) - Total number of posts liked by the user.
  - **totalFeeds** (integer) - Total number of feeds the user is following.
  - **engagement** (object) - Engagement metrics.
    - **totalViews** (integer) - Total views across all posts.
    - **totalLikes** (integer) - Total likes received across all posts.
    - **totalShares** (integer) - Total shares across all posts.
    - **totalComments** (integer) - Total comments received across all posts.
  - **readingStats** (object) - User's reading statistics.
    - **articlesRead** (integer) - Number of articles read.
    - **averageReadTime** (float) - Average time spent reading articles (in minutes).
    - **totalReadTime** (integer) - Total time spent reading articles (in minutes).
    - **lastArticleRead** (string) - Timestamp of the last article read.
  - **accountStats** (object) - Account-related statistics.
    - **createdAt** (string) - Timestamp when the account was created.
    - **lastLoginAt** (string) - Timestamp of the last login.
    - **loginStreak** (integer) - Current consecutive login streak.
  - **quotaUsage** (object) - Information about API quota usage.
    - **apiCallsThisMonth** (integer) - Number of API calls made this month.
    - **apiCallsLimit** (integer) - The monthly limit for API calls.
    - **storageUsedMB** (integer) - Storage used in megabytes.
    - **storageLimit** (integer) - The storage limit in megabytes.

#### Response Example
```json
{
  "success": true,
  "data": {
    "totalPosts": 125,
    "totalArticles": 42,
    "totalSavedPosts": 342,
    "totalLikedPosts": 156,
    "totalFeeds": 87,
    "engagement": {
      "totalViews": 45230,
      "totalLikes": 3420,
      "totalShares": 1240,
      "totalComments": 2890
    },
    "readingStats": {
      "articlesRead": 234,
      "averageReadTime": 8.5,
      "totalReadTime": 1995,
      "lastArticleRead": "2026-03-03T08:20:00Z"
    },
    "accountStats": {
      "createdAt": "2024-01-10T00:00:00Z",
      "lastLoginAt": "2026-03-03T10:15:00Z",
      "loginStreak": 23
    },
    "quotaUsage": {
      "apiCallsThisMonth": 4250,
      "apiCallsLimit": 10000,
      "storageUsedMB": 245,
      "storageLimit": 1000
    }
  }
}
```
```

--------------------------------

### Get User Liked Posts (Bash)

Source: https://share.toopost.us/llms.txt

Fetches a list of all posts that the user has liked. The response contains information about the liked posts, including title, author, and engagement metrics like likes and comments. Pagination is included.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/liked-posts
```

--------------------------------

### Get Specific Post by ID

Source: https://share.toopost.us/llms.txt

Retrieves a specific post using its unique identifier. Requires Premium or MCP access.

```APIDOC
## GET /api/user/posts/{id}

### Description
Get a specific post by ID.

### Method
GET

### Endpoint
/api/user/posts/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - Post ID

### Request Example
```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/posts/post-123
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains the post details.
  - **id** (string) - The unique identifier of the post.
  - **title** (string) - The title of the post.
  - **content** (string) - The full content of the post in markdown format.
  - **htmlContent** (string) - The content of the post rendered as HTML.
  - **createdAt** (string) - The timestamp when the post was created (ISO 8601 format).
  - **updatedAt** (string) - The timestamp when the post was last updated (ISO 8601 format).
  - **authorId** (string) - The ID of the post's author.
  - **views** (integer) - The number of views the post has received.
  - **likes** (integer) - The number of likes the post has received.
  - **shares** (integer) - The number of times the post has been shared.
  - **comments** (integer) - The number of comments on the post.
  - **tags** (array of strings) - An array of tags associated with the post.
  - **status** (string) - The publication status of the post (e.g., 'published').
  - **language** (string) - The language of the post.
  - **readTime** (integer) - Estimated reading time in minutes.
  - **featured** (boolean) - Indicates if the post is featured.

#### Response Example
```json
{
  "success": true,
  "data": {
    "id": "post-123",
    "title": "My First Post",
    "content": "This is the detailed post content with full markdown support...",
    "htmlContent": "<p>This is the detailed post content...</p>",
    "createdAt": "2026-03-01T10:30:00Z",
    "updatedAt": "2026-03-01T10:30:00Z",
    "authorId": "user-456",
    "views": 245,
    "likes": 42,
    "shares": 8,
    "comments": 12,
    "tags": ["tech", "api"],
    "status": "published",
    "language": "en",
    "readTime": 5,
    "featured": false
  }
}
```
```

--------------------------------

### Get User Saved Posts (Bash)

Source: https://share.toopost.us/llms.txt

Retrieves a list of all posts that the user has saved. The response includes details like post ID, title, source, and when it was saved. Pagination information is also provided.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/saved-posts
```

--------------------------------

### Get Specific Post by ID (Bash)

Source: https://share.toopost.us/llms.txt

Retrieves details for a specific user post using its unique ID. Requires Premium or MCP access. The response includes comprehensive post data.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/posts/post-123
```

--------------------------------

### API Authentication: Query Parameter

Source: https://share.toopost.us/llms.txt

Illustrates API request authentication using the 'token=YOUR_API_TOKEN' query parameter. While functional, the Authorization header is preferred for security reasons.

```bash
curl "https://go.toopost.us/api/user/info?token=YOUR_API_TOKEN"
```

--------------------------------

### Create Article - POST /api/user/articles

Source: https://share.toopost.us/llms.txt

Creates a new article. Requires a JSON request body with title, content, tags, description, category, and visibility. Returns the created article with an ID.

```bash
curl -X POST \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Article",
    "content": "Article body here",
    "tags": ["tech", "api"]
  }' \
  https://go.toopost.us/api/user/articles
```

--------------------------------

### API Authentication: Authorization Header

Source: https://share.toopost.us/llms.txt

Demonstrates how to authenticate API requests using the 'Authorization: Bearer YOUR_API_TOKEN' header. This is the recommended method for securing API access.

```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/info
```

--------------------------------

### Create New Article Version - POST /api/user/articles/{articleId}/versions

Source: https://share.toopost.us/llms.txt

Creates a new version for an existing article. Requires the articleId in the URL and a JSON request body containing updated content, optional title, tags, and a description of changes. Returns new version details.

```bash
curl -X POST \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Updated content here",
    "changes": "Added new examples"
  }' \
  https://go.toopost.us/api/user/articles/article-456/versions
```

--------------------------------

### POST /api/user/articles

Source: https://share.toopost.us/llms.txt

Creates a new article for the authenticated user. You can specify the title, content, tags, description, category, and visibility.

```APIDOC
## POST /api/user/articles

### Description
Creates a new article for the authenticated user. You can specify the title, content, tags, description, category, and visibility.

### Method
POST

### Endpoint
/api/user/articles

### Parameters
#### Request Body
- **title** (string) - Required - The title of the article.
- **content** (string) - Required - The main content of the article, can be in markdown or HTML format.
- **tags** (array of strings) - Optional - A list of tags to associate with the article.
- **description** (string) - Optional - A brief description or summary of the article.
- **category** (string) - Optional - The category to which the article belongs.
- **visibility** (string) - Optional - The visibility setting for the article (e.g., 'public', 'private'). Defaults to 'public'.

### Request Example
```json
{
  "title": "Article Title",
  "content": "Article content in markdown or HTML",
  "tags": ["tag1", "tag2"],
  "description": "Brief description",
  "category": "Tech",
  "visibility": "public"
}
```

### Response
#### Success Response (201 Created)
- **success** (boolean) - Indicates if the operation was successful.
- **data** (object) - Contains the details of the newly created article.
  - **id** (string) - The unique identifier for the article.
  - **title** (string) - The title of the article.
  - **slug** (string) - A URL-friendly version of the article title.
  - **content** (string) - The content of the article.
  - **description** (string) - The description of the article.
  - **status** (string) - The current status of the article (e.g., 'draft', 'published').
  - **visibility** (string) - The visibility setting of the article.
  - **tags** (array of strings) - The tags associated with the article.
  - **createdAt** (string) - The timestamp when the article was created.
  - **updatedAt** (string) - The timestamp when the article was last updated.
  - **version** (integer) - The current version number of the article.

#### Response Example
```json
{
  "success": true,
  "data": {
    "id": "article-999",
    "title": "My Article",
    "slug": "my-article",
    "content": "Article body here",
    "description": "",
    "status": "draft",
    "visibility": "draft",
    "tags": ["tech", "api"],
    "createdAt": "2026-03-03T10:30:00Z",
    "updatedAt": "2026-03-03T10:30:00Z",
    "version": 1
  }
}
```
```

--------------------------------

### POST /api/user/articles/{articleId}/versions

Source: https://share.toopost.us/llms.txt

Creates a new version of an existing article. This is useful for updating content and tracking changes.

```APIDOC
## POST /api/user/articles/{articleId}/versions

### Description
Creates a new version of an existing article. This is useful for updating content and tracking changes.

### Method
POST

### Endpoint
/api/user/articles/{articleId}/versions

### Parameters
#### Path Parameters
- **articleId** (string) - Required - The ID of the article to create a new version for.

#### Request Body
- **content** (string) - Required - The updated content for the new version.
- **title** (string) - Optional - The updated title for the new version.
- **tags** (array of strings) - Optional - A list of tags for the new version.
- **changes** (string) - Optional - A brief description of the changes made in this version.

### Request Example
```json
{
  "content": "Updated content here",
  "changes": "Added new examples"
}
```

### Response
#### Success Response (201 Created)
- **success** (boolean) - Indicates if the operation was successful.
- **data** (object) - Contains the details of the newly created article version.
  - **id** (string) - The ID of the article.
  - **title** (string) - The title of the article.
  - **version** (integer) - The new version number.
  - **content** (string) - The content of the new version.
  - **changes** (string) - The description of changes for this version.
  - **createdAt** (string) - The timestamp when the new version was created.
  - **previousVersion** (integer) - The version number of the previous version.
  - **status** (string) - The status of the article (e.g., 'published').

#### Response Example
```json
{
  "success": true,
  "data": {
    "id": "article-456",
    "title": "API Integration Guide",
    "version": 4,
    "content": "Updated content here",
    "changes": "Added new examples",
    "createdAt": "2026-03-03T11:45:00Z",
    "previousVersion": 3,
    "status": "published"
  }
}
```
```

--------------------------------

### User Posts API

Source: https://share.toopost.us/llms.txt

Retrieve all user posts. This endpoint requires Premium or MCP access and authentication via API token.

```APIDOC
## GET /api/user/posts

### Description
Retrieves a list of all posts created by the user. This endpoint is available for users with Premium or MCP access.

### Method
GET

### Endpoint
https://go.toopost.us/api/user/posts

### Parameters
#### Query Parameters
- **token** (string) - Optional - Your API token. If not provided in the Authorization header.

#### Request Body
None

### Request Example
```bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://go.toopost.us/api/user/posts
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (array) - A list of user post objects.
  - **id** (string) - Unique identifier for the post.
  - **title** (string) - The title of the post.
  - **content** (string) - The main content of the post.
  - **createdAt** (string) - Timestamp when the post was created (ISO 8601 format).
  - **updatedAt** (string) - Timestamp when the post was last updated (ISO 8601 format).
  - **views** (integer) - Number of views the post has received.
  - **likes** (integer) - Number of likes the post has received.
  - **shares** (integer) - Number of times the post has been shared.
  - **tags** (array of strings) - List of tags associated with the post.
  - **status** (string) - The current status of the post (e.g., 'published').
- **pagination** (object) - Pagination details for the response.
  - **total** (integer) - Total number of posts available.
  - **page** (integer) - The current page number.
  - **limit** (integer) - The number of posts per page.
  - **hasMore** (boolean) - Indicates if there are more pages of results.

#### Response Example
```json
{
  "success": true,
  "data": [
    {
      "id": "post-123",
      "title": "My First Post",
      "content": "This is the post content...",
      "createdAt": "2026-03-01T10:30:00Z",
      "updatedAt": "2026-03-01T10:30:00Z",
      "views": 245,
      "likes": 42,
      "shares": 8,
      "tags": ["tech", "api"],
      "status": "published"
    },
    {
      "id": "post-124",
      "title": "Second Post",
      "content": "More content here...",
      "createdAt": "2026-02-28T14:15:00Z",
      "updatedAt": "2026-02-28T14:15:00Z",
      "views": 189,
      "likes": 31,
      "shares": 5,
      "tags": ["tutorial"],
      "status": "published"
    }
  ],
  "pagination": {
    "total": 125,
    "page": 1,
    "limit": 20,
    "hasMore": true
  }
}
```
```

--------------------------------

### User Feeds API

Source: https://share.toopost.us/llms.txt

Retrieves a list of all feeds subscribed to by the user.

```APIDOC
## GET /api/user/feeds

### Description
Get all user subscribed feeds.

### Method
GET

### Endpoint
/api/user/feeds

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (array of objects) - A list of user feeds.
  - **id** (string) - The unique identifier of the feed.
  - **title** (string) - The title of the feed.
  - **url** (string) - The URL of the feed.
  - **description** (string) - A description of the feed.
  - **category** (string) - The category the feed belongs to.
  - **lastUpdated** (string) - The timestamp of the last update (ISO 8601 format).
  - **itemCount** (integer) - The total number of items in the feed.
  - **unreadCount** (integer) - The number of unread items in the feed.
  - **language** (string) - The language of the feed content.
  - **subscriptionsCount** (integer) - The number of users subscribed to this feed.
- **pagination** (object) - Pagination details for the response.
  - **total** (integer) - The total number of feeds available.
  - **page** (integer) - The current page number.
  - **limit** (integer) - The number of feeds per page.

#### Response Example
```json
{
  "success": true,
  "data": [
    {
      "id": "feed-001",
      "title": "TechCrunch",
      "url": "https://techcrunch.com/feed/",
      "description": "Technology news and analysis",
      "category": "Technology",
      "lastUpdated": "2026-03-03T08:45:00Z",
      "itemCount": 2847,
      "unreadCount": 23,
      "language": "en",
      "subscriptionsCount": 12500
    },
    {
      "id": "feed-002",
      "title": "Hacker News",
      "url": "https://news.ycombinator.com/rss",
      "description": "The latest and greatest news in technology and startups",
      "category": "Startups",
      "lastUpdated": "2026-03-03T09:12:00Z",
      "itemCount": 1523,
      "unreadCount": 45,
      "language": "en",
      "subscriptionsCount": 8900
    }
  ],
  "pagination": {
    "total": 87,
    "page": 1,
    "limit": 50
  }
}
```
```

--------------------------------

### Liked Posts API

Source: https://share.toopost.us/llms.txt

Retrieves a list of all posts that the user has liked.

```APIDOC
## GET /api/user/liked-posts

### Description
Get all liked posts.

### Method
GET

### Endpoint
/api/user/liked-posts

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (array of objects) - A list of liked posts.
  - **id** (string) - The unique identifier for the liked item.
  - **postId** (string) - The ID of the liked post.
  - **title** (string) - The title of the liked post.
  - **author** (string) - The author of the liked post.
  - **source** (string) - The source where the post originated.
  - **likedAt** (string) - The timestamp when the post was liked (ISO 8601 format).
  - **content** (string) - A snippet or summary of the post content.
  - **likes** (integer) - The number of likes the post has.
  - **comments** (integer) - The number of comments on the post.
- **pagination** (object) - Pagination details for the response.
  - **total** (integer) - The total number of liked posts.
  - **page** (integer) - The current page number.
  - **limit** (integer) - The number of liked posts per page.
  - **hasMore** (boolean) - Indicates if there are more liked posts available.

#### Response Example
```json
{
  "success": true,
  "data": [
    {
      "id": "liked-001",
      "postId": "post-789",
      "title": "Best JavaScript Tips",
      "author": "Jane Smith",
      "source": "Dev.to",
      "likedAt": "2026-03-01T12:30:00Z",
      "content": "10 amazing JavaScript tips you didn't know...",
      "likes": 1250,
      "comments": 89
    }
  ],
  "pagination": {
    "total": 156,
    "page": 1,
    "limit": 20,
    "hasMore": true
  }
}
```
```

--------------------------------

### Saved Posts API

Source: https://share.toopost.us/llms.txt

Retrieves a list of all posts that the user has saved.

```APIDOC
## GET /api/user/saved-posts

### Description
Get all saved posts.

### Method
GET

### Endpoint
/api/user/saved-posts

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (array of objects) - A list of saved posts.
  - **id** (string) - The unique identifier for the saved item.
  - **postId** (string) - The ID of the saved post.
  - **title** (string) - The title of the saved post.
  - **source** (string) - The source where the post originated.
  - **author** (string) - The author of the saved post.
  - **url** (string) - The URL of the saved post.
  - **savedAt** (string) - The timestamp when the post was saved (ISO 8601 format).
  - **readingStatus** (string) - The reading status of the post (e.g., 'unread').
  - **folder** (string) - The folder where the post is saved.
  - **summary** (string) - A brief summary of the saved post.
- **pagination** (object) - Pagination details for the response.
  - **total** (integer) - The total number of saved posts.
  - **page** (integer) - The current page number.
  - **limit** (integer) - The number of saved posts per page.
  - **hasMore** (boolean) - Indicates if there are more saved posts available.

#### Response Example
```json
{
  "success": true,
  "data": [
    {
      "id": "saved-001",
      "postId": "post-456",
      "title": "Understanding REST APIs",
      "source": "TechCrunch",
      "author": "John Doe",
      "url": "https://example.com/article/rest-apis",
      "savedAt": "2026-03-02T15:20:00Z",
      "readingStatus": "unread",
      "folder": "Learning",
      "summary": "A comprehensive guide to building REST APIs..."
    }
  ],
  "pagination": {
    "total": 342,
    "page": 1,
    "limit": 20,
    "hasMore": true
  }
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.