Creator Discovery
In this section we go over the APIs that can be used for Creator Discovery.
Public vs Authorized Endpoints
Public Endpoints
There are a set of Public Profile API endpoints that do not require profile owner authorization and are referred to as Public Endpoints in the documentation. You can use Public Profile API public endpoints to get basic metadata and stats about any Public Profile on Snapchat. Since public endpoints return information about any Public Profiles, they only return a subset of publicly available information. For additional metadata or statistics pertaining to Public Profiles refer to the standard Public Profile documentation, which we refer to as Authorized access.
Public endpoints have the same patterns as the rest of the Marketing API endpoints but share a common public prefix. For example, /public/v1/[PLURAL_PARENT_ENTITY_NAME]
Authorized Data Sharing
Partners can access authorized data about Creators (i.e. Public Profiles) in one of two ways.
- Creator OAuth
- Creator Opts into Data Sharing on If they opt in to sharing their insights publicly, API partners can access a subset of authorized endpoints for their profile without individual profile owner authorization.
More on authorized endpoints can be found here.
Get Public Profile Change Logs
List All Public Profile Change Logs
This endpoint returns a list of signed urls to change logs. Each change log contains a list of IDs of public profiles which were either created , modified , or deleted.
HTTP Request GET https://businessapi.snapchat.com/public/v1/public_profiles/change_logs
Parameters
Parameter | Required | Description | Possible Values | |
---|---|---|---|---|
start_at_timestamp | No | Timestamp to filter profiles created or updated after this date | ||
limit | No | The number of change logs to return per page, default is 100 | Integer greater than 0 | |
cursor | No | Encoded cursor for the next page | Use the next_page_id provided in the response to fetch the next page |
HTTP Response
Field | Description | Possible Values | ||
---|---|---|---|---|
request_id | UUID of the request | UUID | ||
request_status | String to indicate the request status | SUCCESS, ERROR, PARTIAL | ||
change_logs | List of sub responses which contains change log URLs |
Change Logs
Field | Description | Possible Values | ||
---|---|---|---|---|
sub_request_status | String to indicate the request status | SUCCESS, ERROR, PARTIAL | ||
change_log | Object containing URL to the change log file |
Example
curl --request GET "https://businessapi.snapchat.com/public/v1/public_profiles/change_logs?start_at_timestamp=2024-04-09T00:00:00Z" \
--header "Authorization: Bearer <ACCESS_TOKEN>"
Response
{
"request_id": "3678e260-32f3-4f73-8bfe-d3066c97b74d",
"request_status": "SUCCESS",
"change_logs": [
{
"sub_request_status": "SUCCESS",
"change_log": {
"url": "https://storage.googleapis.com/creators_change_logs/export_2024-04-02%2005%3A35%3A11.392555%2B00_000000000000.csv?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=business-api%40adsapisc.iam.gserviceaccount.com%2F20240409%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20240409T201318Z&X-Goog-Expires=3600&X-Goog-SignedHeaders=host&X-Goog-Signature=..."
}
},
{
"sub_request_status": "SUCCESS",
"change_log": {
"url": "https://storage.googleapis.com/creators_change_logs/export_2024-04-02%2005%3A35%3A11.392555%2B00_000000000001.csv?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=business-api%40adsapisc.iam.gserviceaccount.com%2F20240409%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20240409T201318Z&X-Goog-Expires=3600&X-Goog-SignedHeaders=host&X-Goog-Signature=..."
}
}
]
}
Discover Creators
Use this endpoint to search for Creators based on follower count, spotlight video views, country and other filters. Note: Currently, the results are always sorted by follower count.
HTTP Request GET https://businessapi.snapchat.com/public/v1/public_profiles/discover
Parameters
Parameter | Required | Description | Possible Values | |
---|---|---|---|---|
limit | No | The number of results to return per page, default is 100 | Integers that is bigger than 0 | |
cursor | No | Pagination encoded cursor for next page of stories. Default is empty | Use the next_page_id provided in the response to fetch the next page | |
country_code | No | The creator’s country code. If provided, then only creators from that country will be included in the response. | Value should be an ISO 3166-1 alpha-2 country code. Examples : US, FR, SA | |
subcategory | No | The subcategory of the creator. If provided then only the creators in that subcategory will be returned. | BUSINESS, CHARITY_CAUSE, COLLEGE_UNIVERSITY, COMMUNITY_ORG, COMPANY_ENTERPRISE, GOVERNMENT_ORG, GROUP, INTERNET_COMPANY, MEDIA_NEWS_COMPANY, NONPROFIT_ORG, POLITICAL_ORG, RELIGIOUS_ORG, RESTAURANT_CHAIN, RETAIL_COMPANY, SPORTS_LEAGUE, SPORTS_TEAM, RECORD_LABEL, ACTOR, ARTIST, ATHLETE, COACH, COMEDIAN, CREATOR, DANCER, ENTREPRENEUR, FASHION_MODEL, FILM_DIRECTOR, FILM_TV_PERSONALITY, FITNESS_PRO, FOOD_PRO, GOVERNMENT_OFFICIAL, JOURNALIST, LENS_CREATOR, LIFESTYLE_INFLUENCER, MOTIVATIONAL_SPEAKER, MOVIE_CHARACTER, MUSICIAN_BAND, NEWS_PERSONALITY, PERSON, PHOTOGRAPHER, POLITICAL_CANDIDATE, POLITICIAN, PRODUCER, PROFESSIONAL_GAMER, PUBLIC_FIGURE, SCIENTIST, SPORTS_PERSONALITY, TRAVELER, VIDEO_GAME_CREATOR, VLOGGER_BLOGGER, WRITER, APPAREL_FASHION, BRAND, PRODUCT, FILM_TV, HEALTH_BEAUTY, PUBLISHER, SERVICE, SHOW, VIDEO_GAME, MUSIC_FESTIVAL | |
min_followers | No | The minimum number of followers a creator should have to be included in the results | Should be a positive value | |
max_followers | No | The maximum number of followers a creator should have to be included in the response. Creators with more than max_followers will not be included in the response. | Should be a positive value, greater than min_followers | |
min_spotlight_views | No | Search creators with at least min_spotlight_views. Only includes the views received in the last 24 hours. | should be a positive number | |
max_spotlight_views | No | Search creators with at most max_spotlight_views. Only includes the views received in the last 24 hours. | should be a positive number greater than min_spotlight_views | |
can_share_data | No | Set this to true if you want the response to only include creators which have opted to share their authorized data. | Only one possible value: true | |
query | No | Does a keyword search on the creator’s user name and display name. If provided, then the response will only contain creators whose username or profile display name partially matches the query. |
HTTP Response
Field | Description | Possible Values |
---|---|---|
request_id | UUID of the request. | UUID |
request_status | Status of the request. | "SUCCESS", "ERROR", "PARTIAL" |
public_profiles | Array of public profile objects containing details of the creators. | |
sub_request_status | String to indicate the request status | SUCCESS, ERROR, PARTIAL |
organization_id | Organization identifier associated with the public profile. | UUID of the organization |
display_name | Display name of the creator. | String containing the name of the creator |
subcategory | The specific category the creator belongs to. | Refer to subcategory section above |
logo_urls | Object containing URLs to various logos. | Array of URL Strings e.g., {"original_logo_url": "https://cf-st.sc-cdn.net/d/…."} |
country | Country code of the creator. | ISO 3166-1 alpha-2 codes, e.g., "US" |
snap_user_name | Snapchat username of the creator. | String containing the username of the creator |
subscriber_count | Number of subscribers the creator has. | Number of subscribers |
spotlight_views | Number of views the creator's spotlight content has received. | Number of spotlight views |
Example
curl "https://businessapi.snapchat.com/public/v1/public_profiles/discover?limit=2&country_code=US&min_followers=100&min_spotlight_views=100"
-H "Authorization: <ACCESS_TOKEN>
Response
{
"request_id": "8e4c6de0-de92-4d95-bf58-dae51f16edd7",
"request_status": "SUCCESS",
"public_profiles": [
{
"sub_request_status": "SUCCESS",
"public_profile": {
"id": "ffefc512-....",
"organization_id": "c6aa8db8-....",
"display_name": "Hugo",
"subcategory": "SUBCATEGORY_V3_FILM_DIRECTOR",
"logo_urls": {
"original_logo_url": "https://cf-st.sc-cdn.net/d/…."
},
"country": "US",
"snap_user_name": "hugo…",
"subscriber_count": "136408",
"spotlight_views": "71000"
}
},
….
],
"paging": {
"next_page_id": "....",
"next_link": "https://businessapi.snapchat.com/public/v1/public_profiles/discover…"
}
}
Search
Search For Profiles
This endpoint returns a list of public profiles that match the search criteria.
HTTP Request
GET https://businessapi.snapchat.com/public/v1/public_profiles/search
Parameters
Parameter | Required | Default | Description | |
---|---|---|---|---|
query | R | The Snap user name or profile display name to search by | ||
limit | O | 100 | The maximum number of profiles to return. Pagination is not currently supported for this endpoint | |
category | O | CATEGORY_BUSINESS | The profile category; one of CATEGORY_PERSON or CATEGORY_BUSINESS | |
tier | O | TIER_PUBLIC_OFFICIAL | The profile tier; one of TIER_PUBLIC or TIER_PUBLIC_OFFICIAL |
HTTP Response
Field | Description | Possible Values | ||
---|---|---|---|---|
request_id | UUID of the request | UUID | ||
request_status | String to indicate the request status | SUCCESS, ERROR, PARTIAL | ||
public_profiles | List of sub responses which contains profiles | Refer to the public_profiles table below | ||
debug_message | Debug information string if request_status is ERROR or Partial | |||
display_message | Display information string if request_status is ERROR or Partial | |||
error_code | Error code string if request_status is ERROR or Partial |
Public Profiles
Field | Description | Possible Values | ||
---|---|---|---|---|
sub_request_status | String to indicate the request status | SUCCESS, ERROR, PARTIAL | ||
public_profile | Profile metadata object | Refer to Public Profile Entity, fields marked as Y in the Is Public column. Excluding share_authorized_data_with_api_partners | ||
sub_request_error_reason | Error reason string if sub_request_status is ERROR or Partial |
Example
curl "https://businessapi.snapchat.com/public/v1/public_profiles/search?query=arbiz-test"
-H "Authorization: <ACCESS_TOKEN>
Response
{
"request_id": "ce0066a8-cdaa-4c1f-9537-4d85e0d5357f",
"request_status": "SUCCESS",
"public_profiles": [
{
"sub_request_status": "SUCCESS",
"public_profile": {
"id": "36b8655e-2523-410f-ab00-02061267c3b6",
"display_name": "ARBIZ Test",
"description": "ARBIZ, we've got the meats!",
"category": "CATEGORY_V3_PEOPLE",
"subcategory": "CATEGORY_V3_ARTIST",
"email": "me@arbiz.com",
"website": "https://arbiz.com",
"logo_urls": {
"original_logo_url": "https://cf-st.sc-cdn.net/d/FnezixeVnJNHDAR2ZycK1?bo=Eg0aABoAMgEESAJQGWAB&uc=25",
"discover_feed_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvRm5leml4ZVZuSk5IREFSMlp5Y0sxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,72_FMjpeg",
"mega_profile_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvRm5leml4ZVZuSk5IREFSMlp5Y0sxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
"manage_profile_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvRm5leml4ZVZuSk5IREFSMlp5Y0sxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg"
},
"address_line_1": "123 Main Street",
"locality": "Edmonds",
"administrative_district_level_1": "WA",
"postal_code": "98020",
"country": "US",
"snap_user_name": "arbiz-test",
"profile_tier": "TIER_PUBLIC_OFFICIAL",
"profile_type": "PUBLIC_PROFILE",
"internal_profile_category": "PERSON",
"subscriber_count": 4
}
}
]
}
Metrics
Brands are leaning into smaller creators, who provide access to niche audiences at lower cost, creating a more rich and diverse ecosystem where more Creators can flourish. A key factor that Brands evaluate when searching for Creators to collaborate with is how engaged their audience is. Today, Creators do not necessarily need to have a large following
Snap Star Profile Avg. ER
- Option 1 (using Followers/Subscribers as denominator) = Total Shares + Total Screenshots + Total Favorites + Total Swipe Ups + Total Story Replies / Total Followers
- Options 2 (using Views as the denominator) = Total Shares + Total Screenshots + Total Favorites + Total Swipe Ups + Total Story Replies / Total Views
Stories ER
- Option 1 (using Followers/Subscribers as denominator) = Total Shares + Total Screenshots + Total Favorites + Total Swipe Ups + Total Story Replies / Total Followers
- Option 2 (using Views as the denominator) = Total Shares + Total Screenshots + Total Swipe Ups + Total Story Replies / Total Views
Snaps ER
- Option 1 (using Followers/Subscribers as denominator) = Total Shares + Total Screenshots + Total Favorites + Total Swipe Ups + Total Story Replies / Total Followers
- Option 2 (using Views as the denominator) = Total Shares + Total Screenshots + Total Swipe Ups + Total Replies / Total Views
Spotlights ER
- Option 1 (using Followers/Subscribers as denominator) = Total Shares + Total Screenshots + Total Favorites / Total Followers
- Option 2 (using Views as the denominator) = Total Shares + Total Screenshots + Total Favorites / Total Views
Lenses ER
- Option 1 (using Followers/Subscribers as denominator) = Total Shares + Total Favorites / Total Followers
- Option 2 (using Views as the denominator) = Total Shares +Total Favorites / Total Views
Get Publicly Available Profile Metadata
Get Profile by Profile ID
This endpoint retrieves the public metadata of a Public Profile by its ID.
HTTP Request
GET https://businessapi.snapchat.com/public/v1/public_profiles/{profile_id}
Parameters
Parameter | Default | Description | ||
---|---|---|---|---|
profile_id | Profile ID |
HTTP Response
Field | Description | Possible Values | ||
---|---|---|---|---|
request_id | UUID of the request | UUID | ||
request_status | String to indicate the request status | SUCCESS, ERROR, PARTIAL | ||
public_profiles | List of sub responses which contains profiles | Refer to the public_profiles table below | ||
debug_message | Debug information string if request_status is ERROR or Partial | |||
display_message | Display information string if request_status is ERROR or Partial | |||
error_code | Error code string if request_status is ERROR or Partial |
Public Profiles
Field | Description | Possible Values | ||
---|---|---|---|---|
sub_request_status | String to indicate the request status | SUCCESS, ERROR, PARTIAL | ||
public_profile | Profile metadata object | Refer to Public Profile Entity, fields marked as Y in the Is Public column | ||
sub_request_error_reason | Error reason string if sub_request_status is ERROR or Partial |
Example
curl "https://businessapi.snapchat.com/v1/public_profiles/76da494b-76bc-4bbb-bb27-c5a66fb0d1ab"
-H "Authorization: <ACCESS_TOKEN>>"
Reponse
{
"request_id": "9dcaf5ea-6132-4a72-ad1d-940d19fe4c7a",
"request_status": "SUCCESS",
"public_profiles": [
{
"sub_request_status": "SUCCESS",
"public_profile": {
"id": "76da494b-76bc-4bbb-bb27-c5a66fb0d1ab",
"organization_id": "f73196ae-5154-4e5a-8d1d-5bded3992088",
"display_name": "Daily Question",
"description": "Daily Question",
"category": "CATEGORY_V3_PEOPLE",
"subcategory": "SUBCATEGORY_V3_SCIENTIST",
"logo_urls": {
"original_logo_url": "https://cf-st.sc-cdn.net/d/vPpycEULnWA2vZK4mFVcJ?bo=Eg0aABoAMgEESAJQGWAB&uc=25",
"discover_feed_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvdlBweWNFVUxuV0EydlpLNG1GVmNKP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,72_FMjpeg",
"mega_profile_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvdlBweWNFVUxuV0EydlpLNG1GVmNKP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
"manage_profile_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvdlBweWNFVUxuV0EydlpLNG1GVmNKP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg"
},
"country": "US",
"snap_user_name": "dailyquestion1",
"share_authorized_data_with_api_partners": false
}
}
]
}
Get Profile by Snap ID
This endpoint retrieves a user’s public profile id given the snap id of the snap this user created.
HTTP Request
GET https://businessapi.snapchat.com/public/v1/snaps/{snap_id}/public_profile
HTTP Response
Field | Description | Possible Values | Possible Values | |
---|---|---|---|---|
request_id | UUID of the request | UUID | UUID | |
request_status | String to indicate the request status | SUCCESS ERROR PARTIAL | Integers that is bigger than 0 | |
profile_id | UUID of the creator’s profile | UUID string | UUID string | |
debug_message | Debug information string if request_status is ERROR or Partial | |||
display_message | Display information string if request_status is ERROR or Partial | |||
error_code | Error code string if request_status is ERROR or Partial |
Example
curl "https://businessapi.snapchat.com/public/v1/snaps/{snap_id}/public_profile"
-H "Authorization: <ACCESS_TOKEN>
Response
Example response:
{
"request_id": "5adcb413-642d-44d0-ba51-110d2574420f",
"request_status": "SUCCESS",
"profile_id": "72aa026e-6940-4613-bc06-2f1cf573a8b4"
}
Get Publicly Available Profile Assets
Get Lenses by Profile ID
This endpoint retrieves all lenses for a given profile. Details about this endpoint can be found here
Get Saved Stories by Profile ID
This endpoint retrieves all Saved Stories for a given profile. Details about this endpoint can be found here
Get Spotlights by Profile ID
This endpoint retrieves all Spotlights for a given profile. Details about this endpoint can be found here
Get Stats by Profile ID
The profile stats endpoint is a single endpoint to retrieve stats for all public assets related to a profile. This currently includes Profile and Spotlights.Details about this endpoint can be found here
Access Authorized Profile Data
These endpoints are only available when creators have authorized brands to access profile and asset data. Only a subset of creators would have allowed this and the data is filtered based on what is shared. Here are a list of API endpoints for authorized data retrieval.
Get Profile Stats
The profile stats endpoint is a single endpoint to retrieve stats for all assets related to a profile
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/stats
Learn More about this endpoint here
Get Profile Stories
This endpoint retrieves all Stories for a given profile.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_id}/stories
Learn More about this endpoint here
Get Story Snaps
This endpoint retrieves a Lens by the Lens ID.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_id}/stories/{id}/snaps
Learn More about this endpoint here
Get Story Stats
This endpoint retrieves all available stats for a story.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/stories/{id}/stats
Learn More about this endpoint here
Get Profile Saved Stories
This endpoint retrieves all available stats for a saved story.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_id}/saved_stories
Learn More about this endpoint here
Get Saved Story Snaps
This endpoint retrieves all Saved Stories for a given profile.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/saved_stories/{id}/stats
Learn More about this endpoint here
Get Saved Story Stats
This endpoint retrieves all available stats for a saved story.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/saved_stories/{id}/stats
Learn More about this endpoint here
Get Profile Spotlights
This endpoint retrieves all Spotlights for a given profile.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_id}/spotlights
Learn More about this endpoint here
Get Spotlights by ID
This endpoint retrieves a Spotlight for a given profile and spotlight id.
GET GET https://businessapi.snapchat.com/v1/public_profiles/{profile_id}/spotlights/{spotlight_id}
Learn More about this endpoint here
Get Spotlight Stats
This endpoint retrieves all available stats for a profile.
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/spotlights/{id}/stats
Learn More about this endpoint here
Brand-Creator Collaborations
Retrieve Collaboration Snaps
This endpoint enables a partner to retrieve paid partnerships posts where the brand is tagged by a Creator. It’s response may contain Spotlights, Saved Stories, and Public Stories depending on the types of creators collaborations the brand has executed.
HTTP Request
GET https://businessapi.snapchat.com/v1/public_profiles/{profile_id}/shared_snaps
Parameters
Parameter | Required | Description | Possible Values | |
---|---|---|---|---|
profile_id | Yes | The Profile ID of the Brand being tagged | UUID | |
limit | No | Pagination limit size of returned snap. If not specified, default is 10 | Integer greater than 0 | |
cursor | No | Pagination encoded cursor for the next page of snaps. Default is empty | ||
fetch_in_aggregate_view | No | If set to true, Story ID and Story type will be included in the response per Snap. Default is TRUE | True/False |
HTTP Response
Parameter | Description | Possible Values |
---|---|---|
id | First snap | UUID |
story_id | The ID of the full Story | UUID |
media_metadata | Object contianing information about the media such as type and url | |
sponsor | The Public Profile of the Brand being tagged in the shared_snap and the post is marked as paid partnership. The sponsor field appears before the status hits APPROVED. The possible values of this field are: PENDING : Pending for the brand to review the snap. REJECTED : Rejected by the brand NOT_SPECIFIED : The snap is sponsored without specifying a sponsor explicitly, thus no need to review. AUTO_APPROVED : The snap was auto-approved because the brand has provided certain permissions to the creator | |
username | The Snap username of the Creator tagging the Brand’s Public Profile | |
display_name | The display name of the Creator’s Public Profile | |
multi_snaps_bundle_id | A bundle ID for when the story > 10s | |
story_type | For example is its a SAVED_STORY |
Response
{
"request_id": "2c9a2329-f73a-4c21-8dc8-e819457322ab",
"request_status": "SUCCESS",
"shared_snaps": [
{
"sub_request_status": "SUCCESS",
"shared_snap": {
"id": "f2bcb0e8-97a6-4cc9-add8-c8d98fb46e1e",
"story_id": "5f8b9adb-7799-40cd-bd38-e3d4b7e9f80f",
"media_metadata": {
"media_type": "MEDIA_TYPE_IMAGE",
"media_url": "https://cf-st.sc-cdn.net/d/HMbAELp8f4v8c3uH27reH.999.IRZXSOY?mo=GjUaDhoAGgAyAgR9SARQT2ABWhBQdWJsaWNJbWFnZVN0b3J5ogEQCOcHIgsSACoHSVJaWFNPWQ%3D%3D&uc=79",
"thumbnail_url": "https://cf-st.sc-cdn.net/d/HMbAELp8f4v8c3uH27reH.256.IRZXSOY?mo=GkgaDhoAGgAyAgR9SANQT2ABWhBEZkxhcmdlVGh1bWJuYWlsogEQCIACIgsSACoHSVJaWFNPWaIBEAiaCiILEgAqB0lSWlhTT1k%3D&uc=79"
},
"created_at": "2024-01-26T22:37:50.575Z",
"sponsor": {
"profile_id": {
"high_bits": "3333118795269425713",
"low_bits": "12035785981443997886"
},
"display_name": "City Boutique",
"sponsor_status": "AUTO_APPROVED"
},
"display_name": "Zehua Profile",
"story_type": "SAVED_STORY"
}
},
{
"sub_request_status": "SUCCESS",
"shared_snap": {
"id": "zt-ev1rpTgWbEQ7y90uGswAAgbWRkenJzZXh6AYZgp75HAYZgp7yGAAAAAA",
"story_id": "bfc0db68-0f7a-4f1f-be01-7ac311f8d339",
"media_metadata": {
"media_type": "MEDIA_TYPE_VIDEO",
"media_url": "https://cf-st.sc-cdn.net/d/T8PXxkizs3L41WAGKP9JZ.1034.IRZXSOY?mo=GjYaDRoAGgAyAQRIAlBLYAGiASQIiggSEgoQIAFKDAoHOBcfJiAfGhD0AyILEgAqB0lSWlhTT1k%3D&uc=75",
"thumbnail_url": "https://cf-st.sc-cdn.net/d/T8PXxkizs3L41WAGKP9JZ.256.IRZXSOY?mo=Gk0aCxoAGgAyAQRQS2ABWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAkgDEgAqB0lSWlhTT1miARQImgoiDwoCSAISACoHSVJaWFNPWQ%3D%3D&uc=75"
},
"created_at": "2023-02-17T18:34:10.950Z",
"sponsor": {
"profile_id": {
"high_bits": "3333118795269425713",
"low_bits": "12035785981443997886"
},
"display_name": "City Boutique"
}
}
}]
}
Turn the organic PP post into an ad
This endpoint enables brand to turn a paid partnerships post into an ad
HTTP Request
POST https://businessapi.snapchat.com/v1/adaccounts/{adAccountId}/claim_media_by_snap_reference
Parameters
Parameter | Required | Description | Possible Values | |
---|---|---|---|---|
snap_id | Yes | The ID of the organic content to be turned into an ad | UUID |
Response
{
"request_status": "SUCCESS",
"request_id": "654b4c1a-0284-4586-b423-77421f958d95",
"media_entity_id": "7f7b5f3f-7d23-48b9-91b0-7b9cb7242490"
}