# Pinterest Pages API Reference

Canonical: https://monsterapi.co/docs/api/pinterest-pages

Read the Pinterest Pages 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 <YOUR_API_KEY>` 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 <YOUR_API_KEY>'

```

---

# 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 <YOUR_API_KEY>` 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 <YOUR_API_KEY>'

```

---

# 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 <YOUR_API_KEY>` 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 <YOUR_API_KEY>'

```
