Help Center Manage Your Account AdSpeed API

Group

Documentation for API methods to manage one or multiple groups.

API Version

1.4.9 (build 20250422). This page was updated on Fri, 23 May 25 22:26:38 -0400. Since the API method and response format can change from one version to another, you should check this page for updates.

API Methods - Group

AS.Groups.getCounts

Return the number of active, deleted and total groups in your account.
Additional Parameters
  • None
Sample Request
Sample Response
<Groups total="20" active="20" deleted="0"/>

AS.Groups.getList

Return the list of groups in your account.
Additional Parameters
ParameterRequiredDescription
statusOptional
Default value is empty		Filter groups with this status. Possible value: 'active','pending','archived'
perpageOptional
Default value is "10"		The number of items per page. Maximum value is 100.
pageOptional
Default value is "1"		The page number
Sample Request
Sample Response
<Groups total="20" page="1" numpage="5" perpage="4">
  <Group id="532" name="top" status="active"/>
  <Group id="2600" name="Test Group" status="active"/>
  <Group id="9252" name="New Group 1613428659" status="active"/>
  <Group id="9253" name="New Group 1613429765" status="active"/>
</Groups>

AS.Groups.create

Create a new group in your account. Submit via POST. Limit 50 calls/day.
Additional Parameters
ParameterRequiredDescription
nameRequiredThe name of this group
Sample Request
Sample Response
<Group id="999" name="SampleGroup" status="active"></Group>

AS.Group.getInfo

Return the list of linked ads for this group
Additional Parameters
ParameterRequiredDescription
groupRequiredThe group ID
tokenRequiredThe authentication MD5 hash generated from concatenating [Group ID][Group Name]
Sample Request
Sample Response
<Group id="2600" name="Test Group" status="active">
  <Description>Test Group For Demo</Description>
  <Ads/>
</Group>

AS.Group.getStats

Return the stats for this group. Limit 50 calls/day.
Additional Parameters
ParameterRequiredDescription
groupRequiredThe group ID
tokenRequiredThe authentication MD5 hash generated from concatenating [Group ID][Group Name]
metricRequiredThe type of metric can be "impressions", "clicks", "revenue", "expense", "events"
periodRequiredThe time period can be "hourly", "daily", "weekly", "monthly"
rangeOptional
Default value is empty		The time range can be specified as Start|End using syntax YYYY.MM.DD|YYYY.MM.DD
Sample Request
Sample Response
<StatRows generated="[Time Stamp]" title="[Entity Name]">
  <StatRow>
    <Monthly>January 2024</Monthly>
    <Unique_Impression>3,156</Unique_Impression>
    <Gross_Impression>6,565</Gross_Impression>
    <Unique_over_Gross_Impression>48.07%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>More Rows...</StatRow>
  <StatRow>
    <Monthly>Total</Monthly>
    <Unique_Impression>57,417</Unique_Impression>
    <Gross_Impression>114,979</Gross_Impression>
    <Unique_over_Gross_Impression>49.94%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>Average</Monthly>
    <Unique_Impression>4,785</Unique_Impression>
    <Gross_Impression>9,582</Gross_Impression>
    <Unique_over_Gross_Impression>49.94%</Unique_over_Gross_Impression>
  </StatRow>
</StatRows>

AS.Group.getBreakdownStats

Return the breakdown stats of linked ads for this group. Limit 50 calls/day.
Additional Parameters
ParameterRequiredDescription
groupRequiredThe group ID
tokenRequiredThe authentication MD5 hash generated from concatenating [Group ID][Group Name]
subcategoryRequiredThe type of subcategory can be "ad"
metricRequiredThe type of metric can be "impressions", "clicks", "events", "impclkctr", "uniqueimpressions", "uniqueclicks", "uniqueimpclkctr"
rangeRequiredThe time range can be "today", "yesterday", "last7days", "lastmonsun", "lastmonfri", "last31days", "thismo", "lastmo"
Sample Request
Sample Response
<StatRows generated="Mon, 01 Jan 24 11:11:11 -0400">
  <StatRow>
    <Name>Ad-ABC</Name>
    <Impressions>7,443</Impressions>
    <Clicks>0</Clicks>
    <CTR>0.0000</CTR>
  </StatRow>
  <StatRow>
    <Name>Ad-DEF</Name>
    <Impressions>4,843</Impressions>
    <Clicks>0</Clicks>
    <CTR>0.0000</CTR>
  </StatRow>
  <StatRow>More Rows...</StatRow>
</StatRows>

AS.Group.getVisitorStats

Return the visitor report for this group. Limit 50 calls/day.
Additional Parameters
ParameterRequiredDescription
groupRequiredThe group ID
tokenRequiredThe authentication MD5 hash generated from concatenating [Group ID][Group Name]
metricRequiredThe type of metric can be "countries", "continents", "areas", "timezones", "regions", "languages", "browsermajor", "browserminor", "platform", "ua", "screen", "cookie"
rangeRequiredThe time range can be "last7days", "last31days", "thismo", "lastmo", "alltime"
Sample Request
Sample Response
<StatRows generated="[Time Stamp]" title="[Entity Name]" range="Alltime" metric="countries">
  <StatRow>
    <Rank>1</Rank>
    <Country>United States</Country>
    <Flag/>
    <Percentage>95%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>2</Rank>
    <Country>Canada</Country>
    <Flag/>
    <Percentage>5%</Percentage>
  </StatRow>
</StatRows>

AS.Group.edit

Edit a setting of a group. Submit via POST.
Additional Parameters
ParameterRequiredDescription
groupRequiredThe group ID
tokenRequiredThe authentication MD5 hash generated from concatenating [Group ID][Group Name]
nameOptional
Default value is empty		Sets the new group name
Sample Request
Sample Response
<Group id="2600" name="Test Group" status="active">
  <Description>Test Group For Demo</Description>
  <Ads/>
</Group>

AS.Group.addRestriction

Add a restriction to this group
Additional Parameters
ParameterRequiredDescription
groupRequiredThe group ID
tokenRequiredThe authentication MD5 hash generated from concatenating [Group ID][Group Name]
logicOptional
Default value is "and"		The logical operator for this restriction. Possible value: "and", "or"
typeRequiredThe type of restriction. Possible value: "totalimp", "monthimp"
compareOptional
Default value is "show"		The comparison operator for this restriction. Possible value: "show", "hide"
valueRequiredThe value of this restriction. Please contact us for syntax/format.
Sample Request
Sample Response
<Restrictions entity="[Group] Sample Group">#ID Conditions
---------------------------------------------------------
#123456 Maximum 5000 gross impressions AND
#654321 Show on Saturday, Sunday
</Restrictions>

AS.Group.deleteRestriction

Delete an existing restriction of this group
Additional Parameters
ParameterRequiredDescription
groupRequiredThe group ID
tokenRequiredThe authentication MD5 hash generated from concatenating [Group ID][Group Name]
restrictionRequiredThe restriction #ID
Sample Request
Sample Response
<Restrictions entity="[Group] Sample Group"># Conditions
---------------------------------------------------------
#654321 Show on Saturday, Sunday
</Restrictions>

Other Articles in AdSpeed API

Documentation to use AdSpeed API to integrate AdSpeed AdServer into your own platform.

Cannot find an answer for your question? Ask our Customer Care team

Related

© 2025 AdSpeed® adspeed.com
About | Products | Contact Us | Sitemap | Terms of Service | Privacy Statement