Skip to main content
GET
/
v1
/
scrape
/
pinterest
/
search
Search
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/pinterest/search \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "pins": [
    {
      "node_id": "UGluOjM3Mjk2MTIyNTY2MDUxNDQ=",
      "url": "https://www.pinterest.com/pin/3729612256605144/",
      "auto_alt_text": "a close up of a plate of food with meat",
      "id": "3729612256605144",
      "is_promoted": false,
      "description": "Italian Pot Roast: A Hearty and Flavorful Recipe",
      "title": "",
      "images": {
        "orig": {
          "width": 1024,
          "height": 1024,
          "url": "https://i.pinimg.com/originals/c0/ad/f4/c0adf44a87470e7287219893efa5df75.webp"
        }
      },
      "link": "https://myauntyrecipes.com/2024/10/23/italian-pot-roast/?tp_image_id=7421",
      "domain": "myauntyrecipes.com",
      "seo_alt_text": "a close up of a plate of food with meat",
      "board": {
        "node_id": "Qm9hcmQ6MzcyOTY4MDg4MDQyNzg2OA==",
        "name": "Food",
        "id": "3729680880427868",
        "url": "/csadak/food/",
        "pin_count": 423,
        "is_collaborative": false,
        "owner": {
          "node_id": "VXNlcjozNzI5NzQ5NTk5ODUyNTc1",
          "follower_count": 85,
          "full_name": "Courtney Elizabeth",
          "id": "3729749599852575",
          "username": "csadak",
          "image_large_url": "https://i.pinimg.com/140x140_RS/71/b7/c7/71b7c71b452076af02217324c26b3f08.jpg"
        }
      },
      "grid_title": "Savory Italian Pot Roast",
      "created_at": "Tue, 07 Jan 2025 18:23:09 +0000",
      "pinner": {
        "node_id": "VXNlcjozNzI5NzQ5NTk5ODUyNTc1",
        "follower_count": 85,
        "full_name": "Courtney Elizabeth",
        "id": "3729749599852575",
        "username": "csadak",
        "image_large_url": "https://i.pinimg.com/140x140_RS/71/b7/c7/71b7c71b452076af02217324c26b3f08.jpg"
      },
      "videos": {},
      "story_pin_data": {}
    }
  ],
  "cursor": "Y2JVSG81V2...",
  "creditsUsed": 1
}
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

query
string
required

Search query

Example:

"Italian Pot Roast"

cursor
string

Cursor for pagination

Example:

"Y2JVSG81V2sxcmNHRlpWM1J..."

trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

success
boolean
Example:

true

pins
object[]
cursor
string
Example:

"Y2JVSG81V2..."

creditsUsed
integer
Example:

1