Articles

Jump to bottom

psiemens edited this page Dec 23, 2014 · 1 revision

API endpoints for articles:

GET articles

Parameters:

q search query
author author
before published before date
after published after date
topic topic id
tags comma separated list of tags
section section id
n number of articles to return

Returns: JSON array of the n articles matching the given parameters.

GET articles/front

Parameters:

date optional date parameter (default=TODAY)

Returns: JSON array of the front page articles, ordered by importance.

GET articles/shared

Parameters:

start optional start date parameter (default=TODAY)
end optional end date parameter (default=TODAY-7DAYS)
n number of articles to return

Returns: JSON array of the most shared articles for the given time period (default: the past week).

GET articles/next

Parameters:

from current article ID (required)
n number of articles to return

Returns: JSON array of the next n articles after from, as determined by the next-article algorithm.