Adgooroo API v2.0
Client Login
Home / TrademarkInsight / SetTMGroups
Description
This method creates and deletes trademark groups. This method can also add or delete keywords in an existing keyword group.

Info
Version:2
Quota Point Cost:20

Parameters
InputNameRequiredTypeDescription
keywordgroupidnoStringThe ID of the Trademark group you want to create/delete/modify. Use the GetKeywordGroups method to retrieve a list of keyword group IDs. If you are creating a new keyword group, leave this field blank.
deletegroupnoBooleanType in "true" to delete the trademark group specified in the KeywordGroupID field. Warning: this cannot be undone
groupnamenoStringThe name of the trademark group to be created. This input can also be used to modify the name of an existing trademark group.
targetidsnoStringUse this input to set/modify a trademark group's target. Multiple TargetIDs can be entered if they are seperated by commas. A target is a combination of search engine and region. Every unique combination of search engine and region is assigned a target ID. Use the GetTargets method to retrieve a list of target IDs.
keywordsnoStringThe list of keywords to be monitored, seperated by commas.
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/SetTMGroups.api?keywordgroupid=1234&deletegroup=true&groupname=Cars&targetids=12%2c34%2c56&keywords=cars%2ctrucks%2ctrains

Example Output
// XML Output
<?xml version="1.0"?>
<api_result>
  <api_class>TrademarkInsight</api_class>
  <api_method>SetTMGroups</api_method>
  <quota_cost>0</quota_cost>
  <status>SUCCESS</status>
  <message />
  <value>
    <row>
      <status>The group information has been changed</status>
    </row>
  </value>
</api_result>


// JSON Output
{
  "api_class": "TrademarkInsight",
  "api_method": "SetTMGroups",
  "quota_cost": 0,
  "status": 0,
  "message": null,
  "value": {
    "row": [
      {
        "status": "The group information has been changed"
      }
    ]
  }
}


// CSV Output
status
The group information has been changed