v1

latestOpenAPI 3.0.02026-07-1752017.1 KB

Get content

Returns content that is in a published state. Additionally, it provides a JSON‑LD formatted response for enhanced author SEO.

get/api/v1/contents/{identifier}

Path parameters

identifierstring required

Id or Slug

Query parameters

draftKeystring

Key to fetch draft content

Response

Example response

{
  "content": {
    "id": "a8c4891c-6bc0-4f58-81c6-5e89bb572d4c",
    "slug": "my-first-post",
    "title": "This is a title",
    "subtitle": "This is a subtitle",
    "body": "This is a body",
    "bodyHtml": "<p>This is a body</p>",
    "status": "published",
    "language": "en-us",
    "version": 1,
    "coverUrl": "https://your-subdomain.collections.dev/assets/a8c4891c-6bc0-4f58-81c6-5e89bb572d4c",
    "metaTitle": "This is a meta title",
    "metaDescription": "This is a meta description",
    "publishedAt": "2023-09-29T00:53:20.604Z",
    "author": {
      "id": "a8c4891c-6bc0-4f58-81c6-5e89bb572d4c",
      "name": "John Doe",
      "avatarUrl": "https://your-subdomain.collections.dev/assets/a8c4891c-6bc0-4f58-81c6-5e89bb572d4c",
      "bio": "This is a bio",
      "bioUrl": "https://john-doe.com",
      "employer": "John Doe Inc.",
      "spokenLanguages": [
        {
          "language": "en-us"
        }
      ],
      "awards": [
        {
          "name": "Award Name"
        }
      ],
      "socialProfiles": [
        {
          "platform": "x",
          "url": "https://x.com/john-doe"
        }
      ],
      "alumni": [
        {
          "name": "Alumnus Name",
          "url": "https://alumnus.com"
        }
      ],
      "experiences": [
        {
          "name": "Experience Name",
          "url": "https://experience.com",
          "responses": [
            {
              "url": "https://response.com"
            }
          ]
        }
      ]
    },
    "tags": [
      {
        "id": "a8c4891c-6bc0-4f58-81c6-5e89bb572d4c",
        "name": "Tag Name"
      }
    ]
  },
  "jsonLd": {
    "@type": "BlogPosting",
    "@context": "https://schema.org",
    "name": "This is a title",
    "datePublished": "2023-09-29T00:53:20.604Z",
    "dateModified": "2023-09-29T00:53:20.604Z",
    "description": "This is a description",
    "inLanguage": "en-us",
    "articleSection": [
      "Technology",
      "Software Development"
    ],
    "author": {
      "@type": "Person",
      "name": "John Doe",
      "description": "This is a bio",
      "image": {
        "@type": "ImageObject",
        "url": "https://john-doe.com/avatar.jpg"
      },
      "jobTitle": "Software Engineer",
      "worksFor": {
        "@type": "Organization",
        "name": "John Doe Inc."
      },
      "knowsLanguage": [
        {
          "@type": "Language",
          "name": "English"
        }
      ],
      "award": [
        "Award 1",
        "Award 2"
      ],
      "sameAs": [
        "https://x.com/john-doe",
        "https://linkedin.com/in/john-doe"
      ],
      "alumniOf": [
        {
          "@type": "EducationalOrganization",
          "name": "Alumni Name",
          "url": "https://alumni.com"
        }
      ],
      "knowsAbout": [
        {
          "@type": "Thing",
          "name": "Knowledge about",
          "url": "https://knowledge.com",
          "sameAs": [
            "https://response.com"
          ]
        }
      ]
    },
    "mainEntityOfPage": {
      "@type": "WebPage",
      "name": "This is a title",
      "description": "This is a description",
      "inLanguage": "en-us",
      "datePublished": "2023-09-29T00:53:20.604Z",
      "dateModified": "2023-09-29T00:53:20.604Z"
    }
  }
}