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 Access Authorized Profile Data section.

Public endpoints have the same patterns as the rest of the Marketing API endpoints but share a common public prefix, i.e., /public/v1/[PLURAL_PARENT_ENTITY_NAME].

Partners can access authorized data about Creators (i.e., Public Profiles) in one of two ways:

Creator OAuth; or,
Creator opts-in to data sharing. 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 the differences between Public and 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.

Try using the last_updated parameter in the Discover Creators endpoint to get profiles that have recently changed.

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

The following parameters have been deprecated:

country_code
subcategory

Future API versions may not support these filters. Please use creator_l_90_country_codes and creator_subcategories, respectively, instead.

Parameters

Parameter	Required	Description	Possible Values
limit	No	The number of results to return per page, default is 100	Integers greater 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
creator_l_90_country_codes	No	The creatorʼs country code(s). If provided, then only creators from these countries will be included in the response.	Values should be ISO 3166-1 alpha-2 country codes. Examples: US, FR, SA. If including multiple countries, repeat the parameter, e.g., creator_l_90_country_codes=US&creator_l_90_country_codes=FR
country_code	No	Deprecated. 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
creator_categories	No	The creatorʼs subcategories. If provided, then only creators from these subcategories will be returned.	See possible subcategory values below. If including multiple subcategories, repeat the parameter, e.g., creator_categories=BUSINESS&creator_categories=ARTIST
subcategory	No	Deprecated. 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 number
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 number, 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.	`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.
tier	No	Tier of profiles.	`TIER_PUBLIC_OFFICIAL`, `TIER_PUBLIC`, `TIER_STANDARD`
snap_stars_only	No	Set to true if the search results should only include Snap Stars.	`true`
audience_countries*	No	If specified, the response will be filtered by audience countries.	Comma-separated list of ISO 3166-1 alpha-2 country codes. E.g., `US,UK,CA,SA`
audience_country_percent*	No	Will only include profiles where at least this percentage of audience is from any of the specified countries.	Values between `1` to `100`
audience_gender*	No	Filter by audience gender.	`MALE` or `FEMALE`
audience_gender_percent*	No	Will only include profiles where at least this percentage of audience is from the specified gender.	Values between `1` to `100`
audience_age_ranges*	No	Filter by audience age range.	Comma-separated list of age ranges (possible values include `13-17`, `18-20`, `21-24`, `25-34`, `35+`)
audience_age_range_percent*	No	Will only include profiles which have been watched by at least this percentage of audience from the specified age ranges.	Values between `1` to `100`
last_updated	No	Will only include profiles which have been updated after this datetime.	Timestamp, e.g., `2025-09-04T00:00:00Z`

*Audience filters require the can_share_data=true flag to be set.

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&creator_l_90_country_codes=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
includeStandard	O	false	Boolean whether to include standard tier public profiles

If a Snap user name returns no results in the search endpoint, it may belong to a standard tier profile. Try setting includeStandard=true.

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 - Get Profile by Profile ID

This example fetches a Profile that is sharing data with partners via the API ("share_authorized_data_with_api_partners": true)

curl "https://businessapi.snapchat.com/public/v1/public_profiles/b975d22d-aea4-4929-b2bb-b0e6bfa95e12"
  -H "Authorization: <ACCESS_TOKEN>"

The above command returns JSON structured like this:

{
  "request_id": "db338ee8-b6bd-4c2f-a329-5a253d072a39",
  "request_status": "SUCCESS",
  "public_profiles": [
    {
      "sub_request_status": "SUCCESS",
      "public_profile": {
        "id": "b975d22d-aea4-4929-b2bb-b0e6bfa95e12",
        "display_name": "Snap AR",
        "description": "Your place to find all things AR for Snap",
        "category": "CATEGORY_V3_PRODUCT_BRAND",
        "subcategory": "SUBCATEGORY_V3_PRODUCT",
        "website": "https://linktr.ee/SnapAR",
        "logo_urls": {
          "original_logo_url": "https://cf-st.sc-cdn.net/d/iIijIDRFkVUhHbHuSd3jO?bo=Eg0aABoAMgEESAJQGWAB&uc=25",
          "discover_feed_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvaUlpaklEUkZrVlVoSGJIdVNkM2pPP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,72_FMpng",
          "mega_profile_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvaUlpaklEUkZrVlVoSGJIdVNkM2pPP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMpng",
          "manage_profile_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvaUlpaklEUkZrVlVoSGJIdVNkM2pPP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMpng"
        },
        "locality": "Los Angeles",
        "administrative_district_level_1": "CA",
        "country": "US",
        "snap_user_name": "snaplensscape",
        "profile_tier": "TIER_PUBLIC_OFFICIAL",
        "internal_profile_category": "PERSON",
        "subscriber_count": "73441",
        "share_authorized_data_with_api_partners": true,
        "l_90_country_code": "US"
      }
    }
  ]
}

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

{
  "request_id": "5adcb413-642d-44d0-ba51-110d2574420f",
  "request_status": "SUCCESS",
  "profile_id": "72aa026e-6940-4613-bc06-2f1cf573a8b4"
}

Get Publicly Available Profile Assets

The following assets are available on the Public endpoints (as denoted by the /public prefix). They show a subset of the data available on the Authorized endpoints.

Asset	Public endpoint	Authorized endpoint
Profile	`/public/v1/public_profiles/{profile_id}`	Link
Lens	`/public/v1/public_profiles/{profile_id}/lenses`	Link
Saved Story	`/public/v1/public_profiles/{profile_id}/saved_stories`	Link
Spotlight	`/public/v1/public_profiles/{profile_id}/spotlights`	Link

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 allow this access, and the data is filtered based on what is shared.

Add /v1/public_profiles/{profile_id} before these endpoints to access authorized profile data:

Asset	Get all	Get one	Get stats
Profile	N/A	`/` (more)	`/stats` (more)
Lens	`/lenses` (more)	`/lenses/{id}` (more)	N/A
Story	`/stories` (more)	N/A	`/stories/{id}/stats` (more)
Story Snap	`/stories/{id}/snaps` (more)	N/A	N/A
Saved Story	`/saved_stories` (more)	N/A	`/saved_stories/{id}/stats` (more)
Saved Story Snap	`/saved_stories/{id}/snaps` (more)	N/A	N/A
Spotlight	`/spotlights` (more)	`/spotlights/{id}` (more)	`/spotlights/{id}/stats` (more)

Brand-Creator Collaborations

Retrieve Collaboration Snaps

This endpoint enables a partner to retrieve paid partnerships posts where the brand is tagged by a Creator. Its 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": "4d535b7a-5228-48ba-9ae3-2f1fdc5518e1",
          "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": "4d535b7a-5228-48ba-9ae3-2f1fdc5518e1",
          "display_name": "City Boutique",
          "sponsor_status": "AUTO_APPROVED"
        }
      }
    }
  ]
}

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"
}

Was this page helpful?

Yes

Public vs Authorized Endpoints​

Public Endpoints​

Authorized Data Sharing​

Get Public Profile Change Logs​

List All Public Profile Change Logs​

Discover Creators​

Search​

Search For Profiles​

Metrics​

Get Publicly Available Profile Metadata​

Get Profile by Profile ID​

Example - Get Profile by Profile ID​

Get Profile by Snap ID​

Get Publicly Available Profile Assets​

Access Authorized Profile Data​

Brand-Creator Collaborations​

Retrieve Collaboration Snaps​

Turn the organic PP post into an ad​

Public vs Authorized Endpoints

Public Endpoints

Authorized Data Sharing

Get Public Profile Change Logs

List All Public Profile Change Logs

Discover Creators

Search

Search For Profiles

Metrics

Get Publicly Available Profile Metadata

Get Profile by Profile ID

Example - Get Profile by Profile ID

Get Profile by Snap ID

Get Publicly Available Profile Assets

Access Authorized Profile Data

Brand-Creator Collaborations

Retrieve Collaboration Snaps

Turn the organic PP post into an ad