> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User Boards

> Get a user's boards

<Note>
  💳 **1 credit** per request
</Note>


## OpenAPI

````yaml GET /v1/scrape/pinterest/user/boards
openapi: 3.1.0
info:
  title: SociaVault API
  version: 1.0.0
  description: >-
    # SociaVault API Documentation


    The SociaVault API provides comprehensive access to social media data
    extraction across multiple platforms.


    ## Features


    - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
    Reddit, Threads, and more

    - **Credit-Based System**: Pay-as-you-go pricing with transparent credit
    costs

    - **High Performance**: Fast, reliable data extraction

    - **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
    and analytics


    ## Authentication


    All API requests require authentication using an API key in the `X-API-Key`
    header:


    ```bash

    X-API-Key: sk_live_your_api_key_here

    ```


    Get your API key from the [SociaVault
    Dashboard](https://sociavault.com/dashboard).


    ## Credits


    Each endpoint consumes credits based on data complexity:

    - Simple requests (profiles): 1 credit

    - Complex requests (demographics): 20+ credits

    - Paginated requests: Credits per page


    Check your credit balance in the dashboard or via the API.


    ## Support


    - **Documentation**: https://docs.sociavault.com

    - **Email**: support@sociavault.com

    - **Discord**: https://discord.gg/sociavault
  contact:
    name: SociaVault Support
    email: support@sociavault.com
    url: https://sociavault.com/support
  license:
    name: Commercial
    url: https://sociavault.com/terms
servers:
  - url: https://api.sociavault.com
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: account
    description: Account management and credit balance
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/account
  - name: tiktok
    description: Scrape TikTok profiles, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok
  - name: tiktok-shop
    description: Everything about TikTok Shop
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok-shop
  - name: instagram
    description: Gets Instagram profiles, posts, and reels
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/instagram
  - name: youtube
    description: Scrape YouTube channels, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/youtube
  - name: linkedin
    description: Scrape LinkedIn
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedin
  - name: facebook
    description: Get public Facebook profiles and posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebook
  - name: facebookAdLibrary
    description: Scrapes the Facebook (Meta) Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookAdLibrary
  - name: facebookMarketplace
    description: Search Facebook Marketplace and pull full listing details
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookMarketplace
  - name: googleAdLibrary
    description: >-
      Scrape the Google Ad Transparency Library. *This only gets the public ads.
      Some ads you need to log in for and sadly we can't get those. Also, since
      there are so many variations, the return types might not all be 100% the
      same.
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/googleAdLibrary
  - name: linkedinAdLibrary
    description: Search the LinkedIn Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedinAdLibrary
  - name: twitter
    description: Get Twitter profiles, tweets, followers and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/twitter
  - name: reddit
    description: Scrape Reddit posts and comments
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/reddit
  - name: threads
    description: Get Threads posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/threads
  - name: google
    description: Scrape Google search results
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/google
paths:
  /v1/scrape/pinterest/user/boards:
    get:
      tags:
        - pinterest
      summary: User Boards
      description: Get a user's boards
      operationId: pinterest_UserBoards
      parameters:
        - name: handle
          in: query
          description: The username of the user to get boards for
          required: true
          schema:
            type: string
            example: broadstbullycom
        - name: trim
          in: query
          description: Set to true for a trimmed down version of the response
          required: false
          schema:
            type: boolean
            example: false
      responses:
        '200':
          description: |-
            Successful response

            **Key Response Fields:**
            - `boards[n].id`: Board unique ID
            - `boards[n].name`: Board name
            - `boards[n].url`: Full URL to the board
            - `boards[n].description`: Board description text
            - `boards[n].pin_count`: Number of pins on the board
            - `boards[n].follower_count`: Board follower count
            - `boards[n].created_at`: Board creation timestamp
            - `boards[n].owner.username`: Board owner's handle
            - `boards[n].image_cover_hd_url`: Board cover image URL
            - `cursor`: Pagination cursor for next page
          content:
            application/json:
              examples:
                full:
                  summary: Full Response
                  value:
                    success: true
                    boards:
                      '0':
                        node_id: Qm9hcmQ6MjgyODEyMTIwMjg5Mzk4MDEy
                        is_ads_only: false
                        event_start_date: null
                        section_count: 0
                        tracking_params: CwABAAAAEDEzMDI4OTM3NzUxNTc4MTEGAAMAggA
                        description: The best Philadelphia Phillies pins by 🚨 BSB 🚨
                        allow_homefeed_recommendations: true
                        archived_by_me_at: null
                        cover_pin:
                          pin_id: '282812051592265749'
                          image_signature: c4d642a59eec52e4d34368838ab3c909
                          timestamp: 1715137450
                        should_show_board_collaborators: true
                        access: {}
                        id: '282812120289398012'
                        place_saves_count: 0
                        board_vase:
                          '0':
                            link: /ideas/phillies-wallpaper-iphone/912177234139/
                            type: boardvasedata
                            text: phillies wallpaper iphone
                          '1':
                            link: /ideas/phillies-phone-wallpaper/901255802877/
                            type: boardvasedata
                            text: phillies phone wallpaper
                          '2':
                            link: >-
                              /ideas/philadelphia-phillies-iphone-wallpaper/936687422685/
                            type: boardvasedata
                            text: philadelphia phillies iphone wallpaper
                          '3':
                            link: /ideas/phillies-phanatic-wallpaper/899303762115/
                            type: boardvasedata
                            text: phillies phanatic wallpaper
                          '4':
                            link: >-
                              /ideas/philadelphia-phillies-wallpaper/920362553487/
                            type: boardvasedata
                            text: philadelphia phillies wallpaper
                          '5':
                            link: >-
                              /ideas/philadelphia-phillies-wallpaper-iphone/961220842473/
                            type: boardvasedata
                            text: philadelphia phillies wallpaper iphone
                          '6':
                            link: /ideas/phillies-ipad-wallpaper/946280820458/
                            type: boardvasedata
                            text: phillies ipad wallpaper
                          '7':
                            link: /ideas/phillies-fightins-wallpaper/893441198382/
                            type: boardvasedata
                            text: phillies fightins wallpaper
                          '8':
                            link: /ideas/phillies-background/941909873706/
                            type: boardvasedata
                            text: phillies background
                          '9':
                            link: /ideas/phillies-aesthetic/920660416137/
                            type: boardvasedata
                            text: phillies aesthetic
                          '10':
                            link: /ideas/phillies-wallpaper/931429939167/
                            type: boardvasedata
                            text: phillies wallpaper
                          '11':
                            link: /ideas/nick-castellanos-wallpaper/944978360921/
                            type: boardvasedata
                            text: nick castellanos wallpaper
                          '12':
                            link: /ideas/alec-bohm/957502348465/
                            type: boardvasedata
                            text: alec bohm
                          '13':
                            link: /ideas/alec-bohm-wallpaper/936616031600/
                            type: boardvasedata
                            text: alec bohm wallpaper
                          '14':
                            link: /ideas/brandon-marsh-wallpaper/899237423808/
                            type: boardvasedata
                            text: brandon marsh wallpaper
                          '15':
                            link: >-
                              /ideas/philadelphia-phillies-black-background/904196708020/
                            type: boardvasedata
                            text: philadelphia phillies black background
                          '16':
                            link: >-
                              /ideas/trea-turner-wallpaper-phillies/917698006070/
                            type: boardvasedata
                            text: trea turner wallpaper phillies
                          '17':
                            link: /ideas/philadelphia-phillies/909316256374/
                            type: boardvasedata
                            text: philadelphia phillies
                          '18':
                            link: /ideas/baseball-backgrounds/932751462825/
                            type: boardvasedata
                            text: baseball backgrounds
                          '19':
                            link: /ideas/brandon-marsh/921779598982/
                            type: boardvasedata
                            text: brandon marsh
                        collaborator_requests_enabled: false
                        image_cover_url: >-
                          https://i.pinimg.com/200x150/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg
                        images:
                          170x:
                            '0':
                              url: >-
                                https://i.pinimg.com/170x/9e/75/d6/9e75d6b4c3102d949518ca0e5f2fd449.jpg
                              width: 170
                              height: 301
                              dominant_color: '#D1B3AE'
                            '1':
                              url: >-
                                https://i.pinimg.com/170x/80/24/01/802401954745db8eb3d583e46aa1f04a.jpg
                              width: 170
                              height: 302
                              dominant_color: '#07402B'
                            '2':
                              url: >-
                                https://i.pinimg.com/170x/8c/5f/4a/8c5f4a982ef1393d5bbad78d29a89339.jpg
                              width: 170
                              height: 302
                              dominant_color: '#33525C'
                            '3':
                              url: >-
                                https://i.pinimg.com/170x/26/27/b0/2627b0d0d3fa122afad0225938ca7ad3.jpg
                              width: 170
                              height: 302
                              dominant_color: '#383132'
                            '4':
                              url: >-
                                https://i.pinimg.com/170x/63/69/2a/63692a5882ad5fa50fbe2df7e04f5fff.jpg
                              width: 170
                              height: 302
                              dominant_color: '#637183'
                            '5':
                              url: >-
                                https://i.pinimg.com/170x/2e/4f/f7/2e4ff7766b3dcbb1db261f83a789efa8.jpg
                              width: 170
                              height: 301
                              dominant_color: '#2A171B'
                            '6':
                              url: >-
                                https://i.pinimg.com/170x/90/f0/b4/90f0b46203344585334e11590a9399f0.jpg
                              width: 170
                              height: 302
                              dominant_color: '#202828'
                            '7':
                              url: >-
                                https://i.pinimg.com/170x/92/39/a7/9239a795bf397b6ebe13979149fbe8d1.jpg
                              width: 170
                              height: 301
                              dominant_color: '#705370'
                            '8':
                              url: >-
                                https://i.pinimg.com/170x/60/ec/74/60ec742ffeec1e5922677352dabee926.jpg
                              width: 170
                              height: 301
                              dominant_color: '#8F7F86'
                            '9':
                              url: >-
                                https://i.pinimg.com/170x/24/86/39/248639a18acf6d6a2e0d3902d4022317.jpg
                              width: 170
                              height: 302
                              dominant_color: '#322830'
                            '10':
                              url: >-
                                https://i.pinimg.com/170x/e5/f0/28/e5f0285608879502fac2eaf70a9b202c.jpg
                              width: 170
                              height: 302
                              dominant_color: '#3C444D'
                            '11':
                              url: >-
                                https://i.pinimg.com/170x/b6/e8/c1/b6e8c1bb404642569a50105d0f5b9b3e.jpg
                              width: 170
                              height: 302
                              dominant_color: '#856A7F'
                            '12':
                              url: >-
                                https://i.pinimg.com/170x/e6/43/c3/e643c3059270b60620d454758d9fbfeb.jpg
                              width: 170
                              height: 301
                              dominant_color: '#8B7976'
                            '13':
                              url: >-
                                https://i.pinimg.com/170x/35/06/90/3506905d8e6b3ddb3d2a683b19ed1ada.jpg
                              width: 170
                              height: 301
                              dominant_color: '#A66160'
                            '14':
                              url: >-
                                https://i.pinimg.com/170x/af/91/cb/af91cbe78744939c89cc809c90ad41a6.jpg
                              width: 170
                              height: 302
                              dominant_color: '#6E6A66'
                          236x:
                            '0':
                              url: >-
                                https://i.pinimg.com/236x/9e/75/d6/9e75d6b4c3102d949518ca0e5f2fd449.jpg
                              width: 236
                              height: 418
                              dominant_color: '#D1B3AE'
                            '1':
                              url: >-
                                https://i.pinimg.com/236x/80/24/01/802401954745db8eb3d583e46aa1f04a.jpg
                              width: 236
                              height: 419
                              dominant_color: '#07402B'
                            '2':
                              url: >-
                                https://i.pinimg.com/236x/8c/5f/4a/8c5f4a982ef1393d5bbad78d29a89339.jpg
                              width: 236
                              height: 419
                              dominant_color: '#33525C'
                            '3':
                              url: >-
                                https://i.pinimg.com/236x/26/27/b0/2627b0d0d3fa122afad0225938ca7ad3.jpg
                              width: 236
                              height: 419
                              dominant_color: '#383132'
                            '4':
                              url: >-
                                https://i.pinimg.com/236x/63/69/2a/63692a5882ad5fa50fbe2df7e04f5fff.jpg
                              width: 236
                              height: 419
                              dominant_color: '#637183'
                            '5':
                              url: >-
                                https://i.pinimg.com/236x/2e/4f/f7/2e4ff7766b3dcbb1db261f83a789efa8.jpg
                              width: 236
                              height: 419
                              dominant_color: '#2A171B'
                            '6':
                              url: >-
                                https://i.pinimg.com/236x/90/f0/b4/90f0b46203344585334e11590a9399f0.jpg
                              width: 236
                              height: 419
                              dominant_color: '#202828'
                            '7':
                              url: >-
                                https://i.pinimg.com/236x/92/39/a7/9239a795bf397b6ebe13979149fbe8d1.jpg
                              width: 236
                              height: 418
                              dominant_color: '#705370'
                            '8':
                              url: >-
                                https://i.pinimg.com/236x/60/ec/74/60ec742ffeec1e5922677352dabee926.jpg
                              width: 236
                              height: 419
                              dominant_color: '#8F7F86'
                            '9':
                              url: >-
                                https://i.pinimg.com/236x/24/86/39/248639a18acf6d6a2e0d3902d4022317.jpg
                              width: 236
                              height: 419
                              dominant_color: '#322830'
                            '10':
                              url: >-
                                https://i.pinimg.com/236x/e5/f0/28/e5f0285608879502fac2eaf70a9b202c.jpg
                              width: 236
                              height: 419
                              dominant_color: '#3C444D'
                            '11':
                              url: >-
                                https://i.pinimg.com/236x/b6/e8/c1/b6e8c1bb404642569a50105d0f5b9b3e.jpg
                              width: 236
                              height: 419
                              dominant_color: '#856A7F'
                            '12':
                              url: >-
                                https://i.pinimg.com/236x/e6/43/c3/e643c3059270b60620d454758d9fbfeb.jpg
                              width: 236
                              height: 418
                              dominant_color: '#8B7976'
                            '13':
                              url: >-
                                https://i.pinimg.com/236x/35/06/90/3506905d8e6b3ddb3d2a683b19ed1ada.jpg
                              width: 236
                              height: 419
                              dominant_color: '#A66160'
                            '14':
                              url: >-
                                https://i.pinimg.com/236x/af/91/cb/af91cbe78744939c89cc809c90ad41a6.jpg
                              width: 236
                              height: 419
                              dominant_color: '#6E6A66'
                        url: >-
                          https://www.pinterest.com/broadstbullycom/philadelphia-phillies/
                        collaborated_by_me: false
                        is_collaborative: false
                        cover_images:
                          200x150:
                            url: >-
                              https://i.pinimg.com/200x150/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg
                            width: 200
                            height: 150
                          222x:
                            url: >-
                              https://i.pinimg.com/222x/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg
                            width: 222
                            height: null
                        has_custom_cover: false
                        event_date: null
                        owner:
                          node_id: VXNlcjoyODI4MTIxODkwMDg0NzU1NDk=
                          image_medium_url: >-
                            https://i.pinimg.com/75x75_RS/1c/82/f7/1c82f745249221256c71b8c04decb2c7.jpg
                          is_partner: true
                          is_ads_only_profile: false
                          username: BroadStBullycom
                          is_default_image: false
                          full_name: 🚨BSB🚨
                          domain_verified: true
                          is_private_profile: false
                          ads_only_profile_site: null
                          id: '282812189008475549'
                          is_verified_merchant: false
                          verified_identity: {}
                          explicitly_followed_by_me: false
                          follower_count: 2025
                          type: user
                        name: Philadelphia Phillies ❤️🤍
                        followed_by_me: false
                        privacy: public
                        image_cover_hd_url: >-
                          https://i.pinimg.com/474x/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg
                        should_show_shop_feed: false
                        should_show_more_ideas: false
                        board_order_modified_at: Fri, 12 Sep 2025 15:35:09 +0000
                        viewer_collaborator_join_requested: false
                        collaborating_users: {}
                        collaborator_count: 0
                        pin_count: 388
                        created_at: Thu, 20 Oct 2022 15:51:00 +0000
                        follower_count: 2008
                        type: board
                    cursor: >-
                      LT4yODI4MTIxMjAyODk0MjI4MzN8MTB8MTMwMjg5Mzc3NTE1NzgxMSpHUUwqfGRiNjU0ZmNkMzcyNGU1YWYwMWU2NTNkMjVjNjA4ZDhiZjBjODQwZDU0NDNhMTliYmYxNzNmNDcwZTRjZGRjNjB8TkVXfA==
                    creditsUsed: 1
                trimmed:
                  summary: Trimmed Response
                  value:
                    success: true
                    boards:
                      '0':
                        id: '282812120289398012'
                        url: >-
                          https://www.pinterest.com/broadstbullycom/philadelphia-phillies/
                        description: The best Philadelphia Phillies pins by 🚨 BSB 🚨
                        follower_count: 2008
                        pin_count: 388
                        name: Philadelphia Phillies ❤️🤍
                        image_cover_hd_url: >-
                          https://i.pinimg.com/474x/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg
                        created_at: Thu, 20 Oct 2022 15:51:00 +0000
                    cursor: >-
                      LT4yODI4MTIxMjAyODk0MjI4MzN8MTB8NTI4MDA2OTU4MTI0ODI0MCpHUUwqfDgzNDhmMWJhMmZlNWViZjY2MzNiM2YwNGFlMzM2MjJlYmZlOGQ4M2ZjNzAxNTdjMTdkM2U2ZmI1NmNiY2Q2MGJ8TkVXfA==
                    creditsUsed: 1
        '400':
          description: Bad Request - Missing or invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: User handle is required
        '401':
          description: Unauthorized - Invalid or missing API key
        '402':
          description: Payment Required - Insufficient credits
        '500':
          description: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`

        Get your API key from the [Dashboard](https://sociavault.com/dashboard).

````