Skip to main content

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.

  1. Creator OAuth
  2. 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

ParameterRequiredDescriptionPossible Values
start_at_timestampNoTimestamp to filter profiles created or updated after this date
limitNoThe number of change logs to return per page, default is 100Integer greater than 0
cursorNoEncoded cursor for the next pageUse the next_page_id provided in the response to fetch the next page

HTTP Response

FieldDescriptionPossible Values
request_idUUID of the requestUUID
request_statusString to indicate the request statusSUCCESS, ERROR, PARTIAL
change_logsList of sub responses which contains change log URLs

Change Logs

FieldDescriptionPossible Values
sub_request_statusString to indicate the request statusSUCCESS, ERROR, PARTIAL
change_logObject 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

ParameterRequiredDescriptionPossible Values
limitNoThe number of results to return per page, default is 100Integers that is bigger than 0
cursorNoPagination encoded cursor for next page of stories. Default is emptyUse the next_page_id provided in the response to fetch the next page
country_codeNoThe 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
subcategoryNoThe 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_followersNoThe minimum number of followers a creator should have to be included in the resultsShould be a positive value
max_followersNoThe 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_viewsNoSearch creators with at least min_spotlight_views. Only includes the views received in the last 24 hours.should be a positive number
max_spotlight_viewsNoSearch 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_dataNoSet 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
queryNoDoes 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

FieldDescriptionPossible Values
request_idUUID of the request.UUID
request_statusStatus of the request."SUCCESS", "ERROR", "PARTIAL"
public_profilesArray of public profile objects containing details of the creators.
sub_request_statusString to indicate the request statusSUCCESS, ERROR, PARTIAL
organization_idOrganization identifier associated with the public profile.UUID of the organization
display_nameDisplay name of the creator.String containing the name of the creator
subcategoryThe specific category the creator belongs to.Refer to subcategory section above
logo_urlsObject containing URLs to various logos.Array of URL Strings e.g., {"original_logo_url": "https://cf-st.sc-cdn.net/d/…."}
countryCountry code of the creator.ISO 3166-1 alpha-2 codes, e.g., "US"
snap_user_nameSnapchat username of the creator.String containing the username of the creator
subscriber_countNumber of subscribers the creator has.Number of subscribers
spotlight_viewsNumber 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 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

ParameterRequiredDefaultDescription
queryRThe Snap user name or profile display name to search by
limitO100The maximum number of profiles to return. Pagination is not currently supported for this endpoint
categoryOCATEGORY_BUSINESSThe profile category; one of CATEGORY_PERSON or CATEGORY_BUSINESS
tierOTIER_PUBLIC_OFFICIALThe profile tier; one of TIER_PUBLIC or TIER_PUBLIC_OFFICIAL

HTTP Response

FieldDescriptionPossible Values
request_idUUID of the requestUUID
request_statusString to indicate the request statusSUCCESS, ERROR, PARTIAL
public_profilesList of sub responses which contains profilesRefer to the public_profiles table below
debug_messageDebug information string if request_status is ERROR or Partial
display_messageDisplay information string if request_status is ERROR or Partial
error_codeError code string if request_status is ERROR or Partial

Public Profiles

FieldDescriptionPossible Values
sub_request_statusString to indicate the request statusSUCCESS, ERROR, PARTIAL
public_profileProfile metadata objectRefer to Public Profile Entity, fields marked as Y in the Is Public column. Excluding share_authorized_data_with_api_partners
sub_request_error_reasonError 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

ParameterDefaultDescription
profile_idProfile ID

HTTP Response

FieldDescriptionPossible Values
request_idUUID of the requestUUID
request_statusString to indicate the request statusSUCCESS, ERROR, PARTIAL
public_profilesList of sub responses which contains profilesRefer to the public_profiles table below
debug_messageDebug information string if request_status is ERROR or Partial
display_messageDisplay information string if request_status is ERROR or Partial
error_codeError code string if request_status is ERROR or Partial

Public Profiles

FieldDescriptionPossible Values
sub_request_statusString to indicate the request statusSUCCESS, ERROR, PARTIAL
public_profileProfile metadata objectRefer to Public Profile Entity, fields marked as Y in the Is Public column
sub_request_error_reasonError 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

FieldDescriptionPossible ValuesPossible Values
request_idUUID of the requestUUIDUUID
request_statusString to indicate the request statusSUCCESS ERROR PARTIALIntegers that is bigger than 0
profile_idUUID of the creator’s profileUUID stringUUID string
debug_messageDebug information string if request_status is ERROR or Partial
display_messageDisplay information string if request_status is ERROR or Partial
error_codeError 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

ParameterRequiredDescriptionPossible Values
profile_idYesThe Profile ID of the Brand being taggedUUID
limitNoPagination limit size of returned snap. If not specified, default is 10Integer greater than 0
cursorNoPagination encoded cursor for the next page of snaps. Default is empty
fetch_in_aggregate_viewNoIf set to true, Story ID and Story type will be included in the response per Snap. Default is TRUETrue/False

HTTP Response

ParameterDescriptionPossible Values
idFirst snapUUID
story_idThe ID of the full StoryUUID
media_metadataObject contianing information about the media such as type and url
sponsorThe 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
usernameThe Snap username of the Creator tagging the Brand’s Public Profile
display_nameThe display name of the Creator’s Public Profile
multi_snaps_bundle_idA bundle ID for when the story > 10s
story_typeFor 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

ParameterRequiredDescriptionPossible Values
snap_idYesThe ID of the organic content to be turned into an adUUID

Response

{
"request_status": "SUCCESS",
"request_id": "654b4c1a-0284-4586-b423-77421f958d95",
"media_entity_id": "7f7b5f3f-7d23-48b9-91b0-7b9cb7242490"
}
Was this page helpful?
Yes
No

AI-Powered Search