Search for Posts by keyword or query. These can match against full content. There are 2 notable parameters one can use to control search results:
sort, which determines the posts returned.
score(default) selects by relevancy.
pub_dateselects relevant posts by publish date.
boost, which allows use of Parse.ly metrics to determine how rankings are sorted within the results after the initial search has been performed. This parameter is not specified by default, resulting in rankings by relevance only. Only available for
While this endpoint will work with all languages, the accuracy will be better for documents in the following languages:
|apikey||Publisher API key|
Your API secret is not used with this endpoint.
|q||Search query keywords; quoting is supported, e.g. q="squirrel facts" instead of q=squirrel+facts.|
|pub_date_start||Publication filter start date; see Date/Time Handling for formatting details.|
|pub_date_end||Publication filter end date; see Date/Time Handling for formatting details. Defaults to current date and time if not specified.|
|limit||Number of records to retrieve; defaults to "10".|
|page||Page number to retrieve if multiple pages are available; defaults to
|section||Return recommendations that belong only in the specified section|
|author||Return recommendations that only belong to the specified author|
|tag||Return recommendations that only belong to the specified tag|
|sort||What to sort the results by. There are currently 2 valid options:
|exclude||Exclude recommendations from a certain author, section or tag. The syntax is
Deprecated Optional Parameters¶
boost, as they provide the below functionality and more.
|strategy||The algorithm to use for search. The default is
|click||method: one of
recency: Returns search results based on the content of the given link and emphasize fresh articles
click: Returns search results based on the content of a link and give higher importance ("boost") to links with certain click kinds of click data. Since multiple sources of click data are available, this must be specified with
Possible values for click.method:
ref_social: boost results by number of social referrers from Facebook, Twitter, Pinterest ("viral content")
ref_search: boost results by number of referrers coming from search engines ("informative content")
ref_internal: boost results by number of referrers coming from within the site itself ("editorially promoted content")
shares: boost results by number of shares a post has received
Stay on top of API updates
Want to be notified of our latest API updates? Fill out this form to get an email whenever we make changes to our API.