Search public Pinterest pins by keyword and return normalized pin, image, creator, board, and source data.
Endpoint
- Path:
/api/v1/pinterest/search - Cost: 1 credit per successful request
Query parameters
| Name | Required | Description | Example |
|---|---|---|---|
query | Yes | The keyword or phrase to search for. | social listening |
cursor | No | The cursor returned by the previous response. | Y2JVSG81V2sxcmNHRlpWM1J... |
raw | No | Include the unchanged provider response in the raw field. Defaults to false. | true |
curl --get 'https://api.sociallisteningapi.com/api/v1/pinterest/search' \
--data-urlencode 'query=social listening' \
--data-urlencode 'raw=true' \
--header 'x-api-key: YOUR_API_KEY'Responses
{
"success": true,
"platform": "pinterest",
"endpoint": "/api/v1/pinterest/search",
"data": {
"items": [
{
"id": "3729612256605144",
"platform": "pinterest",
"url": "https://www.pinterest.com/pin/3729612256605144/",
"content": {
"title": "Savory Italian Pot Roast",
"text": "Italian Pot Roast: A Hearty and Flavorful Recipe",
"media_urls": [
"https://i.pinimg.com/originals/example.webp"
],
"thumbnail_url": "https://i.pinimg.com/originals/example.webp"
},
"author": {
"id": "3729749599852575",
"username": "csadak",
"display_name": "Courtney Elizabeth",
"avatar_url": "https://i.pinimg.com/140x140_RS/example.jpg",
"verified": false
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"published_at": "2025-01-07T18:23:09.000Z",
"ext": {
"external_url": "https://example.com/italian-pot-roast",
"domain": "example.com",
"auto_alt_text": "A plate of Italian pot roast",
"seo_alt_text": "A plate of Italian pot roast",
"is_promoted": false,
"board_id": "3729680880427868",
"board_name": "Food",
"board_url": "/csadak/food/",
"board_pin_count": 423
}
}
]
},
"pagination": {
"next_cursor": "Y2JVSG81V2sxcmNHRlpWM1J...",
"has_more": true,
"page_size": 1
},
"raw": {
"success": true,
"credits_remaining": 99,
"credits_charged": 1,
"pins": [],
"cursor": "Y2JVSG81V2sxcmNHRlpWM1J..."
},
"request_id": "req_example123",
"credits_used": 1,
"credits_remaining": 99
}