# Pinterest Media API Reference Canonical: https://monsterapi.co/docs/api/pinterest-media Read the Pinterest Media reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [Pinterest](https://monsterapi.co/docs/openapi/platforms/pinterest.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # Pinterest: DASH manifest contents `GET /pinterest/api/media/dash` Documentation: https://monsterapi.co/docs/api/pinterest#dash-manifest-contents Operation ID: `pinterest_media_dash_read` Returns the contents of one DASH manifest of the media CDN: the document as a tree of elements, each with its namespaced name, its attributes and its text. The addresses the tree names are relative to the manifest's own. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Address of the media object, `https`, on `v1.pinimg.com` under `/videos/` or on `i.pinimg.com` under any path. Read it from `video_urls` in [GET /pin-page/{pin_id}](#pinterest_pin_page_read), which names every media address of the pin. ## Responses - 200: The manifest, read whole - 400: Address outside the accepted hosts and paths 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 manifest - 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: Pinterest 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/pinterest/api/media/dash' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Media file contents `GET /pinterest/api/media/file` Documentation: https://monsterapi.co/docs/api/pinterest#media-file-contents Operation ID: `pinterest_media_file_read` Returns one media file of the CDN: its content type, its length in bytes and its whole body in base64. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Address of the media file, `https`, on `i.pinimg.com` under any path or on `v1.pinimg.com` under `/videos/`. Read it from `video_urls` or `image` in [GET /pin-page/{pin_id}](#pinterest_pin_page_read), which names the media addresses and the image of the pin. ## Responses - 200: The file, whole - 400: Address outside the accepted hosts and paths 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 file - 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: Pinterest 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/pinterest/api/media/file' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: HLS playlist contents `GET /pinterest/api/media/hls` Documentation: https://monsterapi.co/docs/api/pinterest#hls-playlist-contents Operation ID: `pinterest_media_hls_read` Returns the contents of one HLS playlist of the media CDN: every line as a record, the attributes of the tags that carry them, and every address resolved against the playlist's own. A master, variant and audio playlist are answered alike. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Address of the media object, `https`, on `v1.pinimg.com` under `/videos/` or on `i.pinimg.com` under any path. Read it from `video_urls` in [GET /pin-page/{pin_id}](#pinterest_pin_page_read), which names every media address of the pin. ## Responses - 200: The playlist, read whole - 400: Address outside the accepted hosts and paths 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 playlist - 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: Pinterest 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/pinterest/api/media/hls' \ -H 'Authorization: Bearer ' ```