EzineArticles API

EzineArticles API - Search Categories

Your application may need to retrieve a list of EzineArticles categories or subcategories.

« Return to API home

Parameters for Categories Search

ParameterPossible ValuesPurposeDefault
searchcategoriesTo indicate a request for category information.Required
categoryTo look up subcategories of a known category.

Categories Search Example

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

The above API request will return the subcategories of the Writing and Speaking category:

<ezinearticles_api_response>
<category>
<name>Writing-and-Speaking</name>
<subcategory>Writing</subcategory>
<subcategory>Copywriting</subcategory>
<subcategory>Public-Speaking</subcategory>
<subcategory>Writing-Articles</subcategory>
<subcategory>Teleseminars</subcategory>
<subcategory>Book-Marketing</subcategory>
<subcategory>Article-Marketing</subcategory>
</category>
<response_info>
<time>2008-08-27 16:36:49</time>
<status>200</status>
<search>categories</search>
<format>xml</format>
</response_info>
</ezinearticles_api_response>

Explanation of Categories Search Returned Values

ValueRepresents
nameCategory name.
subcategorySubcategory of the category.

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.