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