Pinterest API: プロフィール — ユーザー名によるボード

Q: この Pinterest API メソッドはどのようなデータを返しますか？

このメソッドは プロフィール に対して「ユーザー名によるボード」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

このエンドポイントの機能

この API メソッドで構築できるもの

まず結果と一般的なワークフローを確認し、次にパラメーターと動作するリクエスト例に進んでください。

このエンドポイントが役立つこと

レスポンスは、利用可能なプロフィールのフィールドを、正規化された V2 形式またはプラットフォーム固有の V1 形式で提供します。

使用に適した場面

オブジェクトが既にわかっていて、製品でその現在の公開コンテキストが必要な場合に「ユーザー名によるボード」を使用します。

主なユースケース

レコードのエンリッチメント

製品の既知のオブジェクトを Pinterest の公開フィールドで補完します。

データの検証

後続の処理の前に、識別子と現在の公開コンテキストを確認します。

分析の準備

オブジェクトの詳細をレポート、評価、関連リクエストの入力として使用します。

利用できるバージョン

レスポンスのバージョン

どちらのバージョンも同じタスクを解決し、同じパラメーターを受け付けます。切り替えを使ってレスポンス構造を比較し、クライアントが想定するバージョンを選んでください。

レスポンスのバージョン V2

このページでバージョンを切り替えると、同じドキュメント URL でレスポンス構造を比較できます。

共通する点

認証、必須パラメーター、リクエストの形は V1 と V2 で同じです。実際には、エンドポイントのパスを組み立てるときとレスポンスを読み取るときにバージョンを選びます。

バージョン間で異なる点

主な違いはレスポンスのエンベロープです。新しい連携では V2 を使用し、既存のクライアント契約との互換性が必要な場合にのみ V1 を残してください。

使い方

メソッドの呼び出し方

どちらのバージョンでも、同じ API キーのヘッダーと同じクエリパラメーターを使用します。このドキュメントでは、まず共通のパラメーターを示し、次に各バージョンのパスとコードスニペットを示します。

入力パラメーター

共通パラメーター

パラメーター	必須	型	例	説明
`username`	はい	`str`	`pinterest`	@ を付けない公開ユーザー名。
`cursor`	いいえ	`str \| None`	`cursor-next-page`	前のレスポンスで返された次のページのカーソル。最初のページでは省略します。
`sort`	いいえ	`last_pinned_to \| alphabetical \| created_at`	`last_pinned_to`	Pinterest board sort order. Example: last_pinned_to.

バージョン別のリクエストパス

V2

エンドポイントの正確なパス、URL の例、コードスニペットをコピーするときにバージョンを選んでください。上のパラメーター一覧は変わりません。

GET /api/v2/pinterest.com/profile/boards-by-username

正規化された形式

リクエストのプレビュー

ベース URL https://www.scrapestorm.net

エンドポイント /api/v2/pinterest.com/profile/boards-by-username

必須パラメーター

username

任意のパラメーター

cursor sort

URL の例

https://www.scrapestorm.net/api/v2/pinterest.com/profile/boards-by-username?username=pinterest

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/pinterest.com/profile/boards-by-username" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'username=pinterest' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'
  # --data-urlencode 'sort=last_pinned_to'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/pinterest.com/profile/boards-by-username"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "username": "pinterest",
}

# Optional parameters
# params["cursor"] = "cursor-next-page"
# params["sort"] = "last_pinned_to"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/pinterest.com/profile/boards-by-username";

const params = new URLSearchParams({
  username: "pinterest",
});

// Optional parameters
// params.set("cursor", "cursor-next-page");
// params.set("sort", "last_pinned_to");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

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

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  username: "pinterest",
};

// Optional parameters
// params.cursor = "cursor-next-page";
// params.sort = "last_pinned_to";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "username" => "pinterest",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";
// $query["sort"] = "last_pinned_to";

try {
    $response = $client->request("GET", "/api/v2/pinterest.com/profile/boards-by-username", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

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

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/pinterest.com/profile/boards-by-username"

    params := url.Values{}
    params.Set("username", "pinterest")

    // Optional parameters
    // params.Set("sort", "last_pinned_to")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

バージョン別のリクエストパス

V1

エンドポイントの正確なパス、URL の例、コードスニペットをコピーするときにバージョンを選んでください。上のパラメーター一覧は変わりません。

GET /api/v1/pinterest.com/profile/boards-by-username

プラットフォーム固有の形式

リクエストのプレビュー

ベース URL https://www.scrapestorm.net

エンドポイント /api/v1/pinterest.com/profile/boards-by-username

必須パラメーター

username

任意のパラメーター

cursor sort

URL の例

https://www.scrapestorm.net/api/v1/pinterest.com/profile/boards-by-username?username=pinterest

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/pinterest.com/profile/boards-by-username" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'username=pinterest' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'
  # --data-urlencode 'sort=last_pinned_to'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/pinterest.com/profile/boards-by-username"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "username": "pinterest",
}

# Optional parameters
# params["cursor"] = "cursor-next-page"
# params["sort"] = "last_pinned_to"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/pinterest.com/profile/boards-by-username";

const params = new URLSearchParams({
  username: "pinterest",
});

// Optional parameters
// params.set("cursor", "cursor-next-page");
// params.set("sort", "last_pinned_to");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

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

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  username: "pinterest",
};

// Optional parameters
// params.cursor = "cursor-next-page";
// params.sort = "last_pinned_to";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "username" => "pinterest",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";
// $query["sort"] = "last_pinned_to";

try {
    $response = $client->request("GET", "/api/v1/pinterest.com/profile/boards-by-username", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

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

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v1/pinterest.com/profile/boards-by-username"

    params := url.Values{}
    params.Set("username", "pinterest")

    // Optional parameters
    // params.Set("sort", "last_pinned_to")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

レスポンス例

バージョン別のライブレスポンス

プレビューには主要なフィールドとコレクションの最初の要素が含まれているため、レスポンスの形をすばやく確認できます。バージョンを切り替えると JSON の形式が変わります。

レスポンス例

V2 レスポンスの JSON

検証済みの例

このコンパクトな JSON の例は、V2 の直近の成功した検証実行から取得したものです。

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "username": "pinterest",
    "sort": "last_pinned_to"
  },
  "data": {
    "boards": {
      "count": 10,
      "items": [
        {
          "url": "https://www.pinterest.com/pinterest/ideas-for-your-summer-escape/",
          "board_id": "424605139808113418",
          "name": "Ideas for your summer escape",
          "description": "From beach days to weekend adventures, all the inspiration you need to pack your bags.",
          "emails": [],
          "pin_count": 101,
          "follower_count": 4221682,
          "collaborator_count": 0,
          "section_count": 0,
          "privacy": "public",
          "is_collaborative": false,
          "created_at": "2026-05-27T20:58:30+00:00",
          "modified_at": "2026-07-01T17:43:57+00:00",
          "owner": {
            "url": "https://www.pinterest.com/pinterest/",
            "user_id": "424605208526455283",
            "username": "pinterest",
            "display_name": "Pinterest",
            "follower_count": 6257620,
            "verified": true,
            "is_private": false,
            "avatar_url": "https://example.com/image.jpg"
          },
          "thumbnail_url": "https://example.com/image.jpg"
        },
        {
          "url": "https://www.pinterest.com/pinterest/spice-up-your-dinner-plans/",
          "board_id": "424605139808113480",
          "name": "Spice up your dinner plans",
          "description": "Easy date night dinners that bring the romance, the fun, and really good food.",
          "emails": [],
          "pin_count": 74,
          "follower_count": 4221665,
          "collaborator_count": 0,
          "section_count": 0,
          "privacy": "public",
          "is_collaborative": false,
          "created_at": "2026-05-28T05:37:21+00:00",
          "modified_at": "2026-07-01T17:45:15+00:00",
          "owner": {
            "url": "https://www.pinterest.com/pinterest/",
            "user_id": "424605208526455283",
            "username": "pinterest",
            "display_name": "Pinterest",
            "follower_count": 6257620,
            "verified": true,
            "is_private": false,
            "avatar_url": "https://example.com/image.jpg"
          },
          "thumbnail_url": "https://example.com/image.jpg"
        },
        {
          "_more_items": 8
        }
      ]
    }
  }
}

レスポンス例

V1 レスポンスの JSON

検証済みの例

このコンパクトな JSON の例は、V1 の直近の成功した検証実行から取得したものです。

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "sort": "last_pinned_to",
    "username": "pinterest"
  },
  "data": {
    "resource_response": {
      "status": "success",
      "code": 0,
      "message": "ok",
      "endpoint_name": "v3_user_profile_boards_feed",
      "data": [
        {
          "node_id": "Qm9hcmQ6NDI0NjA1MTM5ODA4MTEzNDE4",
          "collaborated_by_me": false,
          "allow_homefeed_recommendations": true,
          "created_at": "Wed, 27 May 2026 20:58:30 +0000",
          "image_cover_url": "https://i.pinimg.com/200x150/a3/74/b8/a374b87d444a26ce170dcda5751b70fd.jpg",
          "type": "board",
          "has_custom_cover": false,
          "is_collaborative": false,
          "description": "From beach days to weekend adventures, all the inspiration you need to pack your bags.",
          "section_count": 0,
          "collaborator_requests_enabled": false,
          "is_ads_only": false,
          "pin_count": 101,
          "should_show_shop_feed": false,
          "board_order_modified_at": "Wed, 01 Jul 2026 17:43:57 +0000",
          "cover_images": {
            "200x150": {
              "url": "https://i.pinimg.com/200x150/a3/74/b8/a374b87d444a26ce170dcda5751b70fd.jpg",
              "width": 200,
              "height": 150
            },
            "236x": {
              "url": "https://i.pinimg.com/236x/a3/74/b8/a374b87d444a26ce170dcda5751b70fd.jpg",
              "width": 236,
              "height": null
            }
          },
          "archived_by_me_at": null,
          "url": "/pinterest/ideas-for-your-summer-escape/",
          "place_saves_count": 0,
          "should_show_board_collaborators": true,
          "follower_count": 4221682,
          "image_cover_hd_url": "https://i.pinimg.com/474x/a3/74/b8/a374b87d444a26ce170dcda5751b70fd.jpg",
          "name": "Ideas for your summer escape",
          "followed_by_me": false,
          "_more_fields": "14 more fields"
        },
        {
          "node_id": "Qm9hcmQ6NDI0NjA1MTM5ODA4MTEzNDgw",
          "collaborated_by_me": false,
          "allow_homefeed_recommendations": true,
          "created_at": "Thu, 28 May 2026 05:37:21 +0000",
          "image_cover_url": "https://i.pinimg.com/custom_covers/200x150/424605139808113480_1782230932.jpg",
          "type": "board",
          "has_custom_cover": true,
          "is_collaborative": false,
          "description": "Easy date night dinners that bring the romance, the fun, and really good food.",
          "section_count": 0,
          "collaborator_requests_enabled": false,
          "is_ads_only": false,
          "pin_count": 74,
          "should_show_shop_feed": false,
          "board_order_modified_at": "Wed, 01 Jul 2026 17:45:15 +0000",
          "cover_images": {
            "200x150": {
              "url": "https://i.pinimg.com/custom_covers/200x150/424605139808113480_1782230932.jpg",
              "width": 200,
              "height": 150
            },
            "236x": {
              "url": "https://i.pinimg.com/custom_covers/236x/424605139808113480_1782230932.jpg",
              "width": 236,
              "height": null
            }
          },
          "archived_by_me_at": null,
          "url": "/pinterest/spice-up-your-dinner-plans/",
          "place_saves_count": 0,
          "should_show_board_collaborators": true,
          "follower_count": 4221665,
          "image_cover_hd_url": "https://i.pinimg.com/474x/82/80/07/828007fd8e01116811f1e15539c95d63.jpg",
          "name": "Spice up your dinner plans",
          "followed_by_me": false,
          "_more_fields": "14 more fields"
        },
        {
          "_more_items": 8
        }
      ],
      "bookmark": "LT4xMDEzMzgwNDIyMzQzNDUwMDc5fDEwfDQzNDk5NTAyOTczNTYwOTEqR1FMKnw1ODMyMTcxM2M2OWM5MDk4Zjg4MWVlN2YzYjViZWIyZmQxZGY3NTVlZTZmNTEyOThjNTE3YzNkNWY0OGE5YWFkfE5FV3w=",
      "x_pinterest_sli_endpoint_name": "v3_user_profile_boards_feed",
      "http_status": 200
    },
    "client_context": {
      "analysis_ua": {
        "app_type": 5,
        "app_version": "",
        "browser_name": "Chrome",
        "browser_version": "145.0.0",
        "device_type": null,
        "device": "Other",
        "os_name": "Windows 10",
        "os_version": "10"
      },
      "app_type_detailed": 5,
      "app_version": "e86b6e0",
      "autologin": null,
      "browser_locale": "en-US",
      "browser_name": "Chrome",
      "browser_type": 1,
      "browser_version": "145.0.0",
      "country": "US",
      "country_from_hostname": "US",
      "country_from_ip": "US",
      "csp_nonce": "8ef7aa0890d5b376a141c8d46a120abc",
      "current_url": "https://www.pinterest.com/resource/BoardsFeedResource/get/?source_url=/pinterest/&data=%7B%22options%22:%7B%22field_set_key%22:%22profile_grid_item%22,%22filter_stories%22:false…",
      "debug": false,
      "deep_link": "",
      "enabled_advertiser_countries": [
        "AR",
        "AT",
        {
          "_more_items": 24
        }
      ],
      "facebook_token": null,
      "full_path": "/resource/BoardsFeedResource/get/?source_url=/pinterest/&data=%7B%22options%22:%7B%22field_set_key%22:%22profile_grid_item%22,%22filter_stories%22:false,%22sort%22:%22last_pinne…",
      "http_referrer": "https://www.pinterest.com/",
      "impersonator_user_id": null,
      "invite_code": "",
      "invite_sender_id": "",
      "is_authenticated": false,
      "is_bot": "false",
      "_more_fields": "33 more fields"
    },
    "resource": {
      "name": "BoardsFeedResource",
      "options": {
        "bookmarks": [
          "LT4xMDEzMzgwNDIyMzQzNDUwMDc5fDEwfDQzNDk5NTAyOTczNTYwOTEqR1FMKnw1ODMyMTcxM2M2OWM5MDk4Zjg4MWVlN2YzYjViZWIyZmQxZGY3NTVlZTZmNTEyOThjNTE3YzNkNWY0OGE5YWFkfE5FV3w="
        ],
        "field_set_key": "profile_grid_item",
        "filter_stories": false,
        "sort": "last_pinned_to",
        "username": "pinterest"
      }
    },
    "request_identifier": "4349950297356091"
  }
}

プロフィールで作業を続ける

関連するメソッドでは、同じオブジェクトを別の識別子で解決したり、詳細を開いたり、集計ビューに切り替えたりできます。

次のステップ

評価を続ける

このドキュメントを最初の判断材料とし、継続的な利用のためにエンドポイントを接続する前に、料金、プラットフォームのカバー範囲、連携ルールを確認してください。

Pinterest のプラットフォームページを開く

実装の前に、関連するエンティティ、API メソッドのグループ、関連ドキュメントを比較してください。

プラットフォームページを開く

API メソッドの料金を比較する

利用を拡大する前に、公開料金表でこのメソッドの位置付けを確認してください。

料金を見る

連携ルールを確認する

入門ドキュメントで、認証、バージョン、再試行、テストと本番の違いを確認してください。

ドキュメントを開く

よくある質問

チームが実装前に尋ねる質問

これらの回答を参考に、この API メソッドがワークフロー、バージョンの選択、導入計画に合うかどうかを判断してください。

この Pinterest API メソッドはどのようなデータを返しますか？

このメソッドはプロフィールに対して「ユーザー名によるボード」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

V1 と V2 のどちらを選ぶべきですか？

新しい連携では、正規化された構造を提供する V2 を選んでください。V1 は、既にプラットフォーム固有の形式を処理しているクライアントとの互換性のためにのみ使用してください。

最初のリクエストには何が必要ですか？

API キーを作成し、リクエストヘッダーで送信し、表の必須パラメーターを指定してください。コード例には、正しいパスとリクエスト構造が既に含まれています。

Pinterest API: プロフィール — ユーザー名によるボード

この API メソッドで構築できるもの

このエンドポイントが役立つこと

使用に適した場面

主なユースケース

レコードのエンリッチメント

データの検証

分析の準備

レスポンスのバージョン

共通する点

バージョン間で異なる点

メソッドの呼び出し方

入力パラメーター

バージョン別のリクエストパス

コード例

バージョン別のリクエストパス

コード例

バージョン別のライブレスポンス

V2 レスポンスの JSON

V1 レスポンスの JSON

プロフィール で作業を続ける

プロフィール: ユーザー名によるボードの指標

評価を続ける

Pinterest のプラットフォームページを開く

API メソッドの料金を比較する

連携ルールを確認する

チームが実装前に尋ねる質問

プロフィールで作業を続ける