Plurals
Plurals
Parameter name: plurals
Default: no
Values: 1,0 (on,off)
Description: Returns plural results of the keyword queried. E.g. a query for "airport" will return "airports" within the result set.
Note: Each plural query uses two API credits, as opposed to a single API credit in a standard query.
Database (db) needs to be specified within the query string.
Example: The following query returns the results with plurals for the word airport:
http://api.keyworddiscovery.com/query.php?query=airport&db=premium&plurals=1
Results
Results are returned as XML. A simple example:
http://api.keyworddiscovery.com/query.php?query=airport&db=premium&plurals=1
This request queries the premium database for the search term "airport" including any plural forms. By default, compact result display is turned on. The XML returned from this query is shown below:
<?xml version="1.0" encoding="utf-8"?>
<results compact="true" maximum="10" offset="0" plural="true" query="airport">
<r m="50058" q="airport" t="29841" />
<r m="12610" q="airports" t="7517" />
<r m="6240" q="airport parking" t="3720" />
<r m="6061" q="manchester airport" t="3613" />
<r m="5412" q="orlando international airport" t="3226" />
<r m="4991" q="airport security" t="2975" />
<r m="4590" q="jfk airport" t="2736" />
<r m="4081" q="dfw airport" t="2433" />
<r m="3610" q="bwi airport" t="2152" />
<r m="3608" q="atlanta airport" t="2151" />
<total_found />
</results>
Each result is returned as an 'r' tag with the following attributes
- q - query string
- t - total search
- m - monthly estimate. (takes into account a percentage of data that Keyword discovery has in relation to the total number searches done world wide.)
NOTE: Data provided on a URL has to be correctly URL encoded.