# Pinterest Boards API Reference Canonical: https://monsterapi.co/docs/api/pinterest-boards Read the Pinterest Boards 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 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: 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: 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 ' ```