# Snapchat API Reference Canonical: https://monsterapi.co/docs/api/snapchat Read the Snapchat API 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: Discover page `GET /snapchat/api/discover` Documentation: https://monsterapi.co/docs/api/snapchat#discover-page Operation ID: `snapchat_discover_read` Returns a selection of Discover stories. For continuation, use [GET /feed/discover](https://monsterapi.co/docs/api/snapchat-discovery#discover-feed). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs ## Responses - 200: Stories of the showcase - 400: Snapchat refused the request as malformed 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 the page is not there - 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/discover' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Funny videos hub `GET /snapchat/api/entertainment/funny` Documentation: https://monsterapi.co/docs/api/snapchat#funny-videos-hub Operation ID: `snapchat_entertainment_funny_read` Returns all available funny-video keywords and structured metadata. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs ## Responses - 200: The keywords of the hub - 400: Snapchat refused the request as malformed 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 the page is not there - 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/entertainment/funny' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Funny videos of one keyword `GET /snapchat/api/entertainment/funny/{keyword}` Documentation: https://monsterapi.co/docs/api/snapchat#funny-videos-of-one-keyword Operation ID: `snapchat_entertainment_funny_keyword_read` Returns a funny-video keyword, its initial Spotlight stories, additional story identifiers, related keywords and structured metadata. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `keyword` (path, required): Keyword from `items[].id` in [GET /entertainment/funny](https://monsterapi.co/docs/api/snapchat-spotlight#funny-videos-hub): lowercase letters, digits or hyphen; at most 100 characters. ## Responses - 200: The page of the keyword - 400: Keyword outside the accepted format 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 keyword - 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/entertainment/funny/{keyword}' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Discover feed `GET /snapchat/api/feed/discover` Documentation: https://monsterapi.co/docs/api/snapchat#discover-feed Operation ID: `snapchat_discover_feed_read` Returns a page of Discover stories and additional details in `data`. Pass `next_cursor` as `cursor` to this endpoint; its absence ends pagination. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `cursor` (query, optional): Optional `next_cursor` from [GET /feed/discover](https://monsterapi.co/docs/api/snapchat-discovery#discover-feed), unchanged; omit it for the first page. - `limit` (query, optional): Stories per page, 1 to 50, 20 by default ## Responses - 200: One page of the discover feed - 400: Cursor or limit 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 - 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/feed/discover' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Spotlight feed `GET /snapchat/api/feed/spotlight` Documentation: https://monsterapi.co/docs/api/snapchat#spotlight-feed Operation ID: `snapchat_spotlight_feed_read` Returns a page of Spotlight stories and metadata, with additional details in `data`; no page-size parameter is available. Pass `next_cursor` as `cursor` to this endpoint; its absence ends pagination. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `cursor` (query, optional): Optional `next_cursor` from [GET /feed/spotlight](https://monsterapi.co/docs/api/snapchat-spotlight#spotlight-feed), unchanged; omit it for the first page. ## Responses - 200: One page of the Spotlight feed - 400: Cursor 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 - 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/feed/spotlight' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Lens page `GET /snapchat/api/lens/{id}` Documentation: https://monsterapi.co/docs/api/snapchat#lens-page Operation ID: `snapchat_lens_read` Returns a lens, related lenses and Spotlight videos filmed with it. Accepts either its scannable or numeric identifier. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Lens identifier: 32 lowercase hexadecimal digits for a scannable ID, or 1 to 20 decimal digits for a numeric ID. Available at `lenses[].id` or `lenses[].lens_id` in [GET /lenses](https://monsterapi.co/docs/api/snapchat-lenses#lens-directory). ## Responses - 200: The lens 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 such lens - 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/lens/{id}' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Lens directory `GET /snapchat/api/lenses` Documentation: https://monsterapi.co/docs/api/snapchat#lens-directory Operation ID: `snapchat_lenses_read` Returns a page of lenses and available categories. Pass `next_cursor` as `cursor` to this endpoint; its absence ends pagination. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `cursor` (query, optional): Optional `next_cursor` from [GET /lenses](https://monsterapi.co/docs/api/snapchat-lenses#lens-directory), unchanged; omit it for the first page. Unsupported cursor formats return 400. ## Responses - 200: One portion of the lens directory - 400: Unsupported cursor format or malformed cursor 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 the page is not there, or that the cursor points past the end of the directory - 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 lens list - 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/lenses' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Lens directory of one category `GET /snapchat/api/lenses/{category}` Documentation: https://monsterapi.co/docs/api/snapchat#lens-directory-of-one-category Operation ID: `snapchat_lenses_category_read` Returns a category’s lenses, or creators for the creators category, and available categories. Pass `next_cursor` as `cursor` with the same category; its absence ends pagination. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `category` (path, required): Category identifier from `categories[].id` in [GET /lenses](https://monsterapi.co/docs/api/snapchat-lenses#lens-directory): letters, digits or underscore; at most 64 characters, case-insensitive. - `cursor` (query, optional): Optional `next_cursor` from [GET /lenses/{category}](https://monsterapi.co/docs/api/snapchat-lenses#lens-directory-of-one-category) for the same category, unchanged; omit it for the first page. Unsupported cursor formats return 400. ## Responses - 200: One portion of the lenses or creators of the category - 400: Category or cursor outside the accepted format, or a malformed cursor 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 category, or the cursor points past its end - 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 neither lenses nor creators - 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/lenses/{category}' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Place page `GET /snapchat/api/place/{place_id}` Documentation: https://monsterapi.co/docs/api/snapchat#place-page Operation ID: `snapchat_place_read` Returns a place’s address, contacts, opening hours, location, daily visitor distribution, favorites, reviews and enclosing places. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `place_id` (path, required): Place UUID in lowercase hexadecimal. Available at `sections[].results[].place.id` in [GET /search](https://monsterapi.co/docs/api/snapchat-discovery#search-page). ## Responses - 200: The place - 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 place - 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/place/{place_id}' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Profile page of an account `GET /snapchat/api/profile/{username}` Documentation: https://monsterapi.co/docs/api/snapchat#profile-page-of-an-account Operation ID: `snapchat_profile_read` Returns an account’s profile, active story, highlights and metadata, lenses, tagged content, comments and related accounts. An account without a public profile has `profile.type` equal to `userInfo`. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `username` (path, required): Account handle: ASCII letters, digits, dot, underscore or hyphen; at most 64 characters, excluding `.` and `..`. Available at `sections[].results[].user.username` in [GET /search](https://monsterapi.co/docs/api/snapchat-discovery#search-page). ## Responses - 200: The profile page - 400: Handle outside the accepted format 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 account - 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/profile/{username}' \ -H 'Authorization: Bearer ' ``` --- # 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: Search page `GET /snapchat/api/search` Documentation: https://monsterapi.co/docs/api/snapchat#search-page Operation ID: `snapchat_search_read` Returns search sections of accounts, lenses, places, shows, topics and Spotlight stories, with story cards. No result sections, or an unsupported query such as `snapchat` or `snap`, returns 404. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Required search text: nonempty, without control characters, excluding `.` and `..`; at most 50 characters after percent encoding. ## Responses - 200: Sections of results - 400: Query empty, carrying a control character, or too long 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 result sections or an unsupported query - 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/search' \ -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 ' ``` --- # Snapchat: Spotlight page `GET /snapchat/api/spotlight` Documentation: https://monsterapi.co/docs/api/snapchat#spotlight-page Operation ID: `snapchat_spotlight_read` Returns a selection of Spotlight stories; the selection can vary between requests. For continuation, use [GET /feed/spotlight](https://monsterapi.co/docs/api/snapchat-spotlight#spotlight-feed). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs ## Responses - 200: Stories of the page - 400: Snapchat refused the request as malformed 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 the page is not there - 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/spotlight' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Spotlight stories by identifier `GET /snapchat/api/spotlight-stories` Documentation: https://monsterapi.co/docs/api/snapchat#spotlight-stories-by-identifier Operation ID: `snapchat_spotlight_stories_read` Returns up to 32 Spotlight story cards and generated text in requested identifier order, omitting identifiers without a matching story. Additional details appear in `data`. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `ids` (query, required): Required comma-separated list of 1 to 32 story identifiers from `remaining_ids` in [GET /topic/{slug}](https://monsterapi.co/docs/api/snapchat-spotlight#topic-page). Each contains ASCII letters, digits, underscore or hyphen, at most 128 characters. ## Responses - 200: Matching Spotlight stories - 400: Identifiers missing, more than 32 or 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 matching story - 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/spotlight-stories' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: One Spotlight video `GET /snapchat/api/spotlight/{id}` Documentation: https://monsterapi.co/docs/api/snapchat#one-spotlight-video Operation ID: `snapchat_spotlight_video_read` Returns a Spotlight video’s metadata, comments, subtitles, recommended stories and related Spotlight stories. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Video identifier: ASCII letters, digits, underscore or hyphen; at most 128 characters. Available at `stories[].snap_id` in [GET /topic/{slug}](https://monsterapi.co/docs/api/snapchat-spotlight#topic-page). ## Responses - 200: The video and its 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 such video - 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/spotlight/{id}' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Comments of a Spotlight video `GET /snapchat/api/spotlight/{id}/comments` Documentation: https://monsterapi.co/docs/api/snapchat#comments-of-a-spotlight-video Operation ID: `snapchat_spotlight_comments_read` Returns a page of comments or replies to the comment specified by `thread`, retaining repeats between adjacent pages. Pass `next_cursor` as `cursor` to this endpoint; its absence ends pagination. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Video identifier: ASCII letters, digits, underscore or hyphen; at most 128 characters. Available at `stories[].snap_id` in [GET /topic/{slug}](https://monsterapi.co/docs/api/snapchat-spotlight#topic-page). - `cursor` (query, optional): Optional `next_cursor` from [GET /spotlight/{id}/comments](https://monsterapi.co/docs/api/snapchat-spotlight#comments-of-a-spotlight-video) for the same video and thread, unchanged. Canonical padded base64, at most 8192 characters; absent or empty starts pagination. - `thread` (query, optional): Optional parent-comment object from `comments[].reply_id` in [GET /spotlight/{id}/comments](https://monsterapi.co/docs/api/snapchat-spotlight#comments-of-a-spotlight-video), encoded as JSON with unsigned 64-bit decimal-string `highBits` and `lowBits`. Absent or empty requests root comments. ## Responses - 200: One portion of comments and its continuation - 400: Video identifier, thread or cursor outside the accepted format 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: The portion has no comments and no continuation - 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 comments or continuation - 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/spotlight/{id}/comments' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Spotlight tiles by identifier `GET /snapchat/api/spotlights` Documentation: https://monsterapi.co/docs/api/snapchat#spotlight-tiles-by-identifier Operation ID: `snapchat_spotlights_read` Returns up to 32 Spotlight tiles in requested identifier order, omitting identifiers without a matching story. Additional story identifiers appear in `remaining_ids` of [GET /topic/{slug}](https://monsterapi.co/docs/api/snapchat-spotlight#topic-page). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `ids` (query, required): Required comma-separated list of 1 to 32 story identifiers from `remaining_ids` in [GET /topic/{slug}](https://monsterapi.co/docs/api/snapchat-spotlight#topic-page). Each contains ASCII letters, digits, underscore or hyphen, at most 128 characters. - `vertical` (query, required): Required collection: `topic` for identifiers from [GET /topic/{slug}](https://monsterapi.co/docs/api/snapchat-spotlight#topic-page), or `entertainment-funny` for [GET /entertainment/funny/{keyword}](https://monsterapi.co/docs/api/snapchat-spotlight#funny-videos-of-one-keyword). No other values are accepted. ## Responses - 200: Matching Spotlight tiles - 400: Identifiers missing, more than 32 or outside the accepted set, or a kind of page outside the two 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 matching tile - 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/spotlights' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Hashtag page `GET /snapchat/api/tag` Documentation: https://monsterapi.co/docs/api/snapchat#hashtag-page Operation ID: `snapchat_tag_read` Returns Spotlight story cards for a hashtag. The name is case-insensitive. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, required): Required nonempty hashtag without `#`: Unicode letters, digits or underscore; at most 100 characters, case-insensitive. Available at `sections[].results[].topic.name` in [GET /search](https://monsterapi.co/docs/api/snapchat-discovery#search-page). ## Responses - 200: The hashtag page - 400: Hashtag missing, empty or outside the accepted format 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 hashtag - 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/tag' \ -H 'Authorization: Bearer ' ``` --- # Snapchat: Topic page `GET /snapchat/api/topic/{slug}` Documentation: https://monsterapi.co/docs/api/snapchat#topic-page Operation ID: `snapchat_topic_read` Returns a topic, its initial Spotlight stories, additional story identifiers, related topics and structured metadata. The slug is case-insensitive. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `slug` (path, required): Topic slug: letters, digits or hyphen; at most 100 characters, case-insensitive. Use the last segment of `related_topics[].url` from [GET /topic/{slug}](https://monsterapi.co/docs/api/snapchat-spotlight#topic-page). ## Responses - 200: The topic page - 400: Slug outside the accepted format 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 topic - 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/topic/{slug}' \ -H 'Authorization: Bearer ' ```