# Snapchat Spotlight API Reference Canonical: https://monsterapi.co/docs/api/snapchat-spotlight Read the Snapchat Spotlight 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: 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: 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: 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 ' ```