advertiser

Get a list of users with the “advertiser” type.

Request format

Note

https://adfox.yandex.com/api/v1
  ? object=account
  & action=list
  & actionObject=advertiser
  & actionObjectID=<integer>

actionObjectID

To get data for only one advertiser, specify their ID.

Default value: 0 (display the list of all users with the “advertiser” type).

* Required

Response format

<response>
<status>
  <code>{integer}</code>
</status>
<result>
<data>
  <row0>
    <ID>{integer}</ID>
    <account>{string}</account>
    <company>{string}</company>
    <firstName>{string}</firstName>
    <lastName>{string}</lastName>
    <eMail>{string}</eMail>
    <country>{string}</country>
    <state/>
    <city>{string}</city>
    <ZIPCode>{string}</ZIPCode>
    <address1>{string}</address1>
    <address2>{string}</address2>
    <phone>{string}</phone>
    <fax/>
    <dateAdded>{string}</dateAdded>
    <isByAssistantCreated>{integer}</isByAssistantCreated>
  </row0>
</data>
</result>
</response>

Response parameters

`code`	Request processing status. If the value is `0`, the request was completed successfully. For the key, see Error handling.
`rows`	Number of items in the response tree.
`rowN`	Item number in the response tree, where N is a number from 0 to rows-1 (where `rows` is the total number of items in the response).
`ID`	Unique ID of the user with the “advertiser” type.
`account`	Advertiser's account.
`company`	Company name.
`firstName`	Advertiser's name.
`eMail`	Email address that the advertiser's access is registered to.
`country`	Country.
`state`	Region.
`city`	City.
`ZIPCode`	Postal code.
`address1`	Address.
`address2`	Address (continued).
`phone`	Phone number.
`fax`	Fax.
`dateAdded`	Add date.
`isByAssistantCreated`	User with the “assistant” type is created.

Sample request and response

Request:

https://adfox.yandex.com/api/v1?object=account&action=list&actionObject=advertiser

Response:

<response>
<status>
  <code>0</code>
</status>
<result>
<data>
  <row0>
    <ID>203478</ID>
    <account>ivanov</account>
    <company>Example LLC</company>
    <firstName>Ivan</firstName>
    <lastName>Ivanov</lastName>
    <eMail>ivanov@yandex.com</eMail>
    <country>Russian Federation</country>
    <state/>
    <city>Moscow</city>
    <ZIPCode>123456</ZIPCode>
    <address1>ul. Stroiteley, 3</address1>
    <address2>room 305</address2>
    <phone>+7 (495) 555-55-55</phone>
    <fax/>
    <dateAdded>0000-00-00</dateAdded>
    <isByAssistantCreated>0</isByAssistantCreated>
  </row0>
</data>
</result>
</response>

Other actions with the object

See more actions with the advertiser object:

Was the article helpful?

activeBanners

assistant