# Snapchat Publishers API Reference Canonical: https://monsterapi.co/docs/api/snapchat-publishers Read the Snapchat Publishers reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [Snapchat](https://monsterapi.co/docs/openapi/platforms/snapchat.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # Snapchat: Publisher page `GET /snapchat/api/publisher/{bpid}` Documentation: https://monsterapi.co/docs/api/snapchat#publisher-page Operation ID: `snapchat_publisher_read` Returns a publisher’s profile, seasons, editions and Spotlight cards. Continue the listed season using `season_id` and `episodes_cursor` in [GET /publisher/{bpid}/episodes](https://monsterapi.co/docs/api/snapchat-publishers#episodes-of-a-season). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `bpid` (path, required): Publisher’s business-profile UUID in lowercase hexadecimal. Available at `sections[].results[].publisher.business_profile_id` in [GET /search](https://monsterapi.co/docs/api/snapchat-discovery#search-page). ## Responses - 200: The publisher page - 400: Identifier outside the accepted set Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: No page for this publisher; its media can still appear in [GET /discover](https://monsterapi.co/docs/api/snapchat-discovery#discover-page) at `stories[].video_track_url` and `stories[].snaps[].interval_start_ms` - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Snapchat returned unusable data - 503: Temporarily unavailable or rate limited; check `code` and any `Retry-After` header Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/snapchat/api/publisher/{bpid}' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Edition page `GET /snapchat/api/publisher/{bpid}/edition/{story_id}` Documentation: https://monsterapi.co/docs/api/snapchat#edition-page Operation ID: `snapchat_publisher_edition_read` Returns an edition’s story, snaps, publication time and season position. Its `business_profile_id` identifies the actual owner, which can differ from the requested `bpid`. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `bpid` (path, required): Publisher’s business-profile UUID in lowercase hexadecimal. Available at `sections[].results[].publisher.business_profile_id` in [GET /search](https://monsterapi.co/docs/api/snapchat-discovery#search-page). - `story_id` (path, required): Edition identifier: 1 to 19 decimal digits, from 0 to 9223372036854775807. Available at `editions[].id` in [GET /publisher/{bpid}](https://monsterapi.co/docs/api/snapchat-publishers#publisher-page). ## Responses - 200: The edition - 400: Identifier outside the accepted set Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: No such edition - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Snapchat returned unusable data - 503: Temporarily unavailable or rate limited; check `code` and any `Retry-After` header Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/snapchat/api/publisher/{bpid}/edition/{story_id}' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Episodes of a season `GET /snapchat/api/publisher/{bpid}/episodes` Documentation: https://monsterapi.co/docs/api/snapchat#episodes-of-a-season Operation ID: `snapchat_publisher_episodes_read` Returns a season’s episodes, newest first, with publisher details in `data`. The response repeats the requested `bpid`; `season_id` can identify a season belonging to a different publisher. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `bpid` (path, required): Publisher’s business-profile UUID in lowercase hexadecimal. Available at `sections[].results[].publisher.business_profile_id` in [GET /search](https://monsterapi.co/docs/api/snapchat-discovery#search-page). - `season_id` (query, required): Required season UUID in lowercase hexadecimal. Available at `seasons[].id` or `season_id` in [GET /publisher/{bpid}](https://monsterapi.co/docs/api/snapchat-publishers#publisher-page). - `cursor` (query, optional): Optional `next_cursor` from [GET /publisher/{bpid}/episodes](https://monsterapi.co/docs/api/snapchat-publishers#episodes-of-a-season) or `episodes_cursor` from [GET /publisher/{bpid}](https://monsterapi.co/docs/api/snapchat-publishers#publisher-page) with its `season_id`, unchanged. Decimal story IDs, including `storyId` in JSON positions, range from 0 to 9223372036854775807. - `limit` (query, optional): Episodes per page, 1 to 50, 20 by default ## Responses - 200: One page of episodes - 400: Identifier, season, cursor or limit outside the accepted format, or a missing season Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: Snapchat answered that there is no such publisher - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Snapchat returned unusable data or an empty episode list; an inaccessible season can have the same result - 503: Temporarily unavailable or rate limited; check `code` and any `Retry-After` header Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/snapchat/api/publisher/{bpid}/episodes' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: One edition of a show `GET /snapchat/api/show-story/{id}` Documentation: https://monsterapi.co/docs/api/snapchat#one-edition-of-a-show Operation ID: `snapchat_show_story_read` Returns an edition’s story and snaps, with additional details in `data`. An unavailable edition can return 500 even when its media appears in [GET /discover](https://monsterapi.co/docs/api/snapchat-discovery#discover-page) at `stories[].video_track_url` and `stories[].snaps[].interval_start_ms`. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Edition identifier: 1 to 19 decimal digits, from 0 to 9223372036854775807. Available at `editions[].id` in [GET /publisher/{bpid}](https://monsterapi.co/docs/api/snapchat-publishers#publisher-page). ## Responses - 200: The edition - 400: Identifier outside the accepted set Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: Snapchat returned unusable data or no accessible edition; this does not establish that the edition is absent - 503: Temporarily unavailable or rate limited; check `code` and any `Retry-After` header Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/snapchat/api/show-story/{id}' \ -H 'Authorization: Bearer ' ```