Get one of a shop’s blog posts

GET

/storefront/sites/{host}/posts/{slug}

const url = 'https://example.com/storefront/sites/northgate.shop.getbottle.app/posts/getting-your-barbecue-ready';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/storefront/sites/northgate.shop.getbottle.app/posts/getting-your-barbecue-ready

Deliberately unauthenticated: a post the business published, dated today or before, by its address, with its body cleaned again on the way out. A post whose address changed answers kind moved with where it is now. With preview, drafts too, never cached. Anything else is 404 with an empty body.

Parameters

Path Parameters

host

required

string

Example

northgate.shop.getbottle.app

slug

required

string

Example

getting-your-barbecue-ready

Query Parameters

preview

string

Responses

200

The post, or where it moved to

application/json

One of:

object
object

object

kind

required

string

Allowed values: post

post

required

object

required

UUID v7

string format: uuid

slug

required

string

title

required

string

excerpt

required

string

cover

required

object

alt

required

string | null

width

required

integer

height

required

integer

thumb

required

string

card

required

string

large

required

string

authorName

required

string

publishedOn

required

string format: date

tags

required

Array<object>

object

name

required

string

slug

required

string

updatedAt

required

string format: date-time

bodyHtml

required

string | null

seoTitle

required

string

seoDescription

required

string

Example

{
  "kind": "post",
  "post": {
    "id": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f"
  }
}

304

Not changed since the ETag sent

404

No such post. No body.

429

Too many requests from one address