Get pins from a board

Try in Playground

Retrieve a page of pins from a public board, including the board information attached to each pin. Pass cursor and an optional board_id for the next page and use trim for compact pin records.

GET/v1/pinterest/boardx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringrequiredquery

Required HTTPS pinterest.com or www.pinterest.com board URL (/<handle>/<slug>/). Board slugs currently accept ASCII letters, digits, underscores and hyphens. No credentials, explicit ports, short links, regional domains or encoded path segments. Tracking query parameters and fragments are removed.

max 2048 chars

Examplehttps://www.pinterest.com/example/recipes/

cursorstringquery

Optional source bookmark returned by the previous response. Reuse with the same query, handle, or board. Null means end of results unless coverage warns pagination_unavailable. Source cursors can expire. Maximum 16,384 characters.

min 1 chars · max 16384 chars

board_idstringquery

Optional numeric board id (board.id on every returned pin). With cursor, the continuation reads the board feed directly and still checks every pin against this id; without cursor the board is resolved as on the first page.

trimenumquery

Optional true or false (default false). True selects the documented compact fields; false preserves the public source record and nested extensions. Missing source fields remain absent.

one of: true, false

Response fields

successboolean

True when usable supported data was retrieved.

statusenum

success, partial, failed, or challenged. Partial results carry coverage warnings.

one of: success, partial

requestIdstring

Opaque operation identifier for correlation.

sourceUrlstring

Canonical public source page. This field can contain the requested search query.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time. Every call makes fresh upstream requests; Pinterest may serve its own cached data.

Completeness of the returned page. Warnings: restricted_records, malformed_records, record_limit, pagination_unavailable and missing_pin_counts (pins whose page publishes no share or reaction counts).

coverage.sourceenum

Always included.

one of: public_resource, public_page

coverage.completeboolean

Always included.

coverage.warningsenum[]

Always included.

Upstream attempts, total decoded response bytes, and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

0 – 3

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

Ordered public pin records. Source nulls and nested attributes are preserved. Maximum 100 records; over-limit or malformed results produce explicit partial coverage.

up to 100 items

pins.idstring

Always included.

pins.descriptionstringnullable

Always included.

pins.imagesobject

Always included.

pins.pinnerobjectnullable

Always included.

cursorstringnullable

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Some records were restricted, malformed or capped, or pagination was unavailable. Inspect coverage.warnings.
400	`invalid_request`	Missing, duplicate, unsupported or invalid parameters or URL.
401	`unauthorized`	Missing or invalid service key.
403	`restricted_page`	Access-gated pin/board or no usable public records.
404	`not_found`	Pinterest explicitly reported a missing resource, or the route is unknown.
429	`upstream_rate_limited`	Pinterest rate limited retrieval.
502	`upstream_challenged`	Pinterest challenged the request.
502	`unsupported_page` `upstream_error`	Incomplete, changed or mismatched source data, or retrieval failure.
502	`response_too_large` `payload_too_complex` `request_limit`	A byte, parsing or request bound was exceeded.
502	`unsafe_redirect`	Upstream redirected; redirects are not followed.
503	`busy`	All worker slots are occupied.
504	`timeout`	The shared deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Fexample%2Frecipes%2F" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Fexample%2Frecipes%2F",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

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

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Fexample%2Frecipes%2F",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Pinterest request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/pinterest/board",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.pinterest.com/example/recipes/"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Fexample%2Frecipes%2F", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Fexample%2Frecipes%2F"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "synthetic-pinterest-request",
  "fetchedAt": "2026-09-10T00:00:00.000Z",
  "coverage": {
    "source": "public_resource",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 2,
    "responseBytes": 1200,
    "durationMs": 120
  },
  "pins": [
    {
      "id": "123456789",
      "type": "pin",
      "title": "Synthetic recipe",
      "description": "",
      "created_at": "Thu, 10 Sep 2026 00:00:00 +0000",
      "images": {
        "orig": {
          "url": "https://i.pinimg.com/synthetic.jpg",
          "width": 800,
          "height": 600
        }
      },
      "pinner": {
        "id": "456",
        "username": "example",
        "follower_count": 0
      },
      "board": {
        "id": "777",
        "url": "/example/recipes/"
      },
      "videos": null,
      "sourceExtension": {
        "unknown": null
      },
      "url": "https://www.pinterest.com/pin/123456789/"
    }
  ],
  "cursor": null,
  "sourceUrl": "https://www.pinterest.com/example/recipes/"
}

Missing, duplicate, unsupported or invalid parameters or URL.

{
  "success": false,
  "status": "failed",
  "requestId": "string",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}