Pinterest Search

Searches Pinterest for pins matching a query, returning results with id, url, title, description, images, link, domain, board info, and pinner details.

1 credit / request

Open Playground

GET /v1/pinterest/search Try it

Pinterest Search
GET /v1/pinterest/search

Searches Pinterest for pins matching a query, returning results with id, url, title, description, images, link, domain, board info, and pinner details.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/pinterest/search?query=Italian+Pot+Roast&cursor=Y2JVSG81V2sxcmNHRlpWM1J...&trim=false

Parameters:
- query (query · string · required) = Italian Pot Roast
- cursor (query · string · optional) = Y2JVSG81V2sxcmNHRlpWM1J...
- trim (query · boolean · optional) = false

Overview

WakeScrap exposes this Pinterest endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

Searches Pinterest for pins matching a query, returning results with id, url, title, description, images, link, domain, board info, and pinner details. Supports pagination via cursor and a trim option for lighter responses.

Required params: query.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

query string required

Search query

Example:

Italian Pot Roast

cursor string

Cursor

Example:

Y2JVSG81V2sxcmNHRlpWM1J...

trim boolean

Set to true for a trimmed down version of the response

Example:

false


              curl 'https://api.datawake.ai/v1/pinterest/search?query=Italian+Pot+Roast&cursor=Y2JVSG81V2sxcmNHRlpWM1J...&trim=false' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/pinterest/search?query=Italian+Pot+Roast&cursor=Y2JVSG81V2sxcmNHRlpWM1J...&trim=false", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/pinterest/search?query=Italian+Pot+Roast&cursor=Y2JVSG81V2sxcmNHRlpWM1J...&trim=false",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/pinterest/search?query=Italian+Pot+Roast&cursor=Y2JVSG81V2sxcmNHRlpWM1J...&trim=false",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/pinterest/search?query=Italian+Pot+Roast&cursor=Y2JVSG81V2sxcmNHRlpWM1J...&trim=false", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/pinterest/search?query=Italian+Pot+Roast&cursor=Y2JVSG81V2sxcmNHRlpWM1J...&trim=false"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "pins": [
    {
      "id": "643874078015272259",
      "url": "https://www.pinterest.com/pin/643874078015272259",
      "description": "#cute #animal #dog #puppy #pfp #icon #dogpfp #silly #cutepuppy #bordercollie #fyp #trend",
      "created_at": "Tue, 10 Jun 2025 21:45:32 +0000",
      "pinner": {
        "node_id": "VXNlcjo2NDM4NzQyMTUzODQxMzkwMTg=",
        "full_name": "Annika Strøm",
        "is_ads_only_profile": false,
        "username": "annikastrom2",
        "image_medium_url": "https://i.pinimg.com/75x75_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
        "is_primary_website_verified": false,
        "follower_count": 2,
        "ads_only_profile_site": null,
        "id": "643874215384139018",
        "is_verified_merchant": false,
        "image_large_url": "https://i.pinimg.com/140x140_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
        "verified_identity": {},
        "image_small_url": "https://i.pinimg.com/30x30_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg"
      },
      "images": {
        "170x": {
          "width": "...",
          "height": "...",
          "url": "..."
        },
        "236x": {
          "width": "...",
          "height": "...",
          "url": "..."
        },
        "474x": {
          "width": "...",
          "height": "...",
          "url": "..."
        },
        "736x": {
          "width": "...",
          "height": "...",
          "url": "..."
        },
        "orig": {
          "width": "...",
          "height": "...",
          "url": "..."
        }
      }
    }
  ],
  "cursor": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWl..."
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}