List Pins
GET {{baseUrl}}/pins?bookmark=<string>&pin_filter=exclude_repins&include_protected_pins=false&pin_type=PRIVATE&creative_types=CAROUSEL&creative_types=SHOPPING&ad_account_id=579382468
Get a list of the Pins owned by the operation user_account
.
- By default, the operation user_account
is the token useraccount.
- All Pins owned by the "operation useraccountare included, regardless of who owns the board they are on.
Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the
operation user_account".
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
bookmark | string | Cursor used to fetch the next page of items | |
pin_filter | string | Pin filter. | |
include_protected_pins | boolean | Specify if return pins from protected boards | |
pin_type | string | The type of pins to return, currently only enabled for private pins | |
creative_types | string | Pin creative types filter. | |
creative_types | string | Pin creative types filter. | |
ad_account_id | number | Unique identifier of an ad account. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"id":"54288","created_at":"\u003cdateTime\u003e","link":"\u003cstring\u003e","title":"\u003cstring\u003e","description":"\u003cstring\u003e","dominant_color":"\u003cstring\u003e","alt_text":"\u003cstring\u003e","creative_type":"CAROUSEL","board_id":"68309006","board_section_id":"453","board_owner":{"username":"\u003cstring\u003e"},"media":{"media_type":"\u003cstring\u003e"},"media_source":{"source_type":"image_base64","content_type":"image/jpeg","data":"lAq3","is_standard":true},"parent_pin_id":"341800758"},{"id":"2977927709","created_at":"\u003cdateTime\u003e","link":"\u003cstring\u003e","title":"\u003cstring\u003e","description":"\u003cstring\u003e","dominant_color":"\u003cstring\u003e","alt_text":"\u003cstring\u003e","creative_type":"IDEA","board_id":"80134508","board_section_id":"183547591","board_owner":{"username":"\u003cstring\u003e"},"media":{"media_type":"\u003cstring\u003e"},"media_source":{"source_type":"image_base64","content_type":"image/jpeg","data":"E87USIFdtz","is_standard":true},"parent_pin_id":"42"}],"bookmark":"\u003cstring\u003e"}