Pinterest Home API
Collect Pinterest profile information and first-page works.
API Description
Pinterest Home API — Collect Pinterest profile information and first-page works.
Authenticate with your Pangolinfo API Key to receive structured JSON data.
Request URL
Request Headers
| 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.
Includes first-page works. Use the works operation, where available, to continue.
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. |
| profile | object | Profile details. |
| works | object[] | Collected works. |
data.profile Fields
| Field | Type | Description |
|---|---|---|
| accountId | string | null | Account id |
| userId | string | null | User id |
| username | string | null | Username |
| nickname | string | null | Author display name. |
| fullName | string | null | Full name |
| firstName | string | null | First name |
| profileUrl | string | Author profile URL. |
| avatar | string | null | Avatar URL. |
| followersCount | number | null | Followers count |
| followingCount | number | null | Following count |
| postsCount | number | null | Posts count |
| bio | string | null | Bio |
| registerTime | object | Register time |
| isPrivate | boolean | Is private |
| verified | boolean | Verified |
| contactEmail | string | null | Contact email |
| externalLinks | string[] | External links |
| boardCount | number | null | Board count |
| websiteUrl | string | null | Website url |
| domainUrl | string | null | Domain url |
| domainVerified | boolean | Domain verified |
| instagramUsername | string | null | Instagram username |
| targetUrl | string | Target url |
data.profile.registerTime Fields
| Field | Type | Description |
|---|---|---|
| text | string | null | Text value. |
| timestamp | number | null | Timestamp |
| iso | string | null | Iso |
data.works[] Fields
| Field | Type | Description |
|---|---|---|
| workId | string | Work id |
| pinId | string | Pin id |
| workType | string | Work type Values: [“pin”] |
| url | string | Content URL. |
| title | string | null | Title |
| content | string | null | Content text; may be null for records without text. |
| description | string | null | Description |
| cover | string | null | Cover |
| image | string | null | Image |
| imageWidth | number | null | Image width |
| imageHeight | number | null | Image height |
| comments | number | null | Root comments in comment mode. |
| repinCount | number | null | Repin count |
| createdAt | string | null | Created at |
| publishedAt | number | null | Publication time. |
| link | string | null | Link |
| linkDomain | string | null | Link domain |
| isVideo | boolean | Is video |
| dominantColor | string | null | Dominant color |
| reactionCounts | object | null | Reaction counts |
| board | object | null | Board |
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.
Points Usage
0.8 points per profile. Included works 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.

