The endpoint you use to pull campaign details is the unique URL as shown below:

http://api.appsamurai.com/api/campaign-pull/list/as9GmnmRV3GpZNvd3Y3d-pcYpodGvKYlcwM3bM

You will be given your unique API endpoint URL from your account manager at App Samurai.This URL will be valid as long as you do not request a new URL.

After a request on pull API, output will include all available and active campaigns opened for you. An example of output for CPI campaigns will be as follows:

{
    "campaign_id": 1235,
    "type": "non-incent",
    "app_title": "Climbing Pirates",
    "app_category": "Games / Casual",
    "app_store_url": "https://play.google.com/store/apps/details?id=com.sickkogames.pirates",
    "app_id": "com.sickkogames.pirates",
    "end_date": "No End Date",
    "daily_cap": 100,
    "payout_type": "cpi",
    "cpi": 1.5,
    "campaign_name": "Climbing Pirates-iOS-AE",
    "tracking_url": "TRACKING URL",
    "country": "US",
    "countries": ["US", "TR"],
    "countries_with_cities": {
      "US": {
        "cities": ["New York", "Los Angeles"]
      },
      "TR": {
        "cities": ["Ankara", "Bursa"]
      },
    },
    "platform": "android",
    "creatives": {
      "images": [
        {
          "url": "CREATIVE URL",
          "width": null,
          "height": null
        },
        {
          "url": "CREATIVE URL",
          "width": null,
          "height": null
        },
      ],
      "videos": [],
      "others": []
    },
    "creative_zip": "CREATIVE ZIP URL",
    "devices": "Both",
    "required_fields": ["ref_id"],
    "blacklisted_subpublishers": [],
    "whitelisted_subpublishers": []
  }

And for CPA campaigns will be as follows:

{
    "campaign_id": 1235,
    "type": "non-incent",
    "app_title": "Climbing Pirates",
    "app_category": "Games / Casual",
    "app_store_url": "https://play.google.com/store/apps/details?id=com.sickkogames.pirates",
    "app_id": "com.sickkogames.pirates",
    "end_date": "No End Date",
    "daily_cap": 100,
    "payout_type": "cpa",
    "cpa_event": "purchase",
    "cpi": 1.5,
    "campaign_name": "Climbing Pirates-iOS-AE",
    "tracking_url": "TRACKING URL",
    "country": "US",
    "countries": ["US", "TR"],
    "countries_with_cities": {
      "US": {
        "cities": ["New York", "Los Angeles"]
      },
      "TR": {
        "cities": ["Ankara", "Bursa"]
      },
    },
    "platform": "android",
    "creatives": {
      "images": [
        {
          "url": "CREATIVE URL",
          "width": null,
          "height": null
        },
        {
          "url": "CREATIVE URL",
          "width": null,
          "height": null
        },
      ],
      "videos": [],
      "others": []
    },
    "creative_zip": "CREATIVE ZIP URL",
    "devices": "Both",
    "required_fields": ["ref_id"],
    "blacklisted_subpublishers": [],
    "whitelisted_subpublishers": []
  }

Definition of parameters

campaign_id: App Samurai internal campaign ID
type: Campaign type (incent OR non-incent)
app_title: Store title of the application
app_category: Store category and subcategory (If Available)
app store url: App Store or Google Play url of the application
app_id: Unique store ID
end_date: Campaign end date
daily_cap: Max number of cap available to the partner
cpi: Cost per install bid that you can charge for each install+first open you deliver
campaign_name: Name of the campaign at App Samurai
tracking_url: Tracking URL for this specific campaign generated by App Samurai
country: First value of the “countries” parameter. This parameter will be removed on 01 June 2018 and only “countries” parameter will be used.
countries: Target GEO(s) of the campaign, which can include multiple or single country code.platform: Campaign's target device platform (play OR ios)
creative_zip: URL that you will use to download available creatives for the specific campaign
devices: Campaign's target device type (Phone OR Tablet OR Both)
required fields: Mandatory parameters to be passed on tracking url. It always includes ref_id(unique click ID). It can also include device_id (GAID or IDFA) when it is MANDATORY to
open this campaign ONLY on sources that can pass 100% IDFA & GAID.

Important Notes

In order to keep your campaigns updated (daily cap, payout, status, creatives etc.) werecommend you to regularly fetch details on an hourly basis. 

If a specific campaign that you currently run is not visible on API anymore, it means that thiscampaign is disabled by the advertiser. 

Please contact your account manager if you need any additional support. 

Did this answer your question?