> ## Documentation Index
> Fetch the complete documentation index at: https://developers.everflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Marketplace Advertisers

Retrieve all marketplace advertisers (demand partners) available in the Everflow marketplace. Demand partners are advertisers or networks offering deals through the marketplace platform. Returns an array of demand partner objects with their profile information and status.


## OpenAPI

````yaml openapi/marketplace-demand-partners.yaml post /partners/marketplace/demands
openapi: 3.0.3
info:
  title: Everflow Marketplace API - Marketplace Advertisers
  description: >
    Marketplace advertiser (demand partner) endpoints for the Everflow
    marketplace partner API. Retrieve information about marketplace advertisers
    available in the Everflow marketplace.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Marketplace Advertisers
    description: Endpoints for retrieving marketplace advertiser information.
paths:
  /partners/marketplace/demands:
    post:
      tags:
        - Marketplace Advertisers
      summary: List Marketplace Advertisers
      requestBody:
        required: true
        content:
          application/json:
            example: {}
            schema:
              type: object
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  demand_partners:
                    type: array
                    description: Array of demand partner objects.
                    items:
                      $ref: '#/components/schemas/DemandPartner'
      security:
        - API Key: []
components:
  schemas:
    DemandPartner:
      type: object
      description: A marketplace demand partner profile.
      properties:
        everxchange_demand_partner_id:
          type: integer
          description: Unique demand partner ID.
        network_id:
          type: integer
          description: Network ID.
        company_name:
          type: string
          description: Demand partner name.
        status:
          type: string
          description: Current status of the demand partner (e.g. active, inactive).
        public_description:
          type: string
          description: Description of the demand partner and their offerings.
        logo_url:
          type: string
          description: URL to the demand partner's logo.
        logo_asset_id:
          type: integer
          description: Logo asset ID.
        website_url:
          type: string
          description: Demand partner's website URL.
        link:
          type: string
          description: Custom link URL.
        custom_link_label:
          type: string
          description: Custom link label.
        is_internal:
          type: boolean
          description: Whether this is an internal demand partner.
        has_migrated_categories:
          type: boolean
          description: >-
            Whether the demand partner has migrated to the new marketplace
            categories model.
        is_contact_info_public:
          type: boolean
          description: Whether contact info is public.
        default_network_offer_id:
          type: integer
          description: Default offer ID.
        facebook_contact_url:
          type: string
          description: Facebook contact URL.
        instagram_contact_url:
          type: string
          description: Instagram contact URL.
        linkedin_contact_url:
          type: string
          description: LinkedIn contact URL.
        twitter_contact_url:
          type: string
          description: Twitter contact URL.
        tiktok_contact_url:
          type: string
          description: TikTok contact URL.
        youtube_contact_url:
          type: string
          description: YouTube contact URL.
        time_created:
          type: integer
          example: 1734455015
          description: Unix timestamp of when the demand partner was created.
        time_saved:
          type: integer
          example: 1734455015
          description: Unix timestamp of last update.
        relationship:
          type: object
          description: Related objects for the demand partner.
          properties:
            connection:
              type: object
              description: >-
                Connection details between the partner and the demand partner.
                Only present when a connection exists.
            invitation:
              type: object
              description: Invitation details. Only present when an invitation exists.
            is_featured:
              type: boolean
              description: Whether this demand partner is featured.
            main_platform_id:
              type: integer
              description: Main platform ID for the demand partner.
            time_connected:
              type: integer
              example: 1734455015
              description: >-
                Unix timestamp of when the connection was established. 0 if not
                connected.
            contact:
              type: object
              description: Contact information.
              properties:
                first_name:
                  type: string
                  description: Contact first name.
                last_name:
                  type: string
                  description: Contact last name.
                phone_number:
                  type: string
                  description: Contact phone number.
                email:
                  type: string
                  description: Contact email address.
            resource_asset:
              type: object
              description: Resource asset information.
              properties:
                customer_asset_id:
                  type: integer
                  description: Customer asset ID.
                content_type:
                  type: string
                  description: Content type of the asset.
                filename:
                  type: string
                  description: Filename of the asset.
                url:
                  type: string
                  description: URL of the asset.
                file_size:
                  type: integer
                  description: File size in bytes.
                time_saved:
                  type: integer
                  example: 1734455015
                  description: Unix timestamp of last update.
            everflow_pay:
              type: object
              description: Everflow Pay status.
              properties:
                is_everflow_pay_enabled:
                  type: boolean
                  description: Whether Everflow Pay is enabled.
            performance:
              type: object
              description: Weekly and monthly performance metrics.
              properties:
                everxchange_demand_partner_id:
                  type: integer
                  description: The demand partner ID.
                clicks_weekly:
                  type: integer
                  description: Number of clicks in the past week.
                has_reached_weekly_threshold:
                  type: boolean
                  description: Whether the weekly click threshold has been reached.
                epc_weekly:
                  type: number
                  description: Earnings per click for the past week.
                cvr_weekly:
                  type: number
                  description: Conversion rate for the past week.
                clicks_monthly:
                  type: integer
                  description: Number of clicks in the past month.
                has_reached_monthly_threshold:
                  type: boolean
                  description: Whether the monthly click threshold has been reached.
                epc_monthly:
                  type: number
                  description: Earnings per click for the past month.
                cvr_monthly:
                  type: number
                  description: Conversion rate for the past month.
                time_created:
                  type: integer
                  example: 1734455015
                  description: Unix timestamp of when the performance record was created.
                time_saved:
                  type: integer
                  example: 1734455015
                  description: Unix timestamp of last update.
            programs:
              type: array
              description: Available programs with payout details.
              items:
                type: object
                properties:
                  everxchange_demand_partner_program_id:
                    type: integer
                    description: Unique program ID.
                  everxchange_demand_partner_id:
                    type: integer
                    description: The demand partner ID this program belongs to.
                  name:
                    type: string
                    description: Program name.
                  preview_url:
                    type: string
                    description: Preview URL for the program.
                  ordering_value:
                    type: integer
                    description: Display ordering value.
                  events:
                    type: array
                    description: Payout events within this program.
                    items:
                      type: object
                      properties:
                        everxchange_demand_partner_program_event_id:
                          type: integer
                          description: Unique event ID.
                        everxchange_demand_partner_program_id:
                          type: integer
                          description: The program ID this event belongs to.
                        everxchange_demand_partner_id:
                          type: integer
                          description: The demand partner ID.
                        name:
                          type: string
                          description: Event name.
                        is_default:
                          type: boolean
                          description: Whether this is the default event.
                        payout_type_id:
                          type: integer
                          description: Payout type ID.
                        payout_value_min:
                          type: number
                          description: Minimum payout value.
                        payout_value_max:
                          type: number
                          description: Maximum payout value.
                        time_created:
                          type: integer
                          example: 1734455015
                          description: Unix timestamp of when the event was created.
                        time_saved:
                          type: integer
                          example: 1734455015
                          description: Unix timestamp of last update.
                  time_created:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of when the program was created.
                  time_saved:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of last update.
            payments:
              type: object
              description: >-
                Payment provider availability. Each key is a provider name
                containing an object with an `enabled` boolean.
              properties:
                everflow_pay:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Everflow Pay is enabled.
                tipalti:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Tipalti is enabled.
                trusted_payouts:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Trusted Payouts is enabled.
                managed_payments:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Managed Payments is enabled.
                veem:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Veem is enabled.
                paypal:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether PayPal is enabled.
                masspay:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether MassPay is enabled.
            brands:
              type: array
              description: >-
                Brand entries associated with this demand partner. Only present
                for some partners.
              items:
                type: object
                properties:
                  everxchange_demand_partner_brand_id:
                    type: integer
                    description: Unique brand ID.
                  everxchange_demand_partner_id:
                    type: integer
                    description: The demand partner ID.
                  name:
                    type: string
                    description: Brand name.
                  logo_url:
                    type: string
                    description: URL to the brand logo.
                  logo_asset_id:
                    type: integer
                    description: Logo asset ID.
                  website_url:
                    type: string
                    description: Brand website URL.
                  ordering_value:
                    type: integer
                    description: Display ordering value.
                  relationship:
                    type: object
                    description: Related objects for the brand.
                    properties:
                      resource_asset:
                        type: object
                        description: Brand logo resource asset.
                        properties:
                          customer_asset_id:
                            type: integer
                            description: Customer asset ID.
                          content_type:
                            type: string
                            description: Content type of the asset.
                          filename:
                            type: string
                            description: Filename of the asset.
                          url:
                            type: string
                            description: URL of the asset.
                          file_size:
                            type: integer
                            description: File size in bytes.
                          time_saved:
                            type: integer
                            example: 1734455015
                            description: Unix timestamp of last update.
                  time_created:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of when the brand was created.
                  time_saved:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of last update.
            terms_and_conditions:
              type: string
              description: Terms and conditions text. Only present for some partners.
            vertical_ids:
              type: array
              description: Vertical category IDs.
              items:
                type: integer
            channel_ids:
              type: array
              description: Channel IDs.
              items:
                type: integer
            geo_vertical_ids:
              type: array
              description: Geographic vertical IDs.
              items:
                type: integer
            payout_type_ids:
              type: array
              description: Payout type IDs.
              items:
                type: integer
            platform_ids:
              type: array
              description: >-
                Platform identifiers (e.g. mobile, desktop) the partner operates
                on.
              items:
                type: integer
            categories:
              type: array
              description: Marketplace categories the partner operates in.
              items:
                type: object
                properties:
                  category_id:
                    type: integer
                    description: Category identifier.
                  type:
                    type: string
                    enum:
                      - parent
                      - children
                    description: Whether this is a parent category or a child category.
            country_ids:
              type: array
              description: Country IDs the partner targets.
              items:
                type: integer
            conversion_funnels:
              type: array
              description: Conversion funnel types this partner supports.
              items:
                type: string
                enum:
                  - ecomm
                  - lead_generation
            customer_short:
              type: string
              description: Short identifier for the partner's customer (read-only).
            network_currency_id:
              type: string
              description: Network currency identifier.
  securitySchemes:
    API Key:
      description: >
        The marketplace partner's API key. Uses the X-Eflow-Api-Key header. The
        key belongs to the marketplace partner user.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````