SkimBit Merchants API

The Merchants API from SkimBit — 1 operation(s) for merchants.

Operations 1

GET /v4/publisher/{publisher_id}/merchants List / search merchants #

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/skimbit-merchants-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.

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

OpenAPI Specification

skimbit-merchants-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Skimlinks Merchant Merchants API
  version: v4
  description: The Skimlinks Merchant API provides a convenient way to gather information about the merchants (advertisers/programs) participating in the Skimlinks affiliate program that are available to the authenticated publisher.
  contact:
    name: Skimlinks Developer Support
    url: https://developers.skimlinks.com/merchant.html
  x-generated: '2026-07-21'
  x-method: searched
  x-source: https://developers.skimlinks.com/merchant.html (Apiary blueprint skimlinksmerchantapi)
servers:
- url: https://merchants.skimapis.com
  description: Skimlinks Merchant API production host
security:
- access_token: []
tags:
- name: Merchants
paths:
  /v4/publisher/{publisher_id}/merchants:
    get:
      operationId: listMerchants
      summary: List / search merchants
      description: Returns the set of Skimlinks merchants available for the authenticated publisher. The merchants and rates returned depend on the specific publisher domain being queried; if `publisher_domain_id` is omitted the first registered domain is used.
      tags:
      - Merchants
      parameters:
      - name: publisher_id
        in: path
        required: true
        schema:
          type: integer
        description: Your Publisher ID.
      - name: access_token
        in: query
        required: true
        schema:
          type: string
        description: Timestamp-based access token from the authentication API.
      - name: publisher_domain_id
        in: query
        required: true
        schema:
          type: integer
        description: Retrieve information for a specific domain id.
      - name: a_id
        in: query
        schema:
          type: integer
        description: Filter results by advertiser_id.
      - name: merchant_id
        in: query
        schema:
          type: integer
        description: Filter results by merchant_id.
      - name: search
        in: query
        schema:
          type: string
        description: Search query string.
      - name: vertical
        in: query
        schema:
          type: integer
        description: List merchants from one vertical only (vertical id).
      - name: country
        in: query
        schema:
          type: string
        description: Two character country code.
      - name: alternative_vertical_id
        in: query
        schema:
          type: integer
      - name: alternative_vertical_taxonomy
        in: query
        schema:
          type: string
      - name: alternative_vertical_country
        in: query
        schema:
          type: string
      - name: favourite_type
        in: query
        schema:
          type: string
        description: Pass `favourite` to retrieve favourites only.
      - name: limit
        in: query
        schema:
          type: integer
          default: 200
        description: Number of rows to return.
      - name: offset
        in: query
        schema:
          type: integer
        description: Paginate through results.
      - name: sort_by
        in: query
        schema:
          type: string
          enum:
          - name
          - partner_type
          - calculated_commission_rate
          - calculated_ecpc
          - popularity
      - name: sort_dir
        in: query
        schema:
          type: string
          enum:
          - asc
          - desc
      responses:
        '201':
          description: A list of merchants for the publisher.
          content:
            application/json:
              schema:
                type: object
                properties:
                  user_currency:
                    type: string
                  merchants:
                    type: array
                    items:
                      $ref: '#/components/schemas/Merchant'
                  has_more:
                    type: boolean
                  next_val:
                    type:
                    - string
                    - 'null'
                  last_val:
                    type:
                    - string
                    - 'null'
                  num_returned:
                    type: integer
                  publisher_domain_stats:
                    type: array
                    items:
                      $ref: '#/components/schemas/PublisherDomainStat'
              example:
                user_currency: EUR
                merchants:
                - id: 49697
                  advertiser_id: 49697
                  name: JCPenney
                  favourite: false
                  partner_type: vip
                  domains:
                  - jcpenney.com
                  - jcp.com
                  calculated_commission_rate: 0.0586546
                  calculated_ecpc: 0.13564794348
                  countries:
                  - united states
                  metadata:
                    logo: https://static.skimlinks.com/images/merchant_logos/49697_82b0689aa62ee1d44a74a35faf50b668.png
                    description: JCPenney is a shopping destination for home furnishings, apparel and accessories.
                last_val: JCPenney
                has_more: false
                next_val: null
                num_returned: 1
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    Merchant:
      type: object
      description: A merchant program having an active relationship with the authenticated publisher.
      properties:
        advertiser_id:
          type: integer
          description: The internal id of the merchant.
        merchant_ids:
          type: array
          items:
            type: string
          description: Internal ids of programs under advertiser_id.
        name:
          type: string
        domains:
          type: array
          items:
            type: string
        partner_type:
          type: string
          enum:
          - standard
          - preferred
          - vip
        verticals:
          type: array
          items:
            type: string
        alternative_verticals:
          type: array
          items:
            type: object
        countries:
          type: array
          items:
            type: string
        favourite:
          type: boolean
        calculated_conversion_rate:
          type: number
        estimated_payment_days:
          type: string
        estimated_attribution_window:
          type: string
        calculated_ecpc:
          type: number
        calculated_average_order_value:
          type: number
        calculated_commission_rate:
          type: number
        minimum_rate:
          $ref: '#/components/schemas/Rate'
        maximum_rate:
          $ref: '#/components/schemas/Rate'
        metadata:
          $ref: '#/components/schemas/Metadata'
    Rate:
      type:
      - object
      - 'null'
      properties:
        aggregation_type:
          type: string
          enum:
          - minimum
          - maximum
          - normal
        rate_type:
          type: string
          enum:
          - percentage
          - flat_rate
        base_rate:
          type: number
        increased_rate:
          type: number
        currency:
          type:
          - string
          - 'null'
        payout_type:
          type: string
          enum:
          - cpa
          - cpc
          - cpl
        description:
          type:
          - string
          - 'null'
        start_date:
          type: string
          format: date-time
    PublisherDomainStat:
      type: object
      properties:
        publisher_domain_id:
          type: integer
        calculated_average_order_value:
          type: number
        calculated_commission_rate:
          type: number
        calculated_conversion_rate:
          type: number
        calculated_ecpc:
          type: number
        estimated_reversal_rate:
          type: number
    Metadata:
      type: object
      properties:
        logo:
          type: string
        description:
          type: string
        special_conditions:
          type: string
  responses:
    TooManyRequests:
      description: Rate limit exceeded (40 requests/min, 1000/hour per API key).
  securitySchemes:
    access_token:
      type: apiKey
      in: query
      name: access_token
      description: Timestamp-based access token obtained from https://authentication.skimapis.com/access_token via a client_credentials grant using your client_id and client_secret.