Content Pages

Special pages and flat pages

Retrieve special page

get

Returns special page data with product search results from the associated product collection. This endpoint integrates with the search/facet system.

Path parameters

special_page_idintegerRequired

Special page identifier

Query parameters

sorterstringOptional

Sort option for product results

Example: price_asc

Responses

200

Special page retrieved with product results

application/json

Response from special page endpoint. Contains special page data, paginated product results from the associated product collection, search facets, sorters, and pagination metadata. Products are extracted from the special page's product collection using the configured extraction strategy.

search_textstringOptional

Search query text

404

Special page not found or not active

get

/special-page/{special_page_id}/

HTTPcURLJavaScriptPython

GET /special-page/{special_page_id}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "special_page": {
    "pk": 1,
    "name": "Summer Sale",
    "url": "/summer-sale",
    "template": "list/index.html",
    "banner": "https://example.com",
    "banner_url": "https://example.com",
    "product_collection": 1,
    "banner_description": "text",
    "is_active": true,
    "created_date": "2026-03-06T22:23:24.018Z",
    "modified_date": "2026-03-06T22:23:24.018Z",
    "video_embedded_code": "text",
    "specialpageprettyurl_set": [
      {
        "pk": 1,
        "url": "text",
        "language": "text"
      }
    ],
    "pretty_url": {
      "url": "text"
    },
    "extraction_strategy": "text",
    "banner_mobile": "https://example.com"
  },
  "pagination": {
    "current_page": 1,
    "num_pages": 5,
    "page_size": 20,
    "total_count": 100
  },
  "facets": [
    {
      "name": "text",
      "key": "text",
      "search_key": "text",
      "widget_type": "text",
      "order": 1,
      "extra_params": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "sorters": [
    {
      "label": "text",
      "value": "text",
      "is_selected": true
    }
  ],
  "search_text": "text",
  "products": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

Retrieve flat page

get

Returns flat page content. Can return HTML or JSON format based on Accept header. Flat pages may require registration depending on configuration.

Path parameters

flat_page_idintegerRequired

Flat page identifier

Responses

200

Flat page retrieved

text/htmlapplication/json

stringOptional

Rendered HTML content

404

Flat page not found

get

/flat-page/{flat_page_id}/

HTTPcURLJavaScriptPython

GET /flat-page/{flat_page_id}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

text

Retrieve shop flat page

get

Returns shop-specific flat page data with type and configuration.

Path parameters

shop_flat_page_idintegerRequired

Shop flat page identifier

Responses

200

Shop flat page retrieved

application/json

Shop-specific flat page with type and configuration. Extends the base flat page with shop-specific attributes, type classification, and configuration. Supports multi-language pretty URLs.

pkintegerRequiredExample: 5

typestringRequired

Shop flat page type

Example: standard

404

Shop flat page not found

get

/shop-flat-page/{shop_flat_page_id}/

HTTPcURLJavaScriptPython

GET /shop-flat-page/{shop_flat_page_id}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "pk": 5,
  "flat_page": {
    "pk": 10,
    "url": "/about-us/",
    "title": "About Us",
    "content": "<h1>About Us</h1><p>Welcome to our store...</p>",
    "template_name": "flatpages/default.html",
    "registration_required": false,
    "sites": [
      1
    ],
    "flatpageprettyurl_set": [
      {
        "pk": 1,
        "url": "text",
        "language": "text"
      }
    ],
    "type": "standard"
  },
  "type": "standard"
}