# About the Posts and Stats API

The Posts and Stats API allows you to retrieve and manage blog posts. A post is a published article written for a blog.

With the Posts and Stats API, you can:

- Retrieve and display [a post](fallback::https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/get-post) or [a list of posts](fallback::https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/list-posts).
- [Query posts](fallback::https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/query-posts) based on specific filters.
- [Retrieve the metrics](fallback::https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/get-post-metrics) of a post to analyze engagement and performance.

Learn more about [Wix Blog](fallback::https://support.wix.com/en/article/wix-blog-about-the-wix-blog).

## Before you begin

It’s important to note the following before starting to code:

+ With [Wix Pricing Plans](fallback::https://dev.wix.com/docs/rest/business-solutions/pricing-plans/pricing-plans/introduction), exclusive blog content can only be accessed by readers with a subscription. Learn more about [creating blog post subscriptions](fallback::https://support.wix.com/en/article/wix-blog-creating-blog-post-subscriptions).

+ With [Wix Multilingual](fallback::https://support.wix.com/en/article/wix-multilingual-an-overview), a blog can be translated into multiple languages. Learn more about [translating a blog](fallback::https://support.wix.com/en/article/wix-multilingual-translating-your-blog).
  > **Note:** `translationId` is only returned in a post object if the [Multilingual](fallback::https://support.wix.com/en/article/wix-multilingual-an-overview) app is installed.

## Blog roles
Collaborators can create and manage blogs based on certain roles: 
- **Blog editors** can fully manage the blog, but not other areas of a site.
- **Blog writers** can create and publish their own posts on a blog.
- **Guest writers** can create posts, but can't publish them. 

## Terminology

- **Post**: A published article on a blog. It is also referred to as a publication. A blog can have up to 100,000 posts.
- **Draft Post**: An article written by a Wix user, blog editor, blog writer, or a guest writer that is not yet published.
- **Category**: A group of similar and related posts. A post can be assigned to a maximum of 10 categories.
- **Tag**: A way to further sort and organize blog posts. Tags provide the ability to filter blog posts.

# Posts: Supported Filters and Sorting

The following table shows field support for filters and sorting
for the Post object:

| Field               | Supported Filters                                                                     | Sortable |
| ------------------- | ------------------------------------------------------------------------------------- | -------- |
| `id`                | `$eq`, `$ne`, `$hasSome`                                                              | Sortable |
| `title`             | `$eq`, `$ne`, `$contains`, `$startsWith`, `$endsWith`, `$hasSome`, `$lt`, `$lte`, `$gt`, `$gte`, `$exists`, `$in`    | Sortable |
| `firstPublishedDate`| `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`                                     | Sortable |
| `lastPublishedDate` | `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`                                     | Sortable |
| `slug`              | `$hasSome`, `$hasAll`                                                                 |          |
| `featured`          | `$eq`, `$ne`                                                                          | Sortable |
| `pinned`            | `$eq`, `$ne`                                                                          | Sortable |
| `categoryIds`       | `$hasSome`, `$hasAll`                                                                 |          |
| `memberId`          | `$eq`, `$ne`, `$hasSome`                                                              |          |
| `hashtags`          | `$hasSome`, `$hasAll`                                                                 |          |
| `commentingEnabled` | `$eq`, `$ne`                                                                          | Sortable |
| `minutesToRead`     | `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`                                     |          |
| `tagIds`            | `$hasSome`, `$hasAll`                                                                 |          |
| `pricingPlanIds`    | `$hasSome`, `$hasAll`                                                                 |          |
| `language`          | `$eq`, `$ne`, `$hasSome`, `$exists`, `$in`                                            |          |
| `translationId`     | `$eq`, `$ne`, `$exists`, `$in`                                                        |          |
| `metrics.views`     | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte`, `$in`                                     | Sortable |
| `metrics.comments`  | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte`, `$in`                                     | Sortable |
| `metrics.likes`     | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte`, `$in`                                     | Sortable |


__Related content:__
[API Query Language](portalId::d1972c09-74e2-4d36-a6f2-54e3310d4ad9resourceId::8158a590-f60c-4606-9fed-16a34e275f3a*fallback::https://dev.wix.com/api/rest/getting-started/api-query-language),
[Query Posts](fallback::https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/query-posts)

Coding Examples

Sled Tests

Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

REST

Velo

Picasso

GraphQL (Alpha)

Get Total Posts