> ## 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. # Board > Get the pins of a Pinterest board 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/pinterest/board 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/board: get: tags: - pinterest summary: Board description: Get the pins of a Pinterest board operationId: pinterest_Board parameters: - name: url in: query description: The URL of the board to get required: true schema: type: string example: https://www.pinterest.com/lizmrodgers/moms-night/ - name: cursor in: query description: The cursor to get the next page of results required: false schema: type: string example: Y2JURlEwTWsxNlp6Vk9SR2MwV.... - 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:** - `pins[n].id`: Pin unique ID - `pins[n].title`: Pin title - `pins[n].description`: Pin description text - `pins[n].link`: External destination URL - `pins[n].domain`: Source domain - `pins[n].images`: Image size variants - `pins[n].pinner.username`: Pinner handle - `pins[n].aggregated_pin_data.aggregated_stats.saves`: Total saves count - `pins[n].board.name`: Parent board name - `cursor`: Pagination cursor for next page content: application/json: examples: full: summary: Full Response value: success: true pins: '0': node_id: UGluOjYzODk0ODg4NDcxNzM5Njk0 call_to_action_text: null story_pin_data_id: null description: ' ' favorite_user_count: 0 debug_info_html: null id: '63894888471739694' link: null has_required_attribution_provider: false should_open_in_stream: false campaign_id: null type: pin insertion_id: null is_eligible_for_related_products: false board: node_id: Qm9hcmQ6NjM4OTQ5NTcxNTI3MTg1MTk= privacy: public url: /lizmrodgers/moms-night/ name: Moms night layout: default followed_by_me: false owner: node_id: VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA== image_medium_url: >- https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg full_name: Liz Rodgers - DIY | Home Decor is_verified_merchant: false is_primary_website_verified: false username: lizmrodgers verified_identity: {} image_small_url: >- https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg id: '63895025871749374' type: board id: '63894957152718519' collaborated_by_me: false is_collaborative: false is_promoted: false seo_alt_text: >- Europe Outfits, Italy Outfits, Mode Inspo, Looks Chic, Outfit Casual, Summer Fashion Outfits, Mode Inspiration, Lookbook Outfits, Spring Summer Outfits product_pin_data: null shopping_flags: {} rich_summary: null done_by_me: true repin_count: 0 aggregated_pin_data: node_id: QWdncmVnYXRlZFBpbkRhdGE6NTM2NzAxNzU3MTA3Nzg5NDI0OA== has_xy_tags: false creator_analytics: null is_shop_the_look: false did_it_data: tags: {} details_count: 0 recommended_count: 0 user_count: 0 recommend_scores: '0': score: 1 count: 0 '1': score: 0.5 count: 0 '2': score: 0 count: 0 images_count: 0 type: aggregateddiditdata videos_count: 0 rating: -1 responses_count: 0 aggregated_stats: saves: 10301 done: 0 id: '5367017571077894248' unified_user_note: null product_metadata: null reaction_counts: '1': 98 is_eligible_for_pre_loved_goods_label: false videos: null is_oos_product: false title: '' is_eligible_for_pdp: false grid_attribution: null utm_link: null video_status: null favorited_by_me: false seo_url: /pin/63894888471739694/ is_stale_product: false domain: Uploaded by user is_native: false story_pin_data: null image_crop: min_y: 0 max_y: 1 category: '' unauth_on_page_description: '' pinner: node_id: VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA== image_medium_url: >- https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg full_name: Liz Rodgers - DIY | Home Decor is_verified_merchant: false is_primary_website_verified: false username: lizmrodgers verified_identity: {} image_small_url: >- https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg id: '63895025871749374' is_quick_promotable: false is_repin: true video_status_message: null grid_title: '' link_domain: null images: 170x: width: 236 height: 419 url: >- https://i.pinimg.com/236x/a4/4f/b7/a44fb7852e2a4dc3347618c1a73c48ac.jpg 136x136: width: 136 height: 136 url: >- https://i.pinimg.com/136x136/a4/4f/b7/a44fb7852e2a4dc3347618c1a73c48ac.jpg 236x: width: 236 height: 419 url: >- https://i.pinimg.com/236x/a4/4f/b7/a44fb7852e2a4dc3347618c1a73c48ac.jpg 474x: width: 474 height: 842 url: >- https://i.pinimg.com/474x/a4/4f/b7/a44fb7852e2a4dc3347618c1a73c48ac.jpg 736x: width: 736 height: 1308 url: >- https://i.pinimg.com/736x/a4/4f/b7/a44fb7852e2a4dc3347618c1a73c48ac.jpg orig: width: 1080 height: 1920 url: >- https://i.pinimg.com/originals/a4/4f/b7/a44fb7852e2a4dc3347618c1a73c48ac.jpg is_downstream_promotion: false native_creator: null auto_alt_text: null alt_text: null link_utm_applicable_and_replaced: 0 promoted_lead_form: null attribution: null promoted_is_lead_ad: false image_signature: a44fb7852e2a4dc3347618c1a73c48ac access: {} sponsorship: null carousel_data: null pin_join: shopping_klp_urls: null visual_annotation: '0': Europe Outfits '1': Italy Outfits '2': Mode Inspo '3': Looks Chic '4': Outfit Casual '5': Summer Fashion Outfits '6': Mode Inspiration '7': Lookbook Outfits '8': Spring Summer Outfits annotations_with_links: Europe Outfits: url: /ideas/europe-outfits/904854149980/ name: Europe Outfits Italy Outfits: url: /ideas/italy-outfits/934427945587/ name: Italy Outfits Mode Inspo: url: /ideas/mode-inspo/921079732344/ name: Mode Inspo Looks Chic: url: /ideas/looks-chic/940735411251/ name: Looks Chic Outfit Casual: url: /ideas/outfit-casual/941493827774/ name: Outfit Casual Summer Fashion Outfits: url: /ideas/summer-fashion-outfits/930305095528/ name: Summer Fashion Outfits Mode Inspiration: url: /ideas/mode-inspiration/959316492353/ name: Mode Inspiration Lookbook Outfits: url: /ideas/lookbook-outfits/931785222895/ name: Lookbook Outfits Spring Summer Outfits: url: /ideas/spring-summer-outfits/953836693773/ name: Spring Summer Outfits canonical_pin: id: '211174978048607' promoter: null embed: null collection_pin: null digital_media_source_type: null dominant_color: '#e8e8e8' creator_analytics: null tracking_params: >- CwABAAAAEDE0NjQ0NTEzMDc4MTAxNTgGAAMAAQsABwAAAApuZ2FwaS9wcm9kAA promoted_is_removable: false is_go_linkless: false cursor: >- Y2JZakk0ZUU1WWQzaE9SRmt3VGtSVmVFMTZRVE5QUkVWM1RWUlZORXRyWkZKVVEzQTRUa2ROTVUxNlFtbE9Na2w1VFZkUk1sa3lXbWhPVjBaclRrUnNhRmxxUVhsT1JFcHRUVWRaZVZsVVp6TlpWRmsxVG1wWmVVNXFTVE5PUjBwc1RWUkdiRTF0VlROUFZFa3pUWHBOTkZwSFJtcE9hbWMxV1c1NFQxSldaRGc9fFVIbzVUMkl5Tld4bVJFVXdUbXBSTUU1VVJYcE5SR00wVFZSQmVFNVVaM0ZTTVVaTlMyNTRiRTFYVW0xYVYxRjZUMVJDYWxwRVZUUmFSRkV5VDFSc2FVMVhVbXhhVkZaclRrZFZORTlIVW10WlYxVTFUa2RTYkZwVVdtdFBSMVYzVDFSbmVGcHFaM2hPUjBrelRrUkNhVmxxU1hsT2VtaHNUVlJXYldaRk5VWldNM2M5fE5vbmV8MTQ2NDQ1MTMwNzgxMDE1OCpHUUwqfGRiYTM2NGJiYjY3MTE0MTAzOTBmOWNjYmRmMjI3NmVjNGIzM2MyZTBiYWVmM2IzMGMzY2IyZWVlODhhM2Q5Mzd8TkVXfA== credits_used: 1 trimmed: summary: Trimmed Response value: success: true pins: '0': id: '63894888471739700' link: https://www.shffls.com/shuffles/5371250648050349525 title: '' board: node_id: Qm9hcmQ6NjM4OTQ5NTcxNTI3MTg1MTk= collaborated_by_me: false owner: node_id: VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA== image_small_url: >- https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg is_verified_merchant: false full_name: Liz Rodgers - DIY | Home Decor username: lizmrodgers is_primary_website_verified: false image_medium_url: >- https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg verified_identity: {} id: '63895025871749374' followed_by_me: false name: Moms night is_collaborative: false type: board url: /lizmrodgers/moms-night/ layout: default privacy: public id: '63894957152718519' unified_user_note: '' alt_text: null rich_summary: null reaction_counts: {} pinner: node_id: VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA== image_small_url: >- https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg is_verified_merchant: false full_name: Liz Rodgers - DIY | Home Decor username: lizmrodgers is_primary_website_verified: false image_medium_url: >- https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg verified_identity: {} id: '63895025871749374' description: Love the bun domain: Uploaded by user cursor: >- Y2JVREpPUkZFeFVUWk5WRlk0VFZSU09FMVVTVFJPZWsxNVRucEJOVTVFUlhkTmFrVjZUWGx3U0ZWVmQzRm1SMFY2V1dwUk5FOUVTVE5hUkVwcVdrZGFhbGw2YUd4YVJGVjZXbTFGZDA1dFdUSmFhazB6VFRKWmQxbFVaM2RQVkZwcVRWUkpNbHBVV1RCTlZFWnNUVEpaZWs0eVZURk5WRnBxV1RKU2JWcEhVVEJPYWs0NFZHdFdXR1pCUFQwPXxVSG81VDJJeU5XeG1SRVY1VDBSamVrMXFZM2RQVkZGNFRVUkplRTE2VFhGU01VWk5TMjU0YkU5SFZUTk9hbGt3VGxkWk1scEhSbXBhYWtVMFQwUmFiVTVIU21wWmVsRTFUMFJGTlU1VVZUUlpiVXByVGxkS2FVMUhUbWxhUjBwc1RXMVdhRmxVV20xT2JWRXpUVzFTYVU5WFdYcE9lazAwV2xkRmQyWkZOVVpXTTNjOXwxMjg3MzI3MDk0MTAyMTMzKkdRTCp8ZDUyNWFhNjFiY2ZkMDlmMGFiZDY5OWVjZDYwYzgwN2I0ZTcyZjQ5NzlkMTdiODZhYzRhMjg5ZjllZGU3ZGFiY3xORVd8 credits_used: 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: Board URL 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). ````