API Developer Guide

Returns service status. Use this before any write operation to confirm the API is reachable.

curl -s "https://powerdigital.sg/api/v1/health/"

{
  "status":  "ok",
  "service": "powerdigital-api",
  "version": "1.0"
}

List published articles. Use query params to filter.

curl -s "https://powerdigital.sg/api/v1/articles/?status=all&limit=10&include_content=1"

Fetch a single article by slug. Always includes full content.

curl -s "https://powerdigital.sg/api/v1/articles/my-article-slug/"

Create a new article. title is the only required field. Slug is auto-generated from title if omitted. Tags are auto-created if they don't exist. Image URLs are fetched and saved locally.

{
  "title":               "How to rank on Google in Singapore",  // required
  "slug":                "rank-on-google-singapore",            // optional — auto from title
  "content":             "<h2>Section Heading</h2><p>Body paragraph.</p>",  // HTML only — no Markdown
  "excerpt":             "Short summary shown in listings.",
  "status":              "published",                           // draft | published | archived
  "is_featured":         false,
  "published_at":        "2026-06-21T00:00:00Z",               // ISO 8601 — defaults to now if published
  "categories":          ["seo", "digital-marketing"],            // category slugs (must exist)
  "tags":                ["seo", "google-ranking", "singapore"],   // tag slugs — auto-created
  "meta_title":          "Rank on Google Singapore | Power Digital",
  "meta_description":    "Learn how to rank #1 on Google...",
  "meta_keywords":       ["seo singapore", "google ranking"],
  "og_title":            "Rank on Google Singapore",
  "og_description":      "Our proven SEO framework...",
  "featured_image_url":  "https://example.com/image.jpg",      // fetched + saved locally
  "long_image_url":      "https://example.com/long.jpg",
  "og_image_url":        "https://example.com/og.jpg"
}

curl -s -u "seo-agent:<password>" \
  -X POST "https://powerdigital.sg/api/v1/articles/" \
  -H "Content-Type: application/json" \
  -d '{"title":"My Article","status":"published","tags":["seo"]}'

Returns 201 with the full article object including its id (UUID). Save this for PATCH/DELETE.

Partial update — only send the fields you want to change. Use the id UUID from the create response.

ARTICLE_ID="839fd4bd-36d3-4b5a-aee8-a389998f787f"

curl -s -u "seo-agent:<password>" \
  -X PATCH "https://powerdigital.sg/api/v1/articles/${ARTICLE_ID}/" \
  -H "Content-Type: application/json" \
  -d '{"status":"published","is_featured":true}'

Permanently delete an article. Returns {"deleted": true, "id": "..."}.

curl -s -u "seo-agent:<password>" \
  -X DELETE "https://powerdigital.sg/api/v1/articles/${ARTICLE_ID}/"

curl -s "https://powerdigital.sg/api/v1/categories/?parent=root"

Returns the category plus its children and a list of articles in that category.

curl -s "https://powerdigital.sg/api/v1/categories/seo/?article_limit=5"

{
  "name":                "SEO",                              // required
  "slug":                "seo",                              // optional — auto from name
  "description":         "Search engine optimisation articles.",
  "excerpt":             "Short listing summary.",
  "content":             "<p>Long HTML description.</p>",
  "parent":              "digital-marketing",               // parent category slug
  "featured_image_url":  "https://example.com/seo.jpg",     // fetched + saved locally
  "meta_title":          "SEO Articles | Power Digital",
  "meta_description":    "Expert SEO tips and strategies.",
  "meta_keywords":       ["seo", "search engine optimisation"]
}

curl -s -u "seo-agent:<password>" \
  -X POST "https://powerdigital.sg/api/v1/categories/" \
  -H "Content-Type: application/json" \
  -d '{"name":"SEO","description":"SEO articles"}'

Partial update. Same fields as POST, all optional. Use UUID from create response.

Delete a category. Articles in this category lose the category association (M2M).

Returns available time slots for a given date.

curl -s "https://powerdigital.sg/api/v1/bookings/available-slots/?date=2026-07-01"

{
  "full_name":  "Jane Smith",
  "email":      "jane@example.com",
  "phone":      "+65 9123 4567",
  "date":       "2026-07-01",
  "start_time": "10:00",
  "message":    "Looking for SEO services."
}

CMS pages. Params: status, search, limit, offset, include_content.

Single page with full block data.

All nav links ordered by display_order. Param: active=1 to filter active only.

curl -s "https://powerdigital.sg/api/v1/navigation/?active=1"

CMS content blocks. Params: type, active, include_data=1.

curl -s "https://powerdigital.sg/api/v1/blocks/?type=home_hero&include_data=1"

Generate SEO suggestions for a given content snippet.

{
  "content": "Your page content here..."
}