Repository navigation
Add Instagram, Facebook, Snapchat and X distribution identifier types #8992
Description
Problem
A creator's channels are listed in collection.distribution[].identifiers (3.3 creator cards, #8094, #8098, #8141), but distribution-identifier-type names only YouTube, TikTok, Twitch and Substack among social platforms. Instagram, Facebook, Snapchat and X fit only the generic platform_channel_id. That type is meaningful only inside a distribution entry, keyed by publisher_domain, and MUST NOT appear in bare {type, value} contexts such as distribution_ids sources and exclude filters.
So a buyer can't exclude an Instagram creator by handle, and two sellers listing the same Instagram creator can't be matched on a portable identifier. Instagram is the most common creator platform after YouTube and TikTok. The creator-marketplace adopter (Availnet, through Apostra) needs it for the 3.3 creator cards.
Proposal
Add eight values to enums/distribution-identifier-type.json, following the YouTube pattern: a stable ID is preferred for canonical matching, and a handle is a discovery alias that should resolve to the ID when possible.
| Value | Meaning |
|---|---|
instagram_account_id |
Instagram account ID (the stable user ID Meta's APIs return). Preferred canonical identifier. |
instagram_handle |
Instagram username such as @example. Discovery alias. |
facebook_page_id |
Facebook Page ID. Preferred canonical identifier. |
facebook_page_handle |
Facebook Page username (vanity name). Discovery alias. |
snapchat_profile_id |
Snapchat Public Profile ID. Preferred canonical identifier. |
snapchat_handle |
Snapchat username. Discovery alias. |
x_user_id |
X (formerly Twitter) numeric user ID. Preferred canonical identifier. |
x_handle |
X username such as @example. Discovery alias. |
Handles are compared case-insensitively, as @ plus the lowercased name, as the registry already does for youtube_channel_handle.
Why 3.3
Adding enum values is additive, and #8704 allows it in a minor. The values are only used in identifier lists that already accept the generic type, so nothing that validates today stops validating. Creator cards are new and experimental in 3.3, so this is the release they're needed in.
Related: #6538 (platform identities as properties), #8092, #8141.
Activity
docs(reference): describe #8995, social distribution identifier types…