Awin

Awin Reports API

Aggregated performance reports.

GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /publishers/{publisherId}/reports/advertiser Report a publisher's performance by advertiser · Advertiser performance report for a publisher #
Ask an LLM
“Which advertisers earned me the most as a publisher over a date range?”
“Can I break my publisher performance down per advertiser for one region?”
Tell an agent
Report publisher {publisherId}'s performance by advertiser from {startDate} to {endDate} in region {region}.
Break down publisher {publisherId}'s results per advertiser for {region} between {startDate} and {endDate} in timezone {timezone}.
GET /publishers/{publisherId}/reports/creative Report a publisher's performance by creative · Creative performance report for a publisher #
Ask an LLM
“Which banners and creatives drove the most clicks and impressions on my publisher site?”
“What impressions did each creative I ran get in a given region?”
Tell an agent
Report publisher {publisherId}'s clicks, impressions and transactions by creative from {startDate} to {endDate} in region {region}.
Rank the creatives publisher {publisherId} ran in {region} between {startDate} and {endDate}.
GET /publishers/{publisherId}/reports/campaign Report a publisher's performance by campaign · Campaign performance report for a publisher #
Ask an LLM
“Which campaigns brought me the most clicks and sales as a publisher?”
“Can I see my publisher campaign results by day, month or year?”
Tell an agent
Report publisher {publisherId}'s clicks and transactions by campaign from {startDate} to {endDate}.
Show publisher {publisherId}'s campaign performance per advertiser between {startDate} and {endDate} in {timezone}.
GET /advertisers/{advertiserId}/reports/publisher Report an advertiser's performance by publisher · Publisher performance report for an advertiser #
Ask an LLM
“Which publishers drive the most sales for my advertiser programme?”
“What did each affiliate partner deliver for my brand last month?”
Tell an agent
As advertiser {advertiserId}, give me totals for each affiliate partner over {startDate} to {endDate}, timezone {timezone}.
Rank the publishers working for advertiser {advertiserId} between {startDate} and {endDate} ({timezone}).
GET /advertisers/{advertiserId}/reports/creative Report an advertiser's performance by creative · Creative performance report for an advertiser #
Ask an LLM
“Which of my advertiser creatives get the most impressions across publishers?”
“How do I compare clicks and transactions for each banner I supply to affiliates?”
Tell an agent
For my brand account {advertiserId}, compare how each banner I gave affiliates performed in {region} from {startDate} to {endDate}.
Rank the creatives advertiser {advertiserId} supplied in {region} between {startDate} and {endDate}.
GET /advertisers/{advertiserId}/reports/campaign Report an advertiser's performance by campaign · Campaign performance report for an advertiser #
Ask an LLM
“Which of my advertiser campaigns drew the most clicks and sales from publishers?”
“Can I see my advertiser campaign results broken out per publisher by month?”
Tell an agent
Report advertiser {advertiserId}'s clicks and transactions by campaign from {startDate} to {endDate}.
Break my brand account {advertiserId}'s campaigns out by affiliate partner from {startDate} to {endDate}, timezone {timezone}.

Documentation

📖
Documentation
https://help.awin.com/apidocs/introduction-1
📖
APIReference
https://help.awin.com/apidocs/returns-information-about-accounts-for-a-given-user
📖
Documentation
https://help.awin.com/apidocs/returns-a-list-of-transactions-for-a-given-publisher
📖
APIReference
https://help.awin.com/apidocs/returns-a-list-of-transactions-for-a-given-advertiser
📖
Documentation
https://help.awin.com/apidocs/get-advertiser-performance-report
📖
APIReference
https://help.awin.com/apidocs/get-publisher-performance-report
📖
Documentation
https://help.awin.com/apidocs/gets-an-array-of-commission-groups-for-an-advertiser
📖
Documentation
https://help.awin.com/apidocs/get-program-information-for-publisher-by-relationship-and-optionally-filter-by-country
📖
APIReference
https://help.awin.com/apidocs/get-program-information-details-for-publisher

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/awin-affiliate/refs/heads/main/openapi/awin-affiliate-reports-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/awin-affiliate/refs/heads/main/overlays/awin-affiliate-reports-api-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/awin-affiliate/refs/heads/main/collections/awin-affiliate.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/awin-affiliate/refs/heads/main/collections/awin-affiliate.opencollection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/awin-affiliate:awin-affiliate-reports-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

awin-affiliate-reports-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Awin Reports API
  description: Documented public REST API for the Awin global affiliate marketing network.
  termsOfService: https://www.awin.com/gb/legal
  contact:
    name: Awin API Support
    url: https://help.awin.com/apidocs/introduction-1
  version: '1.0'
servers:
- url: https://api.awin.com
  description: Awin API (HTTPS only)
security:
- bearerAuth: []
tags:
- name: Reports
  description: Aggregated performance reports.
paths:
  /publishers/{publisherId}/reports/advertiser:
    get:
      operationId: getPublisherAdvertiserReport
      tags:
      - Reports
      summary: Advertiser performance report for a publisher
      description: Aggregated performance for a publisher, broken down by advertiser.
      parameters:
      - $ref: '#/components/parameters/publisherId'
      - $ref: '#/components/parameters/accessToken'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/region'
      - $ref: '#/components/parameters/timezoneOptional'
      - $ref: '#/components/parameters/dateTypeReport'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerformanceRow'
  /publishers/{publisherId}/reports/creative:
    get:
      operationId: getPublisherCreativeReport
      tags:
      - Reports
      summary: Creative performance report for a publisher
      description: Aggregated transactions, clicks, and impressions by creative for a publisher.
      parameters:
      - $ref: '#/components/parameters/publisherId'
      - $ref: '#/components/parameters/accessToken'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/region'
      - $ref: '#/components/parameters/timezoneOptional'
      - $ref: '#/components/parameters/dateTypeReport'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerformanceRow'
  /publishers/{publisherId}/reports/campaign:
    get:
      operationId: getPublisherCampaignReport
      tags:
      - Reports
      summary: Campaign performance report for a publisher
      description: Aggregated clicks and transactions by campaign and advertiser for a publisher, listable in day, month, or year intervals.
      parameters:
      - $ref: '#/components/parameters/publisherId'
      - $ref: '#/components/parameters/accessToken'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/timezoneOptional'
      - $ref: '#/components/parameters/dateTypeReport'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerformanceRow'
  /advertisers/{advertiserId}/reports/publisher:
    get:
      operationId: getAdvertiserPublisherReport
      tags:
      - Reports
      summary: Publisher performance report for an advertiser
      description: Aggregated performance for an advertiser, broken down by publisher.
      parameters:
      - $ref: '#/components/parameters/advertiserId'
      - $ref: '#/components/parameters/accessToken'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/timezone'
      - $ref: '#/components/parameters/dateTypeReport'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerformanceRow'
  /advertisers/{advertiserId}/reports/creative:
    get:
      operationId: getAdvertiserCreativeReport
      tags:
      - Reports
      summary: Creative performance report for an advertiser
      description: Aggregated transactions, clicks, and impressions by creative for an advertiser.
      parameters:
      - $ref: '#/components/parameters/advertiserId'
      - $ref: '#/components/parameters/accessToken'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/region'
      - $ref: '#/components/parameters/timezoneOptional'
      - $ref: '#/components/parameters/dateTypeReport'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerformanceRow'
  /advertisers/{advertiserId}/reports/campaign:
    get:
      operationId: getAdvertiserCampaignReport
      tags:
      - Reports
      summary: Campaign performance report for an advertiser
      description: Aggregated clicks and transactions by campaign and publisher for an advertiser, listable in day, month, or year intervals.
      parameters:
      - $ref: '#/components/parameters/advertiserId'
      - $ref: '#/components/parameters/accessToken'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/timezoneOptional'
      - $ref: '#/components/parameters/dateTypeReport'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerformanceRow'
components:
  parameters:
    accessToken:
      name: accessToken
      in: query
      required: true
      description: User-level access token (also accepted as an Authorization Bearer header).
      schema:
        type: string
    publisherId:
      name: publisherId
      in: path
      required: true
      description: The publisher account identifier.
      schema:
        type: integer
    timezone:
      name: timezone
      in: query
      required: true
      description: Timezone identifier, e.g. UTC, Europe/London, US/Eastern.
      schema:
        type: string
    dateTypeReport:
      name: dateType
      in: query
      required: false
      description: Which date to aggregate the report on.
      schema:
        type: string
        enum:
        - transaction
        - validation
        default: transaction
    endDate:
      name: endDate
      in: query
      required: true
      description: End date, format yyyy-MM-dd.
      schema:
        type: string
        format: date
    timezoneOptional:
      name: timezone
      in: query
      required: false
      description: Timezone identifier, defaults to UTC.
      schema:
        type: string
        default: UTC
    region:
      name: region
      in: query
      required: true
      description: Region code. One of AT, AU, BE, BR, BU, CA, CH, DE, DK, ES, FI, FR, GB, IE, IT, NL, NO, PL, SE, US.
      schema:
        type: string
    startDate:
      name: startDate
      in: query
      required: true
      description: Start date, format yyyy-MM-dd.
      schema:
        type: string
        format: date
    advertiserId:
      name: advertiserId
      in: path
      required: true
      description: The advertiser account identifier.
      schema:
        type: integer
  schemas:
    PerformanceRow:
      type: object
      description: One aggregated performance row for a report dimension.
      properties:
        advertiserId:
          type: integer
        advertiserName:
          type: string
        publisherId:
          type: integer
        publisherName:
          type: string
        region:
          type: string
        currency:
          type: string
        impressions:
          type: integer
        clicks:
          type: integer
        pendingNo:
          type: integer
        pendingValue:
          type: number
        pendingComm:
          type: number
        confirmedNo:
          type: integer
        confirmedValue:
          type: number
        confirmedComm:
          type: number
        bonusNo:
          type: integer
        bonusValue:
          type: number
        bonusComm:
          type: number
        declinedNo:
          type: integer
        declinedValue:
          type: number
        declinedComm:
          type: number
        totalNo:
          type: integer
        totalValue:
          type: number
        totalComm:
          type: number
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 user-level access token generated at ui.awin.com/awin-api and sent as an Authorization Bearer header. The Create Transactions API is the exception and uses an x-api-key header instead. Many endpoints also accept the token as an accessToken query parameter.