secret parameter not required
Search for Posts by keyword or query. These can match against full content. 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.
While this endpoint will work with all languages, the accuracy will be better for documents in the following languages (read more about language support here):
|apikey||Publisher Site ID (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: |
|boost||(Available for |
|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
Last updated: August 16, 2023