Claim Media

Users can claim media to associate organic content with ad accounts. Once claimed, this content can be used to create ads.

Generally, the steps are:

1. Claim the media by ad code or Snap Id.
2. Check the media status, and wait for media_status to become READY.
3. Create an ad using the claimed media.

Claim media by ad code​

Ad codes allow creators and advertisers to easily collaborate on paid partnerships content at a post level. An ad code is generated when a creator creates a piece of content on Snapchat. When this ad code is shared with an advertiser, the advertiser can then use this code to check the status of the media/content. If the content is ready, the advertiser can use it to set up a creative.

Using the Snapchat app Ad Codes can be set up by any Creator. There is no requirement to be allowlisted. Learn more at how Ad Codes are set up by Creators.

Parameters

Request

https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/claim_media_by_ad_code

Response

{
  "request_status": "SUCCESS",
  "request_id": "d8943beb-7c3c-4522-8d4e-df7b8f0dbca9",
  "media_entity_id": "d645bac7-e310-4fb2-8481-98842d254a75",
  "error_messages": {}
}

Claim media by Snap Id​

We also allow users to Promote a Snap in-app and in Profile Manager. Snap Promote uses the claim_media_by_snap_reference endpoint, which API clients can use to similar effect.

Request

https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/claim_media_by_snap_reference?snap_id={snap_id}

where snap_id is the Snapʼs id, e.g., W7_EDlXWTBiXAEEniNoMPwAAYZXJwdnd1YWloAYu1RnTVAYu1RnRGAAAAAQ.

Response

{
  "request_status": "SUCCESS",
  "request_id": "61515daf-5bc9-4487-8ca3-f8bc8d437502",
  "media_entity_id": "c7f9387a-bae0-4ea4-84ba-0204b30a778e"
}

Check media status​

Use the media_entity_id received in the claim media step to verify its readiness.

Request

https://adsapi.snapchat.com/v1/media/{media_id}

Response

{
  "request_status": "SUCCESS",
  "request_id": "2aa5fdca-6087-457a-aa62-23c3bb89b3f5",
  "media": [
    {
      "sub_request_status": "SUCCESS",
      "media": {
        "id": "d645bac7-e310-4fb2-8481-98842d254a75",
        "updated_at": "2024-08-08T20:31:46.268Z",
        "created_at": "2024-08-08T20:31:40.777Z",
        "ad_account_id": "19500815-b276-466a-8a4c-f890554ac1b3",
        "type": "VIDEO",
        "media_status": "READY",
        "download_link": "…",
        "target_business_profile_id": "73329e8b-108e-4a33-9218-183bbbeaa452",
        …
      }
    }
  ]
}

"media_status": "READY" means the media is ready to be used for ad creation. Otherwise, it will show "PENDING_UPLOAD".

Create ad​

Use the media_id as the top_snap_media_id to set up a Creative that shows the creator’s profile.

Parameters

For comprehensive list of all parameters needed to create an ad from a creative, please refer to our Create a Snap Ad documentation.

Request

https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/creatives

Response

{
  "request_status": "success",
  "request_id": "526ddba9-f082-4ea8-a93d-c313badcd5fb",
  "creatives": [
    {
      "sub_request_status": "success",
      "creative": {
        "id": "c1e6e929-acec-466f-b023-852b8cacc18f",
        "updated_at": "2016-08-14T06:45:04.300Z",
        "created_at": "2016-08-14T06:45:04.300Z",
        "name": "Creative Creative",
        "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
        "type": "SNAP_AD",
        "packaging_status": "PENDING",
        "review_status": "PENDING_REVIEW",
        "shareable": true,
        "top_snap_media_id": "a7bee653-1865-41cf-8cee-8ab85a205837",
        "top_snap_crop_position": "MIDDLE"
      }
    }
  ]
}