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