Sign in

v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-2113138232.4 KB
articles

Search for articles

This endpoint allows the client to search for articles.

Search Guidance:

  • q: The search query term. Matches against article titles, tags, and body content.
  • top: Restricts search results to articles published within the last N days.
  • page & per_page: Standard pagination support. Use this to display results sequentially on a search results page.
get/api/articles/search

Query parameters

qstring

The search query term. Matches against article titles, tags, and body content.

topinteger

Restricts search results to articles published within the last N days.

pageinteger

Pagination page index.

per_pageinteger

The number of items to return per page.

Response

A List of Articles

type_ofstring required
idinteger required
titlestring required
descriptionstring required
cover_imagestring url nullable required
readable_publish_datestring required
social_imagestring url required
tag_liststring[] required
tagsstring required
slugstring required
pathstring path required
urlstring url required
canonical_urlstring url required
positive_reactions_countinteger required
public_reactions_countinteger required
created_atstring date-time required
edited_atstring date-time nullable required
crossposted_atstring date-time nullable required
published_atstring date-time required
last_comment_atstring date-time required
published_timestampstring date-time required

Crossposting or published date time

reading_time_minutesinteger required

Reading time, in minutes