> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# List Blog Posts

GET https://api.bigcommerce.com/stores/{store_hash}/v2/blog/posts

Returns all *Blog Posts*. Default sorting is by published_date, beginning with the most recent post.

Reference: https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/store-content/blog-posts/get-blog-posts

## Authentication

- `X-Auth-Token` header (required) — ### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Content | modify | `store_v2_content` | | Content | read-only | `store_v2_content_read_only` | ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

## Request

### Path parameters

- `store_hash` (string, required) — Permanent ID of the BigCommerce store.

### Query parameters

- `is_published` (boolean, optional) — Filter param.
- `url` (string, optional) — Filter param. Value must be URL encoded.
- `tag` (string, optional) — Filter param.
- `published_date` (datetime, optional) — Filter param.
- `page` (integer, optional) — Filter param.
- `limit` (integer, optional) — Filter param.

### Headers

- `Accept` (string, required, default: application/json) — The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the response body.

## Response

### 200

OK

- `list of blogPost_Full`

## Types

### blogPost_Full

- `author` (string, optional, nullable) — Name of the blog post’s author.
- `body` (string, optional) — Text body of the blog post.
- `id` (integer, optional) — ID of this blog post. READ-ONLY.
- `is_published` (boolean, optional, default: false) — Whether the blog post is published. If you want the post to be or remain published following the request, you must set the field explicitly to true, even if the blog post was already published prior to the request.
- `meta_description` (string, optional, nullable) — Description text for this blog post’s `<meta/>` element.
- `meta_keywords` (string, optional, nullable) — Keywords for this blog post’s `<meta/>` element.
- `preview_url` (string, optional) — URL to preview the blog post. READ-ONLY.
- `published_date` (publishedDate, optional)
- `published_date_iso8601` (string, optional) — Published date in `ISO 8601` format.
- `summary` (string, optional) — Summary of the blog post. READ-ONLY.
- `tags` (list of string, optional) — Tags to characterize the blog post.
- `thumbnail_path` (string, optional, nullable) — Local path to a thumbnail uploaded to `/product_images/` using [WebDAV](https://support.bigcommerce.com/s/article/File-Access-WebDAV).
- `title` (string, optional) — Title of this blog post.
- `url` (string, optional) — URL for the public blog post.

### publishedDate

- `timezone_type` (integer, optional)
- `date` (datetime, optional)
- `timezone` (string, optional)

## Examples

**Response**

```json
[
  {
    "author": "",
    "body": "<p>Jelly beans muffin marzipan gingerbread donut dessert. Cheesecake cheesecake sugar plum cookie cake tart. Soufflé sesame snaps jelly beans brownie chocolate tart. Marshmallow jujubes candy pie. Gummies lemon drops tart soufflé pastry pie. Caramels wafer biscuit gummi bears. Liquorice toffee wafer bear claw marzipan jelly-o. Dessert bear claw topping icing croissant. Pie bonbon chocolate bar chocolate bar tiramisu chocolate lemon drops candy.</p><p>Marshmallow cupcake sweet roll candy marshmallow caramels cotton candy pie icing. Powder jelly beans chupa chups lollipop liquorice marzipan dessert soufflé sesame snaps. Macaroon chupa chups gummies cheesecake ice cream caramels sesame snaps cotton candy gingerbread. Chocolate cake fruitcake tart bear claw lemon drops tart dragée tart apple pie. Halvah chupa chups soufflé jelly soufflé marshmallow. Croissant tart tart. Gingerbread apple pie biscuit.</p><p>Wafer lemon drops tart pastry brownie chocolate bar jelly. Dragée muffin cupcake liquorice caramels marzipan gingerbread marzipan. Apple pie pudding jelly sweet roll croissant bonbon wafer. Cookie chocolate bar sesame snaps bonbon macaroon candy canes donut sugar plum. Bear claw bonbon tootsie roll bonbon. Apple pie gummies donut sweet. Marzipan bear claw cotton candy topping dragée bonbon danish powder.</p>",
    "id": 3,
    "is_published": true,
    "meta_description": "Cupcakes post 2",
    "meta_keywords": "sugar,sweet,spice,everything,nice",
    "preview_url": "/blog/hello-again/",
    "published_date": {
      "timezone_type": 1,
      "date": "2018-05-18 08:26:42.000000",
      "timezone": "+00:00"
    },
    "published_date_iso8601": "2018-05-18T13:26:42+0000",
    "summary": "Jelly Beans Muffin Marzipan Gingerbread Donut Dessert. Cheesecake Cheesecake Sugar Plum Cookie Cake Tart. Soufflé Sesame Snaps Jelly Beans Brownie Chocolate Tart. Marshmallow Jujubes Candy Pie. Gummies Lemon Drops Tart Soufflé Pastry Pie. Caramels Wafer Biscuit Gummi Bears. Liquorice Toffee Wafer Bear Claw Marzipan Jelly-O. Dessert Bear Claw Topping Icing Croissant. Pie Bonbon Chocolate Bar [...]",
    "tags": [
      "sugar",
      "sweet",
      "spice",
      "everything",
      "nice"
    ],
    "thumbnail_path": "",
    "title": "Hello Again",
    "url": "/blog/hello-again/"
  },
  {
    "author": "",
    "body": "<p>Jelly beans muffin marzipan gingerbread donut dessert. Cheesecake cheesecake sugar plum cookie cake tart. Soufflé sesame snaps jelly beans brownie chocolate tart. Marshmallow jujubes candy pie. Gummies lemon drops tart soufflé pastry pie. Caramels wafer biscuit gummi bears. Liquorice toffee wafer bear claw marzipan jelly-o. Dessert bear claw topping icing croissant. Pie bonbon chocolate bar chocolate bar tiramisu chocolate lemon drops candy.</p><p>Marshmallow cupcake sweet roll candy marshmallow caramels cotton candy pie icing. Powder jelly beans chupa chups lollipop liquorice marzipan dessert soufflé sesame snaps. Macaroon chupa chups gummies cheesecake ice cream caramels sesame snaps cotton candy gingerbread. Chocolate cake fruitcake tart bear claw lemon drops tart dragée tart apple pie. Halvah chupa chups soufflé jelly soufflé marshmallow. Croissant tart tart. Gingerbread apple pie biscuit.</p><p>Wafer lemon drops tart pastry brownie chocolate bar jelly. Dragée muffin cupcake liquorice caramels marzipan gingerbread marzipan. Apple pie pudding jelly sweet roll croissant bonbon wafer. Cookie chocolate bar sesame snaps bonbon macaroon candy canes donut sugar plum. Bear claw bonbon tootsie roll bonbon. Apple pie gummies donut sweet. Marzipan bear claw cotton candy topping dragée bonbon danish powder.</p>",
    "id": 2,
    "is_published": true,
    "meta_description": "cupcake blog post",
    "meta_keywords": "cupcakes,sugar,sweet",
    "preview_url": "/blog/hello/",
    "published_date": {
      "timezone_type": 1,
      "date": "2018-05-18 08:26:00.000000",
      "timezone": "+00:00"
    },
    "published_date_iso8601": "2018-05-18T13:26:00+0000",
    "summary": "Jelly Beans Muffin Marzipan Gingerbread Donut Dessert. Cheesecake Cheesecake Sugar Plum Cookie Cake Tart. Soufflé Sesame Snaps Jelly Beans Brownie Chocolate Tart. Marshmallow Jujubes Candy Pie. Gummies Lemon Drops Tart Soufflé Pastry Pie. Caramels Wafer Biscuit Gummi Bears. Liquorice Toffee Wafer Bear Claw Marzipan Jelly-O. Dessert Bear Claw Topping Icing Croissant. Pie Bonbon Chocolate Bar [...]",
    "tags": [
      "cupcakes",
      "sugar",
      "sweet"
    ],
    "thumbnail_path": "",
    "title": "Hello",
    "url": "/blog/hello/"
  },
  {
    "author": "",
    "body": "<p><strong>Welcome to your blog!</strong><br> A blog is a great place to share details on your products, business and whatever else you think your shoppers might like to hear from you. You can include photos in your blog posts and even videos. For ideas and inspiration on how to structure your blog, take a look at the BigCommerce <a href='http://blog.bigcommerce.com/' target='_blank' rel='nofollow'>ecommerce blog</a>.</p><p><strong>How can I delete this post?</strong><br>To delete this post and add your own, login to your <a href='/admin' target='_blank'>admin area</a> and go to Storefront > Blog in the left hand menu.</p><p><strong>Powered by BigCommerce</strong><br>Your website, online store and blog are powered by BigCommerce <a href='http://www.bigcommerce.com/' target='_blank' rel='nofollow'>ecommerce software</a>. It includes everything you need to run a beautiful online store including <a href='http://www.bigcommerce.com/templates/' target='_blank' rel='nofollow'>ecommerce website templates</a>, <a href='http://www.bigcommerce.com/features/hosting/' target='_blank' rel='nofollow'>ecommerce hosting</a>, an <a href='http://www.bigcommerce.com/features/setup/' target='_blank' rel='nofollow'>online shopping cart</a> and more.</p>",
    "id": 1,
    "is_published": true,
    "meta_description": "",
    "meta_keywords": "Blog,SEO",
    "preview_url": "/your-first-blog-post/",
    "published_date": {
      "timezone_type": 1,
      "date": "2014-02-15 14:46:34.000000",
      "timezone": "+00:00"
    },
    "published_date_iso8601": "2014-02-15T19:46:34+0000",
    "summary": " Welcome to your blog! A blog is a great place to share details on your products, business and whatever else you think your shoppers might like to hear from you. You can include photos in your blog posts and even videos. For ideas and inspiration on how to structure your blog, take a look [...]",
    "tags": [
      "Blog",
      "SEO"
    ],
    "thumbnail_path": "",
    "title": "Your first blog post!",
    "url": "/your-first-blog-post/"
  }
]
```

**SDK Code**

```python Response
import requests

url = "https://api.bigcommerce.com/stores/store_hash/v2/blog/posts"

headers = {
    "Accept": "application/json",
    "X-Auth-Token": "<apiKey>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Response
const url = 'https://api.bigcommerce.com/stores/store_hash/v2/blog/posts';
const options = {
  method: 'GET',
  headers: {Accept: 'application/json', 'X-Auth-Token': '<apiKey>'}
};

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

```go Response
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bigcommerce.com/stores/store_hash/v2/blog/posts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Accept", "application/json")
	req.Header.Add("X-Auth-Token", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Response
require 'uri'
require 'net/http'

url = URI("https://api.bigcommerce.com/stores/store_hash/v2/blog/posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'
request["X-Auth-Token"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java Response
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.bigcommerce.com/stores/store_hash/v2/blog/posts")
  .header("Accept", "application/json")
  .header("X-Auth-Token", "<apiKey>")
  .asString();
```

```php Response
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.bigcommerce.com/stores/store_hash/v2/blog/posts', [
  'headers' => [
    'Accept' => 'application/json',
    'X-Auth-Token' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Response
using RestSharp;

var client = new RestClient("https://api.bigcommerce.com/stores/store_hash/v2/blog/posts");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
request.AddHeader("X-Auth-Token", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Response
import Foundation

let headers = [
  "Accept": "application/json",
  "X-Auth-Token": "<apiKey>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.bigcommerce.com/stores/store_hash/v2/blog/posts")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```