EzineArticles API

EzineArticles API - Account Articles Search

This part of the API allow you to access more details about article in your account. It can be used to monitor the status of your articles.

« Return to API home

Parameters for Account Articles Search

Note: This method requires Member Authentication.

ParameterPossible ValuesPurposeDefault
searchaccount.article.viewTo indicate a request for article information.Required
article_idThe unique ID assigned to an article.
authorTo indicate look up by author name.
statuslive, in-review, draft, problem, scheduled*To indicate the article's status to lookup.any
page1+To specify which page of results should be returned.1
limit1 - 15To specify how many results per page should be returned.15
emailThe email address for an EzineArticles Membership Account (Used to login to their Membership Account).Required
passEzineArticles member's password associated with the email.Required
* Only available to Premium Membership level authors. Find out how to become a Premium Membership Level Author.

Account Articles Search Example

To lookup an articles by specific author name:

http://api.ezinearticles.com/api.php?search=account.article.view&status=live&limit=1&email={email address}&pass={password}&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>
<title>Authors With Multiple Brands - Secrets to Managing Multiple Topics When Writing Articles</title>
<category>Writing-and-Speaking</category>
<subcategory>Writing-Articles</subcategory>
<status>live</status>
<date_submitted>2006-03-02</date_submitted>
<date_published>2006-03-03</date_published>
</article>
<response_info>
<time>2008-08-27 16:36:49</time>
<status>200</status>
<search>account.article.view</search>
<format>xml</format>
<results>11</results>
<limit>1</limit>
<page>1</page>
<pages>2</pages>
</response_info>
</ezinearticles_api_response>

Explanation of Account Articles Search Returned Values

Note: Some values are dependant on the data_amount parameter being passed to the API.

ValueRepresentsData amount
idThe unique ID assigned to an article.
authorThe author of the article.
titleThe article title.
categoryThe category of the article.
subcategoryThe subcategory of the article.
statusThe status of the article.
date_submittedThe date the article was submitted.
date_publishedThe date the article was published.
summaryArticle's summary.extended
resource_boxArticle's resource box.extended
keywordsArticle's keywords.extended
publisher_countNumber of times the EzinePublisher link has been clicked for this article by visitors of EzineArticles.extended
email_countNumber of times the article has been "Forwarded To A Friend" from visitors of EzineArticles.extended
viewsNumber of times the article has been viewed by visitors of EzineArticlesextended
url_clicksNumber of times a link in the body or resource box has been clicked for this article by visitors of EzineArticles.extended
ctrNumber of clicks article or resource box received per hundred article views, expressed as a percentageextended
commentsNumber of times the article has been commented on by visitors of EzineArticles.extended
votesNumber of times the articles has been rated by visitors of EzineArticles.extended

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.