Related Categories

The Related Categories API query will retreive a list of related categories, based on your search query. The categories are taken from our industry keywords database.

Parameters:

Accepted parameters are offset and limit. Please see their respective manual pages for more information.

Results

Results are returned as XML. A simple example:

http://api.keyworddiscovery.com/categories.php?q=free

This request will find keywords related to "free".

The XML returned from this query is shown below:

<?xml version="1.0" encoding="utf-8"?>
      <results total="158">
       <r>/Computers/Software/Operating_Systems/Microkernel/Mach/GNU_Hurd</r>
       <r>/Computers/Software/Operating_Systems/Unix/Software</r>
       <r>/Computers/Software/Operating_Systems/Microkernel/Mach</r>
       <r>/Computers/Open_Source/Advocacy</r>
       <r>/Society/Issues/Intellectual_Property/Patents</r>
       <r>/Computers/Open_Source/Licenses</r>
       <r>/Computers/Internet/On_the_Web/Free_Stuff/Link_Pages</r>
       <r>/Computers/Internet/On_the_Web/Free_Stuff</r>
       <r>/Society/Issues/Intellectual_Property/Organizations</r>
       <r>/Computers/Internet/Web_Design_and_Development/Promotion/Pay-Per-Click_Advertising/Search_Engines/Small-Scale</r>
      </results>
      

The total value is the number of results available. You can fetch the next page of results by using the offset and limit parameters.

Example Using Offset & Limit

In the above example, there are 158 results available. We could fetch 100 at a time to save on requests.

http://api.keyworddiscovery.com/categories.php?q=free&offset=0&limit=100

This request will find keywords related to "free" and fetch the first 100 results.

The XML returned from this query is shown below (note that the response has been truncated):

<?xml version="1.0" encoding="utf-8"?>
        <results total="158">
         <r>/Computers/Software/Operating_Systems/Microkernel/Mach/GNU_Hurd</r>
         <r>/Computers/Software/Operating_Systems/Unix/Software</r>
         <r>/Computers/Software/Operating_Systems/Microkernel/Mach</r>
         <r>/Computers/Open_Source/Advocacy</r>
         <r>/Society/Issues/Intellectual_Property/Patents</r>
         <r>/Computers/Open_Source/Licenses</r>
         <r>/Computers/Internet/On_the_Web/Free_Stuff/Link_Pages</r>
         <r>/Computers/Internet/On_the_Web/Free_Stuff</r>
         <r>/Society/Issues/Intellectual_Property/Organizations</r>
         <r>/Computers/Internet/Web_Design_and_Development/Promotion/Pay-Per-Click_Advertising/Search_Engines/Small-Scale</r>
         <r>/Computers/Open_Source/Articles</r>
         <r>/Home/Personal_Finance/Software</r>
         <r>/Science/Social_Sciences/Geography/Geographic_Information_Systems/Software/Map_Servers</r>
         <r>/Computers/Internet/On_the_Web/Free_Stuff/Mailing_Lists</r>
         <r>/Computers/Software/Operating_Systems/Microkernel</r>
         <r>/Computers/Graphics/Clip_Art/Pictures</r>
         <r>/Computers/Open_Source/Software</r>
         <r>/Computers/Open_Source/Organizations</r>
        ...
         <r>/Kids_and_Teens/School_Time/Reference_Tools</r>
         <r>/Kids_and_Teens/International</r>
        </results>