---
title: "Search Pinterest for pins by keyword"
method: GET
path: "/pinterest/search"
tags: ["Pinterest API"]
---

# Search Pinterest for pins by keyword

`GET /pinterest/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/pinterest/search`
- Auth: API key in header `X-API-KEY`

This endpoint allows you to search for pins on Pinterest using a keyword query.
Returns a list of pins with their titles, descriptions, images, and pinner information.
Supports pagination using the bookmark parameter for retrieving large result sets.

## Query parameters

- `query` string, required
- `limit` integer, nullable
- `bookmark` string, nullable

## Response `200`

- object
  - `query` string, required
  - `count` integer, required
  - `results_count` integer, required
  - `nextBookmark` string, nullable, required
  - `pins` object[], required
    - `id` string, nullable, required
    - `title` string, nullable, required
    - `description` string, nullable, required
    - `image_url` string, nullable, required
    - `images` object, required
      - `orig` object, nullable, required
        - `url` string, required
        - `width` integer, nullable, required
        - `height` integer, nullable, required
      - `736x` object, nullable, required
        - `url` string, required
        - `width` integer, nullable, required
        - `height` integer, nullable, required
      - `474x` object, nullable, required
        - `url` string, required
        - `width` integer, nullable, required
        - `height` integer, nullable, required
      - `236x` object, nullable, required
        - `url` string, required
        - `width` integer, nullable, required
        - `height` integer, nullable, required
      - `170x` object, nullable, required
        - `url` string, required
        - `width` integer, nullable, required
        - `height` integer, nullable, required
    - `link` string, nullable, required
    - `domain` string, nullable, required
    - `pinner` object, required
      - `id` string, nullable, required
      - `username` string, nullable, required
      - `full_name` string, nullable, required
      - `profile_url` string, nullable, required
      - `follower_count` integer, nullable, required
    - `board` object, required
      - `id` string, nullable, required
      - `name` string, nullable, required
      - `url` string, nullable, required
    - `created_at` string, nullable, required
    - `dominant_color` string, nullable, required
    - `is_video` boolean, required
    - `video_url` string, nullable, required
    - `video_duration` number, nullable, required
    - `saves` integer, nullable, required
    - `likes` integer, nullable, required
    - `comments` integer, nullable, required
    - `hashtags` string[], required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)