Own Shopify? Customize your docs with AI search, analytics, and more.

Claim your docs

GET

Retrieves a list of all articles from a blog. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/2020-04/blogs/{blog_id}/articles.json

https://shopify.dev/docs/admin-api/rest/reference/online-store/article#index-2020-04

Access Token Required: API Key

Path Parameters

blog_idstringrequired

blog_id

Query Params

limitstring

The maximum number of results to retrieve. (default: 50, maximum: 250)

since_idstring

Restrict results to after the specified ID.

created_at_minstring

Show articles created after date (format: 2014-04-25T16:15:47-04:00).

created_at_maxstring

Show articles created before date (format: 2014-04-25T16:15:47-04:00).

updated_at_minstring

Show articles last updated after date (format: 2014-04-25T16:15:47-04:00).

updated_at_maxstring

Show articles last updated before date (format: 2014-04-25T16:15:47-04:00).

published_at_minstring

Show articles published after date (format: 2014-04-25T16:15:47-04:00).

published_at_maxstring

Show articles published before date (format: 2014-04-25T16:15:47-04:00).

published_statusstring

Retrieve results based on their published status. (default: any) published: Show only published articles. unpublished: Show only unpublished articles. any: Show articles of any published status.

handlestring

Retrieve an article with a specific handle.

tagstring

Filter articles with a specific tag.

authorstring

Filter articles by article author.

fieldsstring

Show only certain fields, specified by a comma-separated list of field names.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/2020-04/blogs/{blog_id}/articles.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET

Retrieves a list of all articles from a blog. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/2020-04/blogs/{blog_id}/articles.json

https://shopify.dev/docs/admin-api/rest/reference/online-store/article#index-2020-04

Access Token Required: API Key

Path Parameters

blog_idstringrequired

blog_id

Query Params

limitstring

The maximum number of results to retrieve. (default: 50, maximum: 250)

since_idstring

Restrict results to after the specified ID.

created_at_minstring

Show articles created after date (format: 2014-04-25T16:15:47-04:00).

created_at_maxstring

Show articles created before date (format: 2014-04-25T16:15:47-04:00).

updated_at_minstring

Show articles last updated after date (format: 2014-04-25T16:15:47-04:00).

updated_at_maxstring

Show articles last updated before date (format: 2014-04-25T16:15:47-04:00).

published_at_minstring

Show articles published after date (format: 2014-04-25T16:15:47-04:00).

published_at_maxstring

Show articles published before date (format: 2014-04-25T16:15:47-04:00).

published_statusstring

Retrieve results based on their published status. (default: any) published: Show only published articles. unpublished: Show only unpublished articles. any: Show articles of any published status.

handlestring

Retrieve an article with a specific handle.

tagstring

Filter articles with a specific tag.

authorstring

Filter articles by article author.

fieldsstring

Show only certain fields, specified by a comma-separated list of field names.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/2020-04/blogs/{blog_id}/articles.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}