# Pinterest API Reference Canonical: https://monsterapi.co/docs/api/pinterest Read the Pinterest API 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: Board page values `GET /pinterest/api/board-page/{username}/{slug}` Documentation: https://monsterapi.co/docs/api/pinterest#board-page-values Operation ID: `pinterest_board_page_read` Returns the values the page of one board carries under this API's names: its standard metadata fields, the fields of the board's own data the page names, and the page nodes no name covers. ## 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 100 characters, excluding `.` and `..`. - `slug` (path, required): Slug of the board in the owner's address: small letters, digits, underscore or hyphen; at most 100 characters. Read it from the `url` field of a boards list item in [GET /user/{username}/boards](#pinterest_user_boards_list). ## Responses - 200: The named values of the board's page - 400: Handle or 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 board - 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/board-page/{username}/{slug}' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Board details `GET /pinterest/api/board/{username}/{slug}` Documentation: https://monsterapi.co/docs/api/pinterest#board-details Operation ID: `pinterest_board_read` Returns one board by the handle of its owner and the slug of its address, with its named values beside the data. ## 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 100 characters, excluding `.` and `..`. - `slug` (path, required): Slug of the board in the owner's address: small letters, digits, underscore or hyphen; at most 100 characters. Read it from the `url` field of a boards list item in [GET /user/{username}/boards](#pinterest_user_boards_list). ## Responses - 200: The board - 400: Handle or 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 board - 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/board/{username}/{slug}' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Pins of a board `GET /pinterest/api/boards/{board_id}/pins` Documentation: https://monsterapi.co/docs/api/pinterest#pins-of-a-board Operation ID: `pinterest_board_pins_list` Returns one page of the pins of one board, by the board's numeric identifier; `owner` and `slug` are accepted together to name the board's own page. An anonymous walk can end after the first page: an empty page without `next_cursor` answers 404. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `board_id` (path, required): Numeric identifier of a board: decimal digits, at most 20. Read it from `data[].id` in [GET /user/{username}/boards](#pinterest_user_boards_list). - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. - `owner` (query, optional): Optional handle of the board's owner, sent with `slug`, read from `data[].owner.username` in [GET /user/{username}/boards](#pinterest_user_boards_list). - `slug` (query, optional): Optional slug of the board, sent with `owner`, read from the `url` field of a boards list item in [GET /user/{username}/boards](#pinterest_user_boards_list). ## Responses - 200: One page of pins and its continuation - 400: Identifier, page keys 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: No such board, or a page with no pins 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: 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/boards/{board_id}/pins' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Sections of a board `GET /pinterest/api/boards/{board_id}/sections` Documentation: https://monsterapi.co/docs/api/pinterest#sections-of-a-board Operation ID: `pinterest_board_sections_list` Returns the sections of one board, by the board's numeric identifier, each section whole beside its named values. No continuation has been observed on this list; `next_cursor` reads `null` until the site names one. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `board_id` (path, required): Numeric identifier of a board: decimal digits, at most 20. Read it from `data[].id` in [GET /user/{username}/boards](#pinterest_user_boards_list). - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. - `owner` (query, optional): Optional handle of the board's owner, read from `data[].owner.username` in [GET /user/{username}/boards](#pinterest_user_boards_list). ## Responses - 200: The sections of the board - 400: Identifier 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: No such board, or a board with no sections - 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/boards/{board_id}/sections' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Replies to a comment `GET /pinterest/api/comment/{comment_id}/replies` Documentation: https://monsterapi.co/docs/api/pinterest#replies-to-a-comment Operation ID: `pinterest_comment_replies_list` Returns the replies to one comment of a pin's thread, by the comment's numeric identifier, each reply whole beside its named values. No continuation has been observed on this list; `next_cursor` reads `null` until the site names one. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `comment_id` (path, required): Numeric identifier of a comment: decimal digits, at most 20. Read it from `data[].id` in [GET /comments/{aggregated_pin_id}](#pinterest_comments_list). - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. - `pin` (query, optional): Optional numeric identifier of the pin the comment thread hangs on: decimal digits, at most 20. Read it from the `pin_id` path parameter of [GET /pin/{pin_id}](#pinterest_pin_read). ## Responses - 200: The replies of the comment - 400: Identifier 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: No such comment, or a page with no replies 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: 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/comment/{comment_id}/replies' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Comments on a pin `GET /pinterest/api/comments/{aggregated_pin_id}` Documentation: https://monsterapi.co/docs/api/pinterest#comments-on-a-pin Operation ID: `pinterest_comments_list` Returns one page of the comments on one pin, each comment whole beside its named values; pass `next_cursor` as `cursor` to this endpoint for the next page. The identifier is the aggregated pin of [GET /pin/{pin_id}](#pinterest_pin_read), field `pin.aggregated_pin_id` — not the pin's own identifier. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `aggregated_pin_id` (path, required): Numeric identifier of the aggregated pin the comments of a pin hang on: decimal digits, at most 20. Read it from `pin.aggregated_pin_id` in [GET /pin/{pin_id}](#pinterest_pin_read) — `data.aggregated_pin_data.id` of the same answer — not from the pin's own identifier. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. - `pin` (query, optional): Optional numeric identifier of the pin the comment thread hangs on: decimal digits, at most 20. Read it from the `pin_id` path parameter of [GET /pin/{pin_id}](#pinterest_pin_read). ## Responses - 200: One page of comments and its continuation - 400: Identifier 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: No comments on the pin, or a page with 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: 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/comments/{aggregated_pin_id}' \ -H 'Authorization: Bearer ' ``` --- # 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 ' ``` --- # Pinterest: Pin page values `GET /pinterest/api/pin-page/{pin_id}` Documentation: https://monsterapi.co/docs/api/pinterest#pin-page-values Operation ID: `pinterest_pin_page_read` Returns the values a pin's page carries under this API's names, including `video_urls`: every media address the page names for the pin's video and audio renditions. Those addresses are the input of the media endpoints of this API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `pin_id` (path, required): Numeric identifier of a pin: decimal digits, at most 20. Read it from `data[].id` of any pins list of this API, or `data.id` in [GET /pin/{pin_id}](#pinterest_pin_read). ## Responses - 200: The named values of the pin's page - 400: Identifier 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 pin - 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/pin-page/{pin_id}' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Pin details `GET /pinterest/api/pin/{pin_id}` Documentation: https://monsterapi.co/docs/api/pinterest#pin-details Operation ID: `pinterest_pin_read` Returns one pin by its numeric identifier, each field whole beside its named values. The `pin` object names the aggregated pin the comments of the pin hang on. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `pin_id` (path, required): Numeric identifier of a pin: decimal digits, at most 20. Read it from `data[].id` of any pins list of this API, or `data.id` in [GET /pin/{pin_id}](#pinterest_pin_read). ## Responses - 200: The pin - 400: Identifier 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 pin - 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/pin/{pin_id}' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Pins close to a pin `GET /pinterest/api/pin/{pin_id}/related` Documentation: https://monsterapi.co/docs/api/pinterest#pins-close-to-a-pin Operation ID: `pinterest_pin_related_list` Returns one page of the pins the site names close to one pin, by the pin's numeric identifier, each pin whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `pin_id` (path, required): Numeric identifier of a pin: decimal digits, at most 20. Read it from `data[].id` of any pins list of this API, or `data.id` in [GET /pin/{pin_id}](#pinterest_pin_read). - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of pins and its continuation - 400: Identifier 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: No such pin, or a page with no pins 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: 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/pin/{pin_id}/related' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Account page values `GET /pinterest/api/profile-page/{username}` Documentation: https://monsterapi.co/docs/api/pinterest#account-page-values Operation ID: `pinterest_profile_page_read` Returns the values the page of an account carries under this API's names: its standard metadata fields, the fields of the account's own data the page names, and the page nodes no name covers. ## 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 100 characters, excluding `.` and `..`. ## Responses - 200: The named values of the account's 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: 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/profile-page/{username}' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Boards matching a phrase `GET /pinterest/api/search/boards` Documentation: https://monsterapi.co/docs/api/pinterest#boards-matching-a-phrase Operation ID: `pinterest_search_boards_list` Returns one page of the boards whose name or content matches a search phrase, each board whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `query` (query, required): The search phrase: free text, required, 1 to 256 characters after trimming. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of boards and its continuation - 400: Phrase 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: No boards for the phrase, or a page with no boards 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: 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/search/boards' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Accounts matching a phrase `GET /pinterest/api/search/users` Documentation: https://monsterapi.co/docs/api/pinterest#accounts-matching-a-phrase Operation ID: `pinterest_search_users_list` Returns one page of the accounts whose name matches a search phrase, each account whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `query` (query, required): The search phrase: free text, required, 1 to 256 characters after trimming. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of accounts and its continuation - 400: Phrase 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: No accounts for the phrase, or a page with no accounts 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: 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/search/users' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Section details `GET /pinterest/api/section/{section_id}` Documentation: https://monsterapi.co/docs/api/pinterest#section-details Operation ID: `pinterest_section_read` Returns one section of a board by the section's numeric identifier, with its named values beside the data. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `section_id` (path, required): Numeric identifier of a board section: decimal digits, at most 20. Read it from `data[].id` in [GET /boards/{board_id}/sections](#pinterest_board_sections_list). - `owner` (query, optional): Optional handle of the board's owner, read from `data[].owner.username` in [GET /user/{username}/boards](#pinterest_user_boards_list). ## Responses - 200: The section - 400: Identifier 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 section - 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/section/{section_id}' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Pins of a board section `GET /pinterest/api/section/{section_id}/pins` Documentation: https://monsterapi.co/docs/api/pinterest#pins-of-a-board-section Operation ID: `pinterest_section_pins_list` Returns one page of the pins of one board section, by the section's numeric identifier. Items the site types other than `pin` stay in `data` alone; pass `next_cursor` as `cursor` to this endpoint for the next page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `section_id` (path, required): Numeric identifier of a board section: decimal digits, at most 20. Read it from `data[].id` in [GET /boards/{board_id}/sections](#pinterest_board_sections_list). - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. - `owner` (query, optional): Optional handle of the board's owner, read from `data[].owner.username` in [GET /user/{username}/boards](#pinterest_user_boards_list). ## Responses - 200: One page of pins and its continuation - 400: Identifier 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: No such section, or a page with no pins 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: 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/section/{section_id}/pins' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Profile of an account `GET /pinterest/api/user/{username}` Documentation: https://monsterapi.co/docs/api/pinterest#profile-of-an-account Operation ID: `pinterest_user_read` Returns the public profile data of an account: names, identifiers, counters and the data Pinterest holds beside them. The `user` object repeats the key values under stable names. ## 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 100 characters, excluding `.` and `..`. ## Responses - 200: The profile - 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: 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/user/{username}' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Boards of an account `GET /pinterest/api/user/{username}/boards` Documentation: https://monsterapi.co/docs/api/pinterest#boards-of-an-account Operation ID: `pinterest_user_boards_list` Returns one page of the boards of an account, each board whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## 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 100 characters, excluding `.` and `..`. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of boards and its continuation - 400: Handle 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: No such account, or a page with no boards 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: 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/user/{username}/boards' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Pins created by an account `GET /pinterest/api/user/{username}/created` Documentation: https://monsterapi.co/docs/api/pinterest#pins-created-by-an-account Operation ID: `pinterest_user_created_pins_list` Returns one page of the pins an account has created, each pin whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## 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 100 characters, excluding `.` and `..`. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of pins and its continuation - 400: Handle 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: No such account, or a page with no pins 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: 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/user/{username}/created' \ -H 'Authorization: Bearer ' ``` --- # Pinterest: Pins saved by an account `GET /pinterest/api/user/{username}/pins` Documentation: https://monsterapi.co/docs/api/pinterest#pins-saved-by-an-account Operation ID: `pinterest_user_pins_list` Returns one page of the pins an account has saved, each pin whole beside its named values. Pass `next_cursor` as `cursor` to this endpoint for the next page. ## 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 100 characters, excluding `.` and `..`. - `cursor` (query, optional): Optional `next_cursor` of this endpoint's previous answer, unchanged: the base64 value the endpoint itself printed; absent starts at the first page. ## Responses - 200: One page of pins and its continuation - 400: Handle 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: No such account, or a page with no pins 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: 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/user/{username}/pins' \ -H 'Authorization: Bearer ' ```