EzineArticles API

EzineArticles API - Search Authors

Search Authors API method allows to lookup a specific EzineArticles Expert Author biography. You can also gather top authors from a specified category.

« Return to API home

Parameters for Authors Search

ParameterPossible ValuesPurposeDefault
searchauthorTo indicate a request for author information.Required
authorTo specify which EzineArticles Expert Author to look up.Required

Authors Search Example

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

The above API request will return something similar to this:

<ezinearticles_api_response>
<author>
<member_id>1296</member_id>
<name>Christopher Knight</name>
<bio_url>http://ezinearticles.com/?expert=Christopher_Knight</bio_url>
<bio>Christopher M. Knight is a seasoned entrepreneur who excels at creating & leading high-performance Internet startup companies with an obsession on delivering a fast and positive end-user driven experience. He and his team achieves this thanks to daily innovation, creative solutions based on user feedback, and a high commitment to exceed the expectations of their stakeholders. He attracts "A"-level achievers to quickly execute the companies objectives, implement quality control assurances -- while he steps out of the day-to-day operations to focus on the long-term client opportunities, relationship-building and new product development.</bio>
<article_count>21</article_count>
<personal_url>http://Christopher-Knight.com/about/</personal_url>
<blog_url>http://EzineArticles.com/blog</blog_url>
<photos>
<large>http://ezinearticles.com/members/mem_pics/Christopher-Knight_1296.jpg</large>
<medium>http://ezinearticles.com/members/mem_pics/medium/Christopher-Knight_1296.jpg</medium>
<small>http://ezinearticles.com/members/mem_pics/small/Christopher-Knight_1296.jpg</small>
</photos>
</author>
<response_info>
<time>2008-08-27 16:47:24</time>
<status>200</status>
<search>author</search>
<format>xml</format>
</response_info>
</ezinearticles_api_response>

Explanation of Returned Values

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

ValueRepresentsdata_amount
member_idThe unique ID for the authors account.
nameThe name of the author.
registeredThe registration date of the author.
countryThe country the author is from.extended
bio_urlThe URL to this authors EzineArticles Expert Extended Bio.
bioThe biography text entered by the author.
article_countThe number of live articles the author has.
businessInformation relating to the author's business.extended
business »companyThe name of the author's business.extended
business »url_1A URL related to the author's business.extended
business »url_2A URL related to the author's business.extended
business »url_3A URL related to the author's business.extended
personal_urlThe personal URL of the author.
blog_urlThe URL of the author's blog.
social_urlsThe author's social network URLs.extended
social_urls »linkedinThe author's LinkedIn URL.extended
social_urls »facebookThe author's Facebook URL.extended
social_urls »myspaceThe author's MySpace URL.extended
social_urls »twitterThe author's Twitter URL.extended
social_urls »friendfeedThe author's FriendFeed URL.extended
social_urls »youtubeThe author's YouTube URL.extended
isbnISBN numbers identifying books written or recommended by the author.extended
isbn »isbnThe author's ISBN.extended
isbn »isbnThe author's ISBN.extended
isbn »isbnThe author's ISBN.extended
photosA photo of the author in three sizes - small, medium, large.
photos »largeLarge-size version of the author's photo.
photos »mediumMedium-size version of the author's photo.
photos »smallSmall-size version of the author's photo.

Parameters for Top Authors Search

ParameterPossible ValuesPurposeDefault
searchauthors.topTo indicate a request for author information.Required
categoryTo specify in which category to look in.Required
subcategoryTo specify in which subcategory of a specified category to look in.

Top Authors Search Example

http://api.ezinearticles.com/api.php?search=authors.top&category=Writing-and-Speaking&response_format=xml&key={your api key}

The above API request will return something similar to this:

<ezinearticles_api_response>
<author>
<name>Christopher Knight</name>
<article_count>80</article_count>
<articles_url>http://EzineArticles.com/?expert=Christopher Knight&ecat=Writing-and-Speaking</articles_url>
<bio>Christopher M. Knight is a seasoned entrepreneur who excels at creating & leading high-performance Internet startup companies with an obsession on delivering a fast and positive end-user driven experience. He and his team achieves this thanks to daily innovation, creative solutions based on user feedback, and a high commitment to exceed the expectations of their stakeholders. He attracts "A"-level achievers to quickly execute the companies objectives, implement quality control assurances -- while he steps out of the day-to-day operations to focus on the long-term client opportunities, relationship-building and new product development.</bio>
<photos>
<large>http://ezinearticles.com/members/mem_pics/Christopher-Knight_1296.jpg</large>
<medium>http://ezinearticles.com/members/mem_pics/medium/Christopher-Knight_1296.jpg</medium>
<small>http://ezinearticles.com/members/mem_pics/small/Christopher-Knight_1296.jpg</small>
</photos>
</author>
<response_info>
<time>2008-08-27 16:47:24</time>
<status>200</status>
<search>authors.top</search>
<format>xml</format>
</response_info>
</ezinearticles_api_response>

Explanation of Top Authors Search Returned Values

ValueRepresents
nameThe name of the author.
article_countThe number of live articles the author has in specified category.
photosA photo of the author in three sizes - small, medium, large.
photos »largeLarge-size version of the author's photo.
photos »mediumMedium-size version of the author's photo.
photos »smallSmall-size version of the author's photo.

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.