Get page schema markup

GET

https://api.webflow.com/beta/pages/:page_id/schema-markup

GET

/beta/pages/:page_id/schema-markup

$ curl -G https://api.webflow.com/beta/pages/63c720f9347c2139b248e552/schema-markup \
>      -H "Authorization: Bearer <token>" \
>      -d localeId=653fd9af6a07fc9cfd7a5e57

1 {
2   "id": "6596da6045e56dee495bcbba",
3   "siteId": "6258612d1ee792848f805dcf",
4   "localeId": "653fd9af6a07fc9cfd7a5e57",
5   "effectiveLocaleId": "653fd9af6a07fc9cfd7a5e57",
6   "publishedPath": "/guide-to-the-galaxy",
7   "lastUpdated": "2024-03-11T10:42:42.000Z",
8   "jsonLdSchema": {
9     "@context": "https://schema.org",
10     "@type": "FAQPage",
11     "mainEntity": [
12       {
13         "@type": "Question",
14         "name": "What is the answer to life, the universe, and everything?",
15         "acceptedAnswer": {
16           "@type": "Answer",
17           "text": "42"
18         }
19       }
20     ]
21   },
22   "rawJsonLdSchema": null,
23   "isInherited": false
24 }

Get the JSON-LD schema markup attached to a page.

When the requested localeId has no schema markup of its own, the primary locale’s schema markup is returned and isInherited is set to true.

Required scope | pages:read

Get page schema markup

GET

https://api.webflow.com/beta/pages/:page_id/schema-markup

GET

/beta/pages/:page_id/schema-markup

$ curl -G https://api.webflow.com/beta/pages/63c720f9347c2139b248e552/schema-markup \
>      -H "Authorization: Bearer <token>" \
>      -d localeId=653fd9af6a07fc9cfd7a5e57

1 {
2   "id": "6596da6045e56dee495bcbba",
3   "siteId": "6258612d1ee792848f805dcf",
4   "localeId": "653fd9af6a07fc9cfd7a5e57",
5   "effectiveLocaleId": "653fd9af6a07fc9cfd7a5e57",
6   "publishedPath": "/guide-to-the-galaxy",
7   "lastUpdated": "2024-03-11T10:42:42.000Z",
8   "jsonLdSchema": {
9     "@context": "https://schema.org",
10     "@type": "FAQPage",
11     "mainEntity": [
12       {
13         "@type": "Question",
14         "name": "What is the answer to life, the universe, and everything?",
15         "acceptedAnswer": {
16           "@type": "Answer",
17           "text": "42"
18         }
19       }
20     ]
21   },
22   "rawJsonLdSchema": null,
23   "isInherited": false
24 }

Get the JSON-LD schema markup attached to a page.

When the requested localeId has no schema markup of its own, the primary locale’s schema markup is returned and isInherited is set to true.

Required scope | pages:read

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

page_idstringRequiredformat: "objectid"

Unique identifier for a Page

Query parameters

localeIdstringOptionalformat: "objectid"

Unique identifier for a secondary locale. Omit this field to read schema markup for the primary locale.

Response

Request was successful

idstringformat: "objectid"

Unique identifier for the Page.

siteIdstringRead-onlyformat: "objectid"

Unique identifier for the Site that contains the Page.

localeIdstring or nullRead-onlyformat: "objectid"

Identifier of the locale the request targeted. Resolves to the site’s primary locale when no localeId was provided.

effectiveLocaleIdstring or nullRead-onlyformat: "objectid"

Identifier of the locale that contributed the returned schema markup. Differs from localeId when the requested locale has no override and the primary locale’s schema markup is returned as a fallback. Returns null when no schema markup exists for either the requested locale or the primary locale.

publishedPathstring or nullRead-only

Relative path of the published page URL.

lastUpdatedstring or nullRead-onlyformat: "date-time"

The date the Page was most recently updated.

jsonLdSchemamap from strings to any or null

Parsed JSON-LD schema markup for the page. Returns null when the page has no schema markup or when the stored value is a legacy multi-block format that can’t be parsed as a single JSON-LD object.

rawJsonLdSchemastring or null

Raw stored schema markup, including any surrounding <script type="application/ld+json"> tag. Populated only when the stored value can’t be represented as a single JSON-LD object, for example when a page contains multiple <script> blocks set through the Designer.

isInheritedbooleanDefaults to false

true when the response represents the primary locale’s schema markup because the requested secondary locale has no override. false when the response is the locale’s own value or when no localeId was requested.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error