Adgooroo API v2.0
Client Login
Home / SEMInsight / GetNaturalAdvertiserData
Description
This method retrieves natural data for an advertiser, displayed by keyword. This is the equivalent to the SEO Advertiser Detail Report/Keyword Rankings tab in SEM Insight. The landing page, rank, clicks, weekly/monthly change in rank, and maximum rank for each keyword are retrieved.

Info
Version:2
Quota Point Cost:20

Parameters
InputNameRequiredTypeDescription
searchengineidyesInt32Data will be returned only for the search engine input here. Only one search engine ID can be entered. Use the GetSearchEngines method to retrieve a list of search engine IDs.
regionidyesInt32Data will be returned only for the region input here. Only one region ID can be entered. Use the GetRegions method to retrieve a list of region IDs.
keywordgroupidyesInt32Data will be returned only for the keyword group input here. Only one keyword group ID can be entered. Use the GetKeywordGroups method to retrieve a list of keyword group IDs.
advertisernameyesStringThe domain name of the advertiser for which you want data. Example: AdGooroo.com
showallkeywordsnoBooleanWhen set to "true", all keywords in the SEM Insight database for which the selected advertiser has been found in the top 100 natural search results will be retrieved, even if the keyword is not monitored in a keyword group.
enddatenoDateTimeThe end date for this report. Note: This value must be less than or equal to yesterday. The start date will be 7 days earlier.
outputnoStringThis parameter specifies the output format of the API call. Possible values are XML, CSV or JSON. Default is XML.
Note: Calling this API method will count against your monthly usage quota

Example Request
http://api.adgooroo.com/v2/SEMInsight/GetNaturalAdvertiserData.api?searchengineid=1®ionid=1&keywordgroupid=1&advertisername=adgooroo.com&showallkeywords=true&enddate=5%2f5%2f2011

Example Output
// XML Output
<?xml version="1.0"?>
<api_result>
  <api_class>SEMInsight</api_class>
  <api_method>GetNaturalAdvertiserData</api_method>
  <quota_cost>0</quota_cost>
  <status>SUCCESS</status>
  <message />
  <value>
    <row>
      <keyword>my keyword 1</keyword>
      <url>http://www.mydomain.com</url>
      <traffic>1792</traffic>
      <clicks>50</clicks>
      <rank>29</rank>
      <maxrank>24</maxrank>
      <monthlychange>1</monthlychange>
    </row>
  </value>
</api_result>


// JSON Output
{
  "api_class": "SEMInsight",
  "api_method": "GetNaturalAdvertiserData",
  "quota_cost": 0,
  "status": 0,
  "message": null,
  "value": {
    "row": [
      {
        "keyword": "my keyword 1",
        "url": "http://www.mydomain.com",
        "traffic": 1792.0,
        "clicks": 50.0,
        "rank": 29.0,
        "maxrank": 24.0,
        "monthlychange": 1.0
      }
    ]
  }
}


// CSV Output
keyword,url,traffic,clicks,rank,maxrank,monthlychange
my keyword 1,http://www.mydomain.com,1792,50,29,24,1