UpPromote Marketplace API
    UpPromote Marketplace API
    • Get offers
      GET
    • Get affiliate links
      GET
    • Get referral orders
      GET
    • Get payments
      GET

      Get offers

      GET
      /api/v1/offer/data
      Get all available offers listed on the UpPromote Marketplace. This API allows you to view current offers you can apply for.
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location --request GET '/api/v1/offer/data?page=1&per_page=10'
      Response Response Example
      200 - Example 1
      {
          "status": 200,
          "data": [
              {
                  "current_page": 1,
                  "first_page_url": "/?page=1",
                  "per_page": 10,
                  "from": 1,
                  "to": 10,
                  "data": [
                      {
                          "id": 12345,
                          "shop_id": 0,
                          "offer_name": "Test store",
                          "website": "https://yourshopdomain.com",
                          "description": "<div>Offer description</div>",
                          "logo": "https://cdn.uppromote.com/storage/uploads/logo/1694761242_7803704_753e322e55cf7e612b59f6ba525044cc.png",
                          "categories": [
                              "Grocery & food",
                              "Book",
                              "Sport & entertainment"
                          ],
                          "currency": "USD",
                          "commission_rule": "simple",
                          "commission_type": "Percent Of Sale",
                          "commission_amount": 10,
                          "commission_advance": [
                              {
                                  "level": 1,
                                  "order_value_condition": 10,
                                  "commission_amount": 20
                              }
                          ],
                          "lifetime_commission": true,
                          "automatic_discounts_for_customer": true,
                          "register_url": "https://af.uppromote.com/a-develop-store/register?p=6&key=eyJpdiI6ImdXNllGclJwTk9aYmFBbVRPQjE1aEE9PSIsInZhbHVlIjoiMW1IWTBBa2U3OW5MUWM3S1BYKzRSVkFZM0xBRnNVTm9FWWJWcXBGNzRtM2JyMm9OcW9EcHpITHBmWEJoZVorbHF4NFBFV3lrVVNOeFdUSjNVM3AwOHc9PSIsIm1hYyI6ImM3YjA4YWY3NDRhYWViZTNiODI2YzkwY2VmM2M1ODM2NGE2MTNjYmQyYmVkNThmNjZkYTlhMmJiZjViZjE5MmMiLCJ0YWciOiIifQ==",
                          "promotion_details": [
                              "aff_link",
                              "coupon"
                          ],
                          "cookie": 30,
                          "payment_support": [
                              "paypal",
                              "debit",
                              "cheque"
                          ],
                          "target_audience": [
                              {
                                  "ages": [
                                      "Under 18",
                                      "18-24",
                                      "25-34",
                                      "35-44"
                                  ]
                              }
                          ],
                          "auto_active_affiliate": true,
                          "additional_information": [
                              {
                                  "hash_tags": [
                                      "hashtag1",
                                      "hashtag2",
                                      "hashtag3"
                                  ],
                                  "geology_limit": [
                                      "Anguilla",
                                      "Antigua and Barbuda",
                                      "Afghanistan"
                                  ],
                                  "video_url": "https://www.youtube.com/watch?v=N8v0U8OSpnQ"
                              }
                          ],
                          "payout_rate": "No data"
                      }
                  ]
              }
          ]
      }

      Request

      Authorization
      Provide your bearer token in the
      Authorization
      header when making requests to protected resources.
      Example:
      Authorization: Bearer ********************
      Query Params
      page
      integer <int64>
      optional
      Return the specified page of results. Default is page 1.
      Example:
      1
      per_page
      integer 
      optional
      Number of records per page (max: 100). Default is 10.
      Example:
      10

      Responses

      🟢200OK
      application/json
      Successful operation
      Body
      status
      integer 
      optional
      Example:
      200
      data
      array [object {6}] 
      optional
      current_page
      integer 
      optional
      The current page number being returned in the response.
      Example:
      1
      first_page_url
      string 
      optional
      Example:
      /?page=1
      per_page
      integer 
      optional
      The number of the offers returned per page.
      Example:
      10
      from
      integer 
      optional
      The index of the first offer shown on this page.
      Example:
      1
      to
      integer 
      optional
      The index of the last offer shown on this page.
      Example:
      10
      data
      array [object {22}] 
      optional
      🟠401Unauthorized
      🟠422Parameter Error
      🔴500Server Error
      Modified at 2025-07-03 03:48:58
      Next
      Get affiliate links
      Built with