EzineArticles API

EzineArticles API - Search Articles

You can retrieve article information such as recently published articles, most published articles, most viewed articles, most emailed articles, and top rated articles. You can also gather articles from a specific EzineArticles Expert Author and/or a particular EzineArticles category.

« Return to API home

Parameters for Article Search

ParameterPossible ValuesPurposeDefault
searchRequired
search »articlesTo indicate a request for article information.
search »articles.most.viewedTo indicate a request for most viewed articles information.
search »articles.most.recentTo indicate a request for most recent articles information.
search »articles.most.publishedTo indicate a request for most published articles information.
search »articles.most.emailedTo indicate a request for most emailed articles information.
article_idTo pull article information on a specific article.
authorTo access articles from a specific EzineArticles Expert Author.
categoryTo access articles in an EzineArticles category.
subcategoryTo access articles in a subcategory of a specified category.
comments1 - 10To show a number of comments for each article.0
page1+To specify which page of results should be returned.1
limit1 - 10To specify how many results per page should be returned.10

Articles Search Example

To lookup an articles by specific author name:

http://api.ezinearticles.com/api.php?search=articles&author=Christopher%20Knight&limit=1&response_format=xml&key={your api key}

To lookup most viewed articles in Writing and Speaking category:

http://api.ezinearticles.com/api.php?search=articles.most.viewed&category=Writing-and-Speaking&limit=1&response_format=xml&key={your api key}

The above API request will return something similar to this:

<ezinearticles_api_response>
<article>
<id>154856</id>
<author>Christopher Knight</author>
<date_published>2006-03-02</date_published>
<date_updated>2006-03-02</date_updated>
<title>Authors With Multiple Brands - Secrets to Managing Multiple Topics When Writing Articles</title>
<category>Writing-and-Speaking</category>
<subcategory>Writing-Articles</subcategory>
<summary>Most prolific writers/authors write about more than one area of expertise. You might have a main area of expertise, and then multiple sub-topic or different topics that you write articles about (some to pay the bills and others to feed their creative spirit). How do you create author brand strength without creating market confusion as to your expertise? Read on to find out...</summary>
<url>http://EzineArticles.com/?Authors-With-Multiple-Brands---Secrets-to-Managing-Multiple-Topics-When-Writing-Articles&id=154856</url>
</article>
<response_info>
<time>2008-08-27 16:36:49</time>
<status>200</status>
<search>articles</search>
<format>xml</format>
<results>21</results>
<limit>1</limit>
<page>1</page>
<pages>21</pages>
</response_info>
</ezinearticles_api_response>

Explanation of Articles Search Returned Values

ValueRepresents
idThe unique ID assigned to an article.
authorThe name of the author of the article.
date_publishedThe date the article was published.
date_updatedThe date the article was last updated.
titleThe article title.
categoryThe category of the article.
subcategoryThe subcategory of the article.
summaryThe article summary.
urlThe URL of the article.

Top Rated Articles Search

ParameterPossible ValuesPurposeDefault
searcharticles.top.ratedTo indicate a request for top rated articles information.Required
limit1 - 25To specify how many results per page should be returned.25

Top Rated Articles Search Example

http://api.ezinearticles.com/api.php?search=articles.top.rated&limit=1&response_format=xml&key={your api key}

The above API request will return something similar to this:

<ezinearticles_api_response>
<article>
<id>154856</id>
<title>Authors With Multiple Brands - Secrets to Managing Multiple Topics When Writing Articles</title>
<votes>214</votes>
<rating>3.78</rating>
<url>http://EzineArticles.com/?Authors-With-Multiple-Brands---Secrets-to-Managing-Multiple-Topics-When-Writing-Articles&id=154856</url>
</article>
<response_info>
<time>2008-08-27 16:36:49</time>
<status>200</status>
<search>articles.top.rated</search>
<format>xml</format>
</response_info>
</ezinearticles_api_response>

Explanation of Top Rated Articles Search Returned Values

ValueRepresents
idThe EzineArticles ID of the article.
titleThe article title.
votesTotal number of votes.
ratingThe average rating score of the article.
urlThe URL of the article.

Response Status Codes

If there is a problem with your API request, an error message will be shown in the format specified by the response_format parameter or in plain text if that parameter is missing.

CodeMeaning
200The request was successful. This code will accompany a response from the API.
404No results found. This code will accompany a message explaining that no results were found for your request.
400The request was invalid. This code will also be sent if you have exceeded your maximum hourly requests or your API Key is invalid.
500The API is experiencing a problem unrelated to your request that prevents it being performed at this time.