Skip to main content
GET
/
v6
/
pages
/
{pageIdOrPathname}
Get Page
curl --request GET \
  --url https://api.makeswift.com/v6/pages/{pageIdOrPathname} \
  --header 'x-api-key: <api-key>'
{
  "object": "page",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pathname": "furniture",
  "canonicalUrl": "<unknown>",
  "title": "<unknown>",
  "description": "<unknown>",
  "socialImageUrl": "<unknown>",
  "sitemapPriority": "<unknown>",
  "sitemapFrequency": "always",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "publishedAt": "<unknown>",
  "isOnline": true,
  "excludedFromSearchEngines": "<unknown>",
  "localizations": [
    {
      "pathname": "<string>",
      "locale": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "locale": "<string>"
}

Authorizations

​
x-api-key
string
header
required

The App API key.

(e.g. sk_eczMHVBY9fV6GYFhvs53qcnxq7yptlXL3ABKOZtn6dQ)

Path Parameters

​
pageIdOrPathname
string
required

The page ID or pathname for the page you are requesting.

Minimum string length: 1

Query Parameters

​
siteId
string<uuid>

The site ID required when using a pathname instead of a page ID.

​
versionRef
enum<string>
default:ref:draft

The version reference to retrieve the page from. Defaults to ref:draft if not provided.

Supported formats:

  • ref:draft - Draft/working version
  • ref:live - Live/published version
Available options:
ref:live,
ref:draft
​
locale
string

The locale to retrieve the page in. If provided, localized page data is collapsed into the response.

Response

​
object
enum<string>
required
Available options:
page
Example:

"page"

​
id
string<uuid>
required

The ID of the page.

​
pathname
string
required

The page pathname.

Example:

"furniture"

​
canonicalUrl
null
required

The canonical URL of the page.

​
title
null
required

The page title.

​
description
null
required

The page description.

​
socialImageUrl
null
required

The social image URL of the page.

​
sitemapPriority
null
required

The sitemap priority.

​
sitemapFrequency
null
required

The sitemap update frequency.

Available options:
always,
hourly,
daily,
weekly,
monthly,
yearly,
never
​
createdAt
null
required

The page creation date and time.

​
updatedAt
null
required

The page last update date and time.

​
publishedAt
null
required

The page publication date and time.

​
isOnline
boolean
required

The flag that indicates whether the page is online.

​
excludedFromSearchEngines
null
required

The flag that indicates whether the page is excluded from search.

​
localizations
object[]
required

The localizations of the page.

​
locale
string

The page locale. This defaults to the default locale of the parent site.