Shopify

List Shopify blog articles

List the articles in one Shopify blog with full content, author and paging.

GET/v1/shopify/blogs/{blogHandle}/articles
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
blogHandlestringrequiredpath

The blog handle, as it appears in its URL, e.g. `news`.

min 1 chars · max 255 chars · pattern: ^[^\s/?#]+$

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

Articles per page, 1 to 250. Default: 10.

≥ 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
46

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.

datablogHandle
string

The blog handle that was requested.

The blog when found; null otherwise.

datablogid
string

Blog id.

databloghandle
string

Blog handle.

datablogtitle
stringnullable

Blog title.

Articles on this page.

dataarticles[]id
string

Numeric article id as a string.

dataarticles[]gid
stringnullable

The store's global article id.

dataarticles[]handle
string

Article handle.

dataarticles[]title
string

Article title.

dataarticles[]url
stringnullable

Article URL.

dataarticles[]excerpt
stringnullable

Excerpt as plain text.

dataarticles[]content
stringnullable

Article text as plain text.

dataarticles[]contentHtml
stringnullable

Article text as HTML.

dataarticles[]publishedAt
stringnullable

Published, ISO 8601 UTC.

Tags.

dataarticles[]tags[]
stringoptional

The merchant's meta tags.

dataarticles[]seotitle
stringnullable

SEO title.

dataarticles[]seodescription
stringnullable

SEO description.

Who wrote it.

dataarticles[]authorname
stringnullable

Author display name.

dataarticles[]authorbio
stringnullable

Author bio.

Article image; null when none.

dataarticles[]imageid
stringnullable

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

dataarticles[]imageurl
stringnullable

Image URL.

dataarticles[]imagealtText
stringnullable

Alt text the merchant set.

dataarticles[]imagewidth
integernullable

Pixel width.

dataarticles[]imageheight
integernullable

Pixel height.

Variants the image belongs to; empty when not given.

dataarticles[]imagevariantIds[]
stringoptional

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

dataarticles[]comments[]id
string

Comment id.

dataarticles[]comments[]body
stringnullable

Comment text.

dataarticles[]comments[]author
stringnullable

The commenter's display name.

dataarticles[]commentsHasMore
boolean

Whether the store has more comments 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/news/articles?store=www.allbirds.com" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of Shopify blog articles.