queryPosts( )

Creates a query to retrieve a list of posts.

The queryPosts() function builds a query to retrieve a list of up to 100 posts, and returns a PostsQueryBuilder object.

The returned object contains the query definition which is typically used to run the query using the find() function.

You can refine the query by chaining PostsQueryBuilder functions onto the query. PostsQueryBuilder functions enable you to sort, filter, and control the results that queryPosts() returns.

queryPosts() runs with these PostsQueryBuilder defaults that can be overridden:

• limit(50)
• descending('firstPublishedDate')

Note that the default limit is '50', but the max limit is '100'.

To learn how to query posts, refer to the table below.

The following PostsQueryBuilder functions are supported for the queryPosts() function. For a full description of the Posts object, see the object returned for the items property in PostsQueryResult.

PROPERTY	SUPPORTED FILTERS & SORTING
_id	eq(),ne(),hasSome(),ascending(),descending()
title	eq(),ne(),startsWith(),hasSome(),exists(),in(),ascending(),descending()
firstPublishedDate	eq(),ne(),lt(),le(),gt(),ge(),in(),ascending(),descending()
lastPublishedDate	eq(),ne(),lt(),le(),gt(),ge(),in(),ascending(),descending()
slug	eq(),ne(),hasSome(),ascending(),descending()
featured	eq(),ne(),ascending(),descending()
pinned	eq(),ne(),ascending(),descending()
categoryIds	hasSome(),hasAll()
coverMedia.enabled	eq(),ne()
memberId	eq(),ne(),hasSome()
hashtags	hasSome(),hasAll()
commentingEnabled	eq(),ne(),ascending(),descending()
minutesToRead	eq(),ne(),lt(),le(),gt(),ge(),in()
tagIds	hasSome(),hasAll()
pricingPlanIds	hasSome(),hasAll()
translationId	eq(),ne(),exists(),in()
language	eq(),ne(),hasSome(),exists(),in()
metrics.comments	eq(),ne(),lt(),le(),gt(),ge(),in(),ascending(),descending()
metrics.likes	eq(),ne(),lt(),le(),gt(),ge(),in(),ascending(),descending()
metrics.views	eq(),ne(),lt(),le(),gt(),ge(),in(),ascending(),descending()