Snapps Blog API Documentation

1. Get All Blog Posts

GET /posts/{site_id}

• Path Params: site_id (required)

• Query Params:
• limit (optional, default: 100)
• offset (optional, default: 0)

{
  "data": {
    "results": [
      {
        "id": "abc123postid001",
        "title": "First Blog Title",
        "status": "PUBLISHED",
        "path": "first-blog-post",
        "creation_date": "2025-03-27T10:00:00",
        "publish_date": "2025-03-27T10:00:00",
        "thumbnail": {"url": "https://example.com/thumb.jpg"},
        "main_image": {"url": "https://example.com/main.jpg"}
      }
    ],
    "limit": 10,
    "offset": 0,
    "total_responses": 1
  }
}

2. Get Single Blog Post

GET /posts/{site_id}/{post_id}

• Path Params:
• site_id (required)
• post_id (required)

{
  "id": "abc123postid001",
  "title": "First Blog Title",
  "status": "PUBLISHED",
  "path": "first-blog-post",
  "creation_date": "2025-03-27T10:00:00",
  "publish_date": "2025-03-27T10:00:00",
  "thumbnail": {"url": "https://example.com/thumb.jpg"},
  "main_image": {"url": "https://example.com/main.jpg"}
}

3. Save Draft Blog Post

POST /posts/{site_id}/draft

• Path Params: site_id (required)

• Body Params:
• title (required)
• description (required)
• content (required)
• author (optional)
• thumbnail.url (optional)
• main_image.url (optional)

{
  "id": "draft123postid001",
  "title": "Updated - My Awesome Blog Post",
  "description": "This is a short summary of the post.",
  "author": "John Doe",
  "thumbnail": {"url": "https://example.com/thumb.jpg"},
  "main_image": {"url": "https://example.com/cover.jpg"}
}

4. Update Blog Post Meta

PATCH /posts/{site_id}/{post_id}

• Path Params:
• site_id (required)
• post_id (required)

• Body Params:
• title
• description
• meta_title
• author_name
• publish_date
• tags (array)
• no_index (boolean)

{
  "message": "Post updated successfully.",
  "site_id": "site987xyz",
  "post_id": "update123postid001"
}

5. Publish Blog Post

POST /posts/{site_id}/{post_id}/publish

• Path Params: site_id, post_id (both required)

{
  "message": "Post published successfully.",
  "site_id": "site987xyz",
  "post_id": "pub123postid001"
}

6. Unpublish Blog Post

POST /posts/{site_id}/{post_id}/unpublish

• Path Params: site_id, post_id (both required)

{
  "message": "Post unpublished successfully.",
  "site_id": "site987xyz",
  "post_id": "unpub123postid001"
}

7. Delete Blog Post

DELETE /posts/{site_id}/{post_id}

• Path Params: site_id, post_id (both required)

{
  "message": "Post deleted successfully.",
  "site_id": "site987xyz",
  "post_id": "del123postid001"
}

Notes

• Only the /draft endpoint accepts content.
• PATCH updates metadata only.
• All responses are JSON.
• All routes are protected using Api-Key.

Powered by Snapps — snapps.ai