API get programmes

From Wiki

Jump to: navigation, search

Contents

GET programmes

Publishers can check programmatically, with which programmes they currently have an active, pending, suspended, rejected or not joined relationship. They can also check the whole program list, and filter by program region/country.

Who can use it?

Publishers

How to call it

https://api.awin.com/publishers/45628/programmes (lists all active and visible programmes)
https://api.awin.com/publishers/45628/programmes?relationship=joined (lists all active and visible programmes that the publisher account has an active relationship with, possible values are joined, pending, suspended, rejected, notjoined)
https://api.awin.com/publishers/45628/programmes?countryCode=IE (lists all active and visible programmes from a certain country, defined by the country code)
https://api.awin.com/publishers/45628/programmes?includeHidden=true returns all of the active and also hidden programmes the publisher is joined to

Add the parameter 'accessToken' to provide your access key as described in API authentication and authorization.

How the response looks

[
  {
    "description": "Awin programme description.",
    "id": 3,
    "name": "Affiliate Window",
    "displayUrl": "http://www.affiliatewindow.com",
    "clickThroughUrl": "http://www.awin1.com/awclick.php?mid=3&id=267235",
    "logoUrl": "http://www.affiliatewindow.com/logos/3/logo.gif",
    "primaryRegion": {
      "name": "United Kingdom",
      "countryCode": "GB"
    }
    "currencyCode": "GBP"
    "status": "Active",
    "validDomains": [
 {
        "domain": "www.awin1.com"
      },
      {
        "domain": "www.awin2.com"
      }
]
  },
  {
    "description": "Swerve programme description.",
    "id": 4,
    "name": "Swerve",
    "displayUrl": ": "http://www.swerve.co.uk",
    "clickThroughUrl": "http://www.awin1.com/awclick.php?mid=4&id=267235",
    "logoUrl": "http://www.affiliatewindow.com/logos/4/logo.gif",
    "primaryRegion": {
      "name": "United Kingdom",
      "countryCode": "GB"
    }
      "currencyCode": "GBP",
      "status": "Active",
      "validDomains": [
 {
        "domain": "www.swerve.com"
      },
      {
        "domain": "www.swerve1.com"
      }
]
  },
()

Which datafields do we provide?

field name description
description advertiser programme description
displayUrl programme display URL
logoUrl URL to the logo of the programme
clickThroughUrl programme click-through URL
id advertiser programme ID
name programme name
currencyCode ISO code of the currency of the programme
primaryRegion programme primary region
status programme status. Can be active or hidden
validDomains list of the programme valid domains

Privacy

Due to new European legislation regarding how websites store information about you, AWIN is updating its privacy policy. You can see the new version of our policy here. If you would like to see the information we capture on this website, please click here for further details. In order to accept cookies on this site please click the 'I ACCEPT' button