GET /adspaces

Updated on
 
Retrieves all adspace items related to the publisher account. See adspaceItem element definition in WSDL/XSD
This resource requires connectid, nonce, date and signature for authentication. See Authentication documentation for REST and SOAP. Passing authentication information as query parameters for REST is supported.

Resource URL

XML: https://api.zanox.com/xml/2011-03-01/adspaces
JSON: https://api.zanox.com/json/2011-03-01/adspaces

Parameters

items
optional

number of items in the result set [1..n]

Value Type: integer
Example Values 1 (default = 10; maximum = 50) 

page
optional

page position [0..n] 

Value Type: integer
Example Values 1 (default: 0)

callback
optional

Supported if format is JSON. Returns the name of the JS function the result is wrapped in.

Value Type: String
Example Values 

Example Request 

REST authentication information must be included in request headers or added as query parameters

https://api.zanox.com/xml/2011-03-01/adspaces?items=10

Example Response



<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GetAdspacesResponse xmlns="http://api.zanox.com/namespace/2011-03-01/">
  <page>0</page>
  <items>1</items>
  <total>1</total>
  <adspaceItems>
    <adspaceItem id="1455404">
      <name>My Adspace</name>
      <url>www.TestAdspace1RnDU9.de</url>
      <description></description>
      <adspaceType>website</adspaceType>
      <visitors>123</visitors>
      <impressions>1234</impressions>
      <scope>private</scope>
      <regions>
        <region>HK</region>
        <region>DE</region>
      </regions>
      <categories>
        <category id="53">nternationale Aktivitõten</category>
        <category id="43">Other</category>
      </categories>
      <language>de</language>
      <checkNumber>76528549</checkNumber>
    </adspaceItem>
  </adspaceItems>
</GetAdspacesResponse>

 

Resource Information

Rate Limited? No
Authentication Requires signature. See
REST Authentication
SOAP Authentication
Response Formats json, xml
HTTP Methods GET
Resource family adspaceItems
Response Object adspaceItem
API Version 2011-03-01