Shopify

List Shopify store blogs

List a Shopify store's blogs with their SEO, authors and recent articles.

GET/v1/shopify/blogs
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
storestringrequiredquery

The store's domain, for example `allbirds.com`, `www.allbirds.com` or `weareallbirds.myshopify.com`. A full URL is accepted and reduced to its host. Only public storefront hosts are accepted.

limitintegeroptionalquery

Blogs per page, 1 to 250. Default: 20.

≥ 1 · ≤ 250

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 4096 chars

Response fields
54

Endpoint-specific response payload.

datalookupStatus
string

`found` on success; `not_found` when it does not exist or is not a Shopify store; `private` when the storefront is password-protected; `restricted` when the store is paused or frozen.

one of: found, not_found, private, restricted

datastore
string

The store host that was requested.

Blogs on this page.

datablogs[]id
string

Numeric blog id as a string.

datablogs[]gid
stringnullable

The store's global blog id.

datablogs[]handle
string

Blog handle, e.g. `news`.

datablogs[]title
string

Blog title.

datablogs[]url
stringnullable

Blog URL.

The merchant's meta tags.

datablogs[]seotitle
stringnullable

SEO title.

datablogs[]seodescription
stringnullable

SEO description.

Authors shown on this blog.

datablogs[]authors[]name
stringnullable

Author display name.

datablogs[]authors[]bio
stringnullable

Author bio.

The most recent articles, up to 10.

datablogs[]articles[]id
string

Numeric article id as a string.

datablogs[]articles[]gid
stringnullable

The store's global article id.

datablogs[]articles[]handle
string

Article handle.

datablogs[]articles[]title
string

Article title.

datablogs[]articles[]url
stringnullable

Article URL.

datablogs[]articles[]excerpt
stringnullable

Excerpt as plain text.

datablogs[]articles[]content
stringnullable

Article text as plain text.

datablogs[]articles[]contentHtml
stringnullable

Article text as HTML.

datablogs[]articles[]publishedAt
stringnullable

Published, ISO 8601 UTC.

Tags.

datablogs[]articles[]tags[]
stringoptional

The merchant's meta tags.

datablogs[]articles[]seotitle
stringnullable

SEO title.

datablogs[]articles[]seodescription
stringnullable

SEO description.

Who wrote it.

datablogs[]articles[]authorname
stringnullable

Author display name.

datablogs[]articles[]authorbio
stringnullable

Author bio.

Article image; null when none.

datablogs[]articles[]imageid
stringnullable

Image id; null when the store does not publish it for this row.

datablogs[]articles[]imageurl
stringnullable

Image URL.

datablogs[]articles[]imagealtText
stringnullable

Alt text the merchant set.

datablogs[]articles[]imagewidth
integernullable

Pixel width.

datablogs[]articles[]imageheight
integernullable

Pixel height.

Variants the image belongs to; empty when not given.

datablogs[]articles[]imagevariantIds[]
stringoptional

Moderated comments on the article, up to the page size.

datablogs[]articles[]comments[]id
string

Comment id.

datablogs[]articles[]comments[]body
stringnullable

Comment text.

datablogs[]articles[]comments[]author
stringnullable

The commenter's display name.

datablogs[]articles[]commentsHasMore
boolean

Whether the store has more comments than this page.

datablogs[]articlesHasMore
boolean

Whether the blog has more articles than this page.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/shopify/blogs?store=www.allbirds.com" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Shopify blogs with their recent articles.