Adgooroo API v2.0
Client Login
Home / SEMInsight / GetBulkAdvertiserData
Description
This method retrieves the same data as the GetAdvertiserData method, but returns data for the top 20 advertisers for the selected keyword group(s). After you select your inputs, call the API and retrieve a ReportID. Use the ReportID in the CheckBulkAdvertiserDataProgress method to retrieve the data. The currency used in calculate Cost and CPC is set by the user in the website.

Info
Version:2
Quota Point Cost:200

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.
keywordgroupidsyesStringThe data will be limited to the keyword group IDs input here. Multiple keyword group IDs can be entered if they are separated by commas. Keyword group IDs can be retrieved using the GetKeywordGroups method.
startdatenoDateTimeThe start date for this report. Note: This value must be a within a maximum of 30 days of the end date.
enddatenoDateTimeThe end date for this report. Note: This value must be less than or equal to yesterday.
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/GetBulkAdvertiserData.api?searchengineid=1®ionid=1&keywordgroupids=1&startdate=5%2f5%2f2011&enddate=5%2f5%2f2011

Example Output
// XML Output
<?xml version="1.0"?>
<api_result>
  <api_class>SEMInsight</api_class>
  <api_method>GetBulkAdvertiserData</api_method>
  <quota_cost>0</quota_cost>
  <status>SUCCESS</status>
  <message />
  <value>
    <row>
      <keyword>keyword 1</keyword>
      <coverage>100</coverage>
      <avgrank>6.4</avgrank>
      <totalsearch>102</totalsearch>
      <traffic>93.11</traffic>
      <missedtraffic>2.606</missedtraffic>
      <clicks>0.78</clicks>
      <ctr>0.034</ctr>
      <cpc>0.379</cpc>
      <cost>0.262</cost>
    </row>
  </value>
</api_result>


// JSON Output
{
  "api_class": "SEMInsight",
  "api_method": "GetBulkAdvertiserData",
  "quota_cost": 0,
  "status": 0,
  "message": null,
  "value": {
    "row": [
      {
        "keyword": "keyword 1",
        "coverage": 100.0,
        "avgrank": 6.4,
        "totalsearch": 102.0,
        "traffic": 93.11,
        "missedtraffic": 2.606,
        "clicks": 0.78,
        "ctr": 0.034,
        "cpc": 0.379,
        "cost": 0.262
      }
    ]
  }
}


// CSV Output
keyword,coverage,avgrank,totalsearch,traffic,missedtraffic,clicks,ctr,cpc,cost
keyword 1,100,6.4,102,93.11,2.606,0.78,0.034,0.379,0.262