Search Posts

GET {{baseUrl}}/api/v2/help_center/community_posts/search?query=<string>&topic=<integer>&created_before=<dateTime>&created_after=<dateTime>&created_at=<dateTime>&updated_before=<dateTime>&updated_after=<dateTime>&updated_at=<dateTime>&sort_by=<string>&sort_order=<string>

Returns a maximum of 25 posts per page, up to a maximum of 1000 results. See Pagination.

The results are sorted by relevance by default. You can also sort the results by created_at or updated_at.

Pagination

  • Offset pagination only

See Pagination.

Returns a maximum of 100 articles per page.

Allowed for

  • End users

Request Params

KeyDatatypeRequiredDescription
querystring(Required) Search text to be matched or a search string. Examples: "carrot potato", "''carrot potato''"'
topicstringSearch by topic ID. See Filtering by Topic
created_beforestringthe search to posts created before a given date (format YYYY-MM-DD)
created_afterstringSearch posts created after a given date (format YYYY-MM-DD)
created_atstringSearch posts created on a given date (format YYYY-MM-DD)
updated_beforestringSearch posts updated before a given date (format YYYY-MM-DD)
updated_afterstringSearch posts updated after a given date (format YYYY-MM-DD)
updated_atstringSearch posts updated on a given date (format YYYY-MM-DD)
sort_bystringSort by created_at or updated_at. Defaults to sorting by relevance
sort_orderstringSort in ascending or descending order. Default is descending order.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;results&quot;:[{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;author_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;closed&quot;:&quot;\u003cboolean\u003e&quot;,&quot;comment_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;content_tag_ids&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;details&quot;:&quot;\u003cstring\u003e&quot;,&quot;featured&quot;:&quot;\u003cboolean\u003e&quot;,&quot;follower_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;html_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;non_author_editor_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;non_author_updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;pinned&quot;:&quot;\u003cboolean\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;topic_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;vote_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;vote_sum&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;author_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;closed&quot;:&quot;\u003cboolean\u003e&quot;,&quot;comment_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;content_tag_ids&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;details&quot;:&quot;\u003cstring\u003e&quot;,&quot;featured&quot;:&quot;\u003cboolean\u003e&quot;,&quot;follower_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;html_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;non_author_editor_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;non_author_updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;pinned&quot;:&quot;\u003cboolean\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;topic_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;vote_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;vote_sum&quot;:&quot;\u003cinteger\u003e&quot;}]}