Adgooroo API v2.0
Client Login
Home / TrademarkInsight / BiddingIncidentsByAdvertiser
Description
This method retrieves Bidding Incidents by advertiser. This is the equivalent to the Incidents By Advertiser report/Bidding Incidents tab in TM Insight. The advertiser, keyword, ad, ad display URL, ad destination URL, search engine, search volume, keyword CPC, keyword coverage and keyword avg rank are retrieved. The currency used in calculate CPC is set by the user in the website.

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 trademark group input here. Only one trademark group ID can be entered. Use the GetTMGroups method to retrieve a list of trademark group IDs.
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/TrademarkInsight/BiddingIncidentsByAdvertiser.api?searchengineid=1®ionid=1&keywordgroupid=1&startdate=5%2f5%2f2011&enddate=5%2f5%2f2011

Example Output
// XML Output
<?xml version="1.0"?>
<api_result>
  <api_class>TrademarkInsight</api_class>
  <api_method>BiddingIncidentsByAdvertiser</api_method>
  <quota_cost>0</quota_cost>
  <status>SUCCESS</status>
  <message />
  <value>
    <row>
      <keyword>reebok</keyword>
      <title>Reebok Hi-tops at Amazon</title>
      <line1>Save on Reebok hi-tops</line1>
      <line2>Free 2-Day Shipping w/ Amazon Prime</line2>
      <printedurl>Amazon.com/sports</printedurl>
      <destinationurls>http://www.amazon.com/s/?ie=UTF8&node=3375251&keywords=reebok hi-tops</destinationurls>
      <searchengine>Google United States</searchengine>
      <searchvolume>6303.0821917808219178082191781</searchvolume>
      <cpc>6303.0821917808219178082191781</cpc>
      <coverage>3.125</coverage>
      <avgRank>2</avgRank>
    </row>
  </value>
</api_result>


// JSON Output
{
  "api_class": "TrademarkInsight",
  "api_method": "BiddingIncidentsByAdvertiser",
  "quota_cost": 0,
  "status": 0,
  "message": null,
  "value": {
    "row": [
      {
        "keyword": "reebok",
        "title": "Reebok Hi-tops at Amazon",
        "line1": "Save on Reebok hi-tops",
        "line2": "Free 2-Day Shipping w/ Amazon Prime",
        "printedurl": "Amazon.com/sports",
        "destinationurls": "http://www.amazon.com/s/?ie=UTF8&node=3375251&keywords=reebok hi-tops",
        "searchengine": "Google United States",
        "searchvolume": 6303.0821917808219178082191781,
        "cpc": 6303.0821917808219178082191781,
        "coverage": 3.125,
        "avgRank": 2.0
      }
    ]
  }
}


// CSV Output
keyword,title,line1,line2,printedurl,destinationurls,searchengine,searchvolume,cpc,coverage,avgRank
reebok,Reebok Hi-tops at Amazon,Save on Reebok hi-tops,Free 2-Day Shipping w/ Amazon Prime,Amazon.com/sports,http://www.amazon.com/s/?ie=UTF8&node=3375251&keywords=reebok hi-tops,Google United States,6303.0821917808219178082191781,6303.0821917808219178082191781,3.125,2