API Description
Pinterest Post API — Collect Pinterest post details and available author, media and comment data.
Authenticate with your Pangolinfo API Key to receive structured JSON data.
Request URL
| Parameters | Parameter value | Type | Description |
|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.
Request Parameters
| Parameter | Required | Type | Description |
|---|
| target | Yes | string | Target URL, supported ID or search keyword for this operation. |
Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.
Included comments are limited to one page. Use the corresponding comments operation for more.
Response Fields
| Field | Type | Description |
|---|
| code | integer | Status code; 0 indicates success. |
| message | string | Response message; ok on success. |
| pointCost | number | Points charged for this request. |
| data | object | Collected data, with fields described below. |
| meta | object | Request identifier and duration in milliseconds. |
| billing | object | Charged units, unit price and billing rule version. |
data Fields
| Field | Type | Description |
|---|
| type | string | Result type. |
| poster | object | Poster |
| post | object | Post, video or business details. |
| comments | object[] | Root comments in comment mode. |
| pagination | object | Continuation cursor and whether more results are available. |
data.poster Fields
| Field | Type | Description |
|---|
| id | string | null | Record identifier. |
| username | string | null | Username |
| nickname | string | null | Author display name. |
| avatar | string | null | Avatar URL. |
| profileUrl | string | null | Author profile URL. |
data.post Fields
| Field | Type | Description |
|---|
| id | string | Record identifier. |
| url | string | Content URL. |
| title | string | null | Title |
| captionText | string | null | Caption text |
| publishedAt | object | null | Publication time. |
| likes | number | Like count. |
| commentsCount | number | null | Platform-reported comment total; not the number billed. |
| share | number | null | Share |
| repins | number | null | Repins |
| reactions | object | Reactions |
| link | string | null | Link |
| domain | string | null | Domain |
| isVideo | boolean | Is video |
| cover | string | null | Cover |
| media | object[] | Media |
| board | object | null | Board |
| altText | string | null | Alt text |
| dominantColor | string | null | Dominant color |
data.post.publishedAt Fields
| Field | Type | Description |
|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
data.post.media[] Fields
| Field | Type | Description |
|---|
| type | string | Result type. |
| url | string | Content URL. |
| width | number | null | Width |
| height | number | null | Height |
| cover | string | null | Cover |
| durationMs | number | null | Duration in milliseconds. |
data.post.board Fields
| Field | Type | Description |
|---|
| id | string | null | Record identifier. |
| name | string | null | Name |
| url | string | null | Content URL. |
| Field | Type | Description |
|---|
| id | string | Record identifier. |
| content | string | null | Content text; may be null for records without text. |
| avatar | string | null | Avatar URL. |
| nickname | string | null | Author display name. |
| profileUrl | string | null | Author profile URL. |
| userId | string | null | User id |
| username | string | null | Username |
| createdAt | object | null | Created at |
| likes | number | Like count. |
| replyCount | number | Platform-reported reply count. |
| Field | Type | Description |
|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
| Field | Type | Description |
|---|
| comments | object | Root comments in comment mode. |
| Field | Type | Description |
|---|
| bookmark | string | null | Bookmark |
| hasMore | boolean | Whether more results are available. |
Request Example
Response Example
This excerpt shows the first item of each list. Long text and URLs are shortened; pointCost is the charge for the complete response. The playground contains the full schema.
{
"code": 0,
"message": "ok",
"pointCost": 0.8,
"data": {
"type": "post",
"poster": {
"id": "1108730139422030209",
"username": "sitamvan99",
"nickname": "demit",
"avatar": "https://i.pinimg.com/75x75_RS/2f/47/f4/2f47f4a29f2d1bcd2aaf98fa8cdc1589.jpg",
"profileUrl": "https://www.pinterest.com/sitamvan99/"
},
"post": {
"id": "1108730002048681108",
"url": "https://www.pinterest.com/pin/1108730002048681108/",
"title": "gw tampol lu !!!",
"captionText": " ",
"publishedAt": {
"text": "Fri, 25 Sep 2026 07:43:43 +0000",
"value": 1790322223000
},
"likes": 1610,
"commentsCount": 25,
"share": 1263,
"repins": 9170,
"reactions": {
"1": 1610
},
"link": null,
"domain": "Uploaded by user",
"isVideo": false,
"cover": "https://i.pinimg.com/originals/ff/30/04/ff30040be43bcb3f50078af23387ee6f.jpg",
"media": [
{
"type": "image",
"url": "https://i.pinimg.com/originals/ff/30/04/ff30040be43bcb3f50078af23387ee6f.jpg",
"width": 720,
"height": 964
}
],
"board": {
"id": "1108730070703919386",
"name": "kocheng (dagelan menk)",
"url": "https://www.pinterest.com/sitamvan99/kocheng-dagelan-menk/"
},
"altText": "a cat that is standing on top of a bed with its paw in the air",
"dominantColor": "#7c796e"
},
"comments": [
{
"id": "3966707891758649216",
"content": "tigerclaw/star when bluestar didnt give him deputy after he murdered redtail",
"avatar": null,
"nickname": "𓆩",
"profileUrl": "https://www.pinterest.com/Equ3str1anL0v3/",
"userId": "960252089207135960",
"username": "Equ3str1anL0v3",
"createdAt": {
"text": "Thu, 22 Oct 2026 06:05:07 +0000",
"value": 1792649107000
},
"likes": 0,
"replyCount": 0
}
],
"pagination": {
"comments": {
"bookmark": "Y2JVSG80ZUdaRVJYcE5ha2w0VFdwck1FNTZRVFZQVkdNMFRrUlZjVkl4UmsxTGJuY3pUMGRGTTA5RVdtdGFWMGt3V2tSWk1FMUVVbWhOZW1odFQxZEthRTFFU214WmJVVXpUMVJaTWs5VVFtMVpla0UwV2tkV...",
"hasMore": true
}
}
},
"meta": {
"requestId": "pg-audit-r1-pinterest-post-1793954225921962300",
"durationMs": 3692
},
"billing": {
"unitPrice": 0.8,
"ruleVersion": "social-primary-v2",
"billedCount": 1,
"pointCost": 0.8
}
}
Points Usage
0.8 points per post, video or business. Included comments, replies and author details are free.
Empty results and failed requests are not charged. Duplicate IDs are counted once within a response. Separate calls and pages are billed separately. See Social Media Reviews API billing.
Try it
