---
title: "Changes to Search user's Pins"
method: GET
path: "/search/pins"
---

# Changes to Search user's Pins

`GET /search/pins`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 7 info
- **2025-10-16** (v5) `14c297539b64` — 4 warning
- **2025-08-14** (v5) `7d64d863909a` — 4 breaking, 2 warning, 7 info
- **2025-07-16** (v5) `43134ca41f18` — 2 info
- **2025-04-04** (v5) `10f9eba4ad97` — 1 warning, 3 info
- **2024-04-23** (v5) `f9321315766f` — 1 breaking
- **2024-02-08** (v5) `7529b464d5cb` — 1 info
- **2023-08-17** (v5) `0ff12596bafd` — 1 info
- **2023-07-14** (v5) `52586a274771` — 2 breaking, 10 info
- **2023-05-12** (v5) `689b4b267639` — 2 breaking, 4 warning, 10 info
- **2023-02-14** (v5) `be19b77aa78a` — 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 7 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/Paginated, subschema #2` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
  - added the optional property `bookmark` to the response with the `200` status
  - added the required property `items` to the response with the `200` status
- **2025-10-16** (v5) `14c297539b64` — 4 warning
  - removed the optional property `allOf[subschema #2]/items/items/note` from the response with the `200` status
  - added the new `COLLAGE` enum value to the `allOf[subschema #2]/items/items/creative_type/allOf[subschema #1: CreativeType enum used ads]/` response property for the response status `200`
  - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the `allOf[subschema #2]/items/items/creative_type/allOf[subschema #1: CreativeType enum used ads]/` response property for the response status `200`
  - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the `allOf[subschema #2]/items/items/creative_type/allOf[subschema #1: CreativeType enum used ads]/` response property for the response status `200`
- **2025-08-14** (v5) `7d64d863909a` — 4 breaking, 2 warning, 7 info
  - added `#/components/schemas/PinMediaWithImage, #/components/schemas/PinMediaWithVideo, #/components/schemas/PinMediaWithImages, #/components/schemas/PinMediaWithVideos, #/components/schemas/PinMediaWithImageAndVideo` to the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media -> subschema #1: Pin media response object.]/` response property `oneOf` list for the response status `200`
  - the `allOf[subschema #2]/items/items/board_owner` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `allOf[subschema #2]/items/items/creative_type` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `allOf[subschema #2]/items/items/media` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `allOf[subschema #2]/items/items/is_removable` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/items/items/product_tags` from the response with the `200` status
  - the response optional property `allOf[subschema #2]/items/items/id` became not read-only for the status `200`
  - the response optional property `allOf[subschema #2]/items/items/is_standard` became read-only for the status `200`
  - the response optional property `allOf[subschema #2]/items/items/pin_metrics` became read-only for the status `200`
  - removed the optional write-only property `allOf[subschema #2]/items/items/media_source` from the response with the `200` status
  - removed `#/components/schemas/PinMediaBase, subschema #2` from the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media -> subschema #1: Pin media response object.]/` response property `allOf` list for the response status `200`
  - the response property `allOf[subschema #2]/items/items/id` became required for the status `200`
  - added discriminator to `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media -> subschema #1: Pin media response object.]/` response property for the response status `200`
- **2025-07-16** (v5) `43134ca41f18` — 2 info
  - added the optional property `allOf[subschema #2]/items/items/is_removable` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/product_tags` to the response with the `200` status
- **2025-04-04** (v5) `10f9eba4ad97` — 1 warning, 3 info
  - removed the optional property `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/media_type` from the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_key_frame_time` to the response with the `200` status
  - added `#/components/schemas/PinMediaBase, subschema #2` to the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/` response property `allOf` list for the response status `200`
  - removed discriminator from `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/` response property for the response status `200`
- **2024-04-23** (v5) `f9321315766f` — 1 breaking
  - the `allOf[subschema #2]/` response's property type/format changed from ``/`` to `object`/`` for status `200`
- **2024-02-08** (v5) `7529b464d5cb` — 1 info
  - added the optional property `allOf[subschema #2]/items/items/pin_metrics` to the response with the `200` status
- **2023-08-17** (v5) `0ff12596bafd` — 1 info
  - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #6: Pin URL]/is_affiliate_link` to the response with the `200` status
- **2023-07-14** (v5) `52586a274771` — 2 breaking, 10 info
  - the response property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_url` became optional for the status `200`
  - added `#/components/schemas/PinMediaSourcePinURL` to the `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/` response property `oneOf` list for the response status `200`
  - removed the pattern `(?!^\d+$)^.+$` from the `query` request parameter `query`
  - added the optional property `allOf[subschema #2]/items/items/has_been_promoted` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/is_owner` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/is_standard` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_content_type` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_data` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/note` to the response with the `200` status
  - added `#/components/schemas/CreativeType` to the `allOf[subschema #2]/items/items/creative_type` response property `allOf` list for the response status `200`
  - removed `subschema #1: Creative Type` from the `allOf[subschema #2]/items/items/creative_type` response property `allOf` list for the response status `200`
  - added `pin_url` discriminator mapping keys to the `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/` response property for the response status `200`
- **2023-05-12** (v5) `689b4b267639` — 2 breaking, 4 warning, 10 info
  - the `query` request parameter `query` became required
  - added the pattern `(?!^\d+$)^.+$` to the `query` request parameter `query`
  - deleted the `query` request parameter `board`
  - deleted the `query` request parameter `richtype`
  - deleted the `query` request parameter `rs`
  - deleted the `query` request parameter `topic_based`
  - the security scope `boards:read` was added to the endpoint's security scheme `pinterest_oauth2`
  - the security scope `boards:read_secret` was added to the endpoint's security scheme `pinterest_oauth2`
  - the security scope `pins:read` was added to the endpoint's security scheme `pinterest_oauth2`
  - the security scope `pins:read_secret` was added to the endpoint's security scheme `pinterest_oauth2`
  - the security scope `user_accounts:read` was removed from the endpoint's security scheme `pinterest_oauth2`
  - added the new optional `query` request parameter `ad_account_id`
  - added the optional property `allOf[subschema #2]/items/items/creative_type` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #1: Image Base64]/is_standard` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #2: Image URL]/is_standard` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/is_standard` to the response with the `200` status
- **2023-02-14** (v5) `be19b77aa78a` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/search/pins/get.md) · [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/search/pins/get)