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