> ## 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. # Search > Search Pinterest for pins 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/pinterest/search 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/search: get: tags: - pinterest summary: Search description: Search Pinterest for pins operationId: pinterest_Search parameters: - name: query in: query description: Search query required: true schema: type: string example: Italian Pot Roast - name: cursor in: query description: Cursor for pagination required: false schema: type: string example: Y2JVSG81V2sxcmNHRlpWM1J... - 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].url`: Full URL to the pin - `pins[n].title`: Pin title - `pins[n].description`: Pin description text - `pins[n].images`: Image size variants (170x, 236x, 474x, 736x, orig) - `pins[n].pinner.username`: Pinner's username - `pins[n].board.name`: Board the pin belongs to - `pins[n].created_at`: Creation timestamp - `cursor`: Pagination cursor for the next page of results content: application/json: examples: full: summary: Full Response value: success: true pins: '0': node_id: UGluOjUzNjM1MDYzNjg5Njk4MzA4Mw== url: https://www.pinterest.com/pin/536350636896983083 auto_alt_text: >- two pictures with the words italian pot roast and potatoes id: '536350636896983083' is_promoted: false description: >- Cozy nights call for something special, and nothing beats a hearty **Italian Pot Roast (Stracotto)**. Imagine tender, melt-in-your-mouth beef simmered to perfection in aromatic herbs and rich red wine, bringing warmth to your dinner table. This dish not only fills your home with irresistible aromas but also creates a comforting meal that everyone will love. Plus, it’s surprisingly easy to make! Ready to impress your friends and family? Don’t wait—discover how to create this mouthwatering Italian classic today! title: How to Make Italian Pot Roast (Stracotto) Like a Pro images: 170x: width: 236 height: 466 url: >- https://i.pinimg.com/236x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg 236x: width: 236 height: 466 url: >- https://i.pinimg.com/236x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg 474x: width: 474 height: 936 url: >- https://i.pinimg.com/474x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg 736x: width: 736 height: 1454 url: >- https://i.pinimg.com/736x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg orig: width: 1024 height: 2024 url: >- https://i.pinimg.com/originals/91/61/df/9161df84f61b82efef873750a3b7332d.jpg link: https://zealrecipes.com/italian-pot-roast/ domain: zealrecipes.com seo_alt_text: >- two pictures with the words italian pot roast and potatoes board: node_id: Qm9hcmQ6NTM2MzUwNzA1NTYyMjM3ODk3 image_cover_hd_url: >- https://i.pinimg.com/474x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg pin_count: 1 board_order_modified_at: Sun, 01 Feb 2026 10:09:19 +0000 collaborating_users: {} collaborator_count: 0 cover_images: 222x: url: >- https://i.pinimg.com/222x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg width: 222 owner: node_id: VXNlcjo1MzYzNTA3NzQyODA1OTE5NTQ= image_large_url: >- https://i.pinimg.com/140x140_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg image_small_url: >- https://i.pinimg.com/30x30_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg verified_identity: {} full_name: Brenda Famalaro username: brendafamalaro id: '536350774280591954' follower_count: 13 is_verified_merchant: false image_medium_url: >- https://i.pinimg.com/75x75_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg is_ads_only_profile: false id: '536350705562237897' images: 170x: '0': url: >- https://i.pinimg.com/170x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg width: 170 height: 336 dominant_color: '#6A3E1C' section_count: 0 is_collaborative: false name: Italian pot roast url: /brendafamalaro/italian-pot-roast/ type: board image_cover_url: >- https://i.pinimg.com/200x150/91/61/df/9161df84f61b82efef873750a3b7332d.jpg grid_title: How to Make Italian Pot Roast (Stracotto) Like a Pro created_at: Sun, 01 Feb 2026 10:09:17 +0000 pinner: node_id: VXNlcjo1MzYzNTA3NzQyODA1OTE5NTQ= image_large_url: >- https://i.pinimg.com/140x140_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg image_small_url: >- https://i.pinimg.com/30x30_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg verified_identity: {} full_name: Brenda Famalaro username: brendafamalaro id: '536350774280591954' follower_count: 13 is_verified_merchant: false image_medium_url: >- https://i.pinimg.com/75x75_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg is_ads_only_profile: false story_pin_data: node_id: U3RvcnlQaW5EYXRhOjMxODI3MzQyMjgyOTY0ODcxMDQ= metadata: canvas_aspect_ratio: 0.5059288537549407 pin_image_signature: 9161df84f61b82efef873750a3b7332d is_compatible: false compatible_version: 0.16.0 version: 0.16.0 root_pin_id: '986640230879922937' is_editable: false is_promotable: true pin_title: >- How to Make Italian Pot Roast (Stracotto) Like a Pro root_user_id: '986640368273787579' has_product_pins: false pages: '0': layout: 0 type: storypinpage should_mute: false image_signature_adjusted: 9161df84f61b82efef873750a3b7332d style: background_color: '#462815' id: '2267760908' blocks: '0': block_type: 2 block_style: x_coord: 0 corner_radius: 0 width: 100 rotation: 0 y_coord: 0 height: 100 image_signature: 9161df84f61b82efef873750a3b7332d tracking_id: '5476149075269194107' text: '' type: story_pin_image_block image_signature: 9161df84f61b82efef873750a3b7332d music_attributions: {} total_video_duration: 0 id: '3182734228296487104' static_page_count: 1 pages_preview: '0': layout: 0 type: storypinpage should_mute: false image_signature_adjusted: 9161df84f61b82efef873750a3b7332d style: background_color: '#462815' id: '2267760908' blocks: '0': block_type: 2 block_style: x_coord: 0 corner_radius: 0 width: 100 rotation: 0 y_coord: 0 height: 100 image_signature: 9161df84f61b82efef873750a3b7332d tracking_id: '5476149075269194107' text: '' type: story_pin_image_block image_signature: 9161df84f61b82efef873750a3b7332d music_attributions: {} has_affiliate_products: false page_count: 1 type: storypindata cursor: >- Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWlVWbFJXTVVZMldWVlZNV0pIU2taWFdIQlhVbXhhVkZZeWN6RldhelZYVm14d1RrMXNTbEZXVjNSWFl6QTFjMVZZYUZaaGVsWlFWbXhvVTJWV1pISlhhM1JYVm10V05sVldVbE5YUmxwMFZXdG9XbFl6YUhsYVZscFBWMVp3Ums5WGFHaE5TRUl6Vm1wR1lWVXhUbkpOVm1ScFUwVmFhRnBYZUV0VU1WWnlWbXRhVGxKc1NucFdWM2hoWWtaYVZXSkdXbGRTZWtZelZrY3hTMVl4WkhWU2JHaFlVMFZLVVZkWGVGWk5WMUpIVTJ4V1ZXSkZTbFJVVldRelpXeFplV1ZHVG1saGVsWllXVEJhYjFZeFdrWlRiRUpXWVRKU2NWUldXbEprTVZaMVUyczFhR1ZyVlhsV2JUQjRUVVpXUjFOcldsZFhSMUpXVkZaYVMyVldVbFpXVkZaWFZtNUNTVmxWVlRWVWJVWTJVVmhvVjAxWFRYaFVhMXBTWlVaT2MxcEhSbE5TTWswMVdtdGFWMU5YU2paVmJYaFRWMGRvUmxkc1ZsZGhNV1J6VjFod2FGSkdjRmxaYTJSdVpXeHdWbFpZYUU5aVJscGFWMnRWTVZVeFNuUmpNMmhYVWpOb1ZGbFhNVkprTURWV1ZteFNXRk5GU2xKV2JYUldaREF4VjFSWWJHdFNNMUpYV1d0YVMxSldhM2RWYlRsVlRXdGFlVlZzYUc5V1YwcElWV3hrVldKR1ZqUlZiRnBUVjFkT1JrOVdUazVXYkd0M1ZtcEdZV0V4V1hsVGEyUnBVMFZhYUZWdWNFZFZWbHB4VVc1S1RsSnNTbnBXVnpBeFlrWmFWV0pHYkZkV2JXZ3pWMVphV21Rd05WaFBWbFpYVm10d1NGZHNXbFpsUms1SFZtNVNUbFp1UWxoVmFrNVBUbXhhU0U1WVpGTk5hM0JYVkRGV1YxWlhTbGxWYkVKWFlURmFlVlJXV2xOV2JIQkdUMWRzVTJKWWFGZFdWbHB2WVRGa2RGWnVUbFJpVkd4V1dXeFNSMVV4Y0ZobFNFNVhWbTFTV2xkclZURmhWMHAwWVVaR1YxWXphR2haVkVFMVVXeENWVTFVYUU1V1JUQjNWRlZTUWsxck9WVldWRTVPVWtaR05WUlljSEpsYXpsVVkwVm9WbFpZWkhoYWEyUkdaVlp3VlZGWWNHRmlWVFZ2VkZaU1QyRldjRlZaTTNCaFlXdHdjVlJWVW01a01ERTJWMjE0WVZJd1ZqWlViVEZPVGxVMU5sb3piRkJXTVd0NlZEQlNiMkV3TVhGV1ZGWlBWa2ROZDFSWGNFSmtNRFZJVlcxMFRsWXdWak5VVmxKQ1pXc3hXRkp0Y0U1bGExVjNWRzF3UjA5R1VuSldiR2h0VVZRd09XWkVSWHBPUkVGM1RtcHJNVTU2UVRCTmFrMDFUWHByY1ZJeFJrMUxibmhxVFVkS2FsbFVVWGRQVkVreFRWZEtiVmxYV20xTmJVWm9Ua2ROTUUxNlozaE5hbEp0VGxkSmVFOUVWbWxhYW1ob1drUkZNVTU2VVhsTlYxWm9UV3BOTVUxVVp6Tk9SMXByVG0xYWEwNUVUVEJOVkZsM1prVTFSbFl6ZHowPXxVSG81YUZZeWVEWk9NMnd5VFd4U1dVOUVNV1pOVkdobVRGUkdPRTFVVFRCTlJFRXlUMVJWTTAxRVVYbE5lbXQ2VDFOd1NGVlZkM0ZtUkUxNldYcGpNVnBxVFhoT2FtZDNXbTFSTlU1VVNYcFpNa1Y1VG5wa2FrNVhWWGhaZWtaclRrUldhVTVxWkd4WlYwbDZUV3BXYWxwRVJUVk5WR016V1ZkUmVsbFhSbWhOTWswMVRXcEpOVTVFUVRKTlJGWTRWR3RXV0daQlBUMD18Tm9uZXwxMzQwMDY5NTcwNDIzOTM5KkdRTCp8OTBjOWZmYWFlYjViMTgzNmFmNjNiNGQ0MDgxN2VjZTU0ODY4YTc3MmU3MzgwOGY0MDBkYmNkOTgxZWE4YmYwZnxORVd8 credits_used: 1 trimmed: summary: Trimmed Response value: success: true pins: '0': id: '536350636896983083' url: https://www.pinterest.com/pin/536350636896983083 description: >- Cozy nights call for something special, and nothing beats a hearty **Italian Pot Roast (Stracotto)**. Imagine tender, melt-in-your-mouth beef simmered to perfection in aromatic herbs and rich red wine, bringing warmth to your dinner table. This dish not only fills your home with irresistible aromas but also creates a comforting meal that everyone will love. Plus, it’s surprisingly easy to make! Ready to impress your friends and family? Don’t wait—discover how to create this mouthwatering Italian classic today! created_at: Sun, 01 Feb 2026 10:09:17 +0000 pinner: node_id: VXNlcjo1MzYzNTA3NzQyODA1OTE5NTQ= image_large_url: >- https://i.pinimg.com/140x140_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg image_small_url: >- https://i.pinimg.com/30x30_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg follower_count: 13 verified_identity: {} username: brendafamalaro image_medium_url: >- https://i.pinimg.com/75x75_RS/59/e3/18/59e318400fe2559074d42e05b30e1a69.jpg full_name: Brenda Famalaro id: '536350774280591954' is_ads_only_profile: false is_verified_merchant: false images: 170x: width: 236 height: 466 url: >- https://i.pinimg.com/236x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg 236x: width: 236 height: 466 url: >- https://i.pinimg.com/236x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg 474x: width: 474 height: 936 url: >- https://i.pinimg.com/474x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg 736x: width: 736 height: 1454 url: >- https://i.pinimg.com/736x/91/61/df/9161df84f61b82efef873750a3b7332d.jpg orig: width: 1024 height: 2024 url: >- https://i.pinimg.com/originals/91/61/df/9161df84f61b82efef873750a3b7332d.jpg cursor: >- Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWlVWbFJXTVVreVZtMXpNVlV4U1hkTlZGcFhVak5vVkZVeWMzaFNhekZWVjIxb2JHRXpRbEJYYkdRMFZtc3hWMVZzYUdwU2JrSnpWbXhvVTJWV1pISlhhM1JYVm10V05sVldVbE5YUjBwSVZXdG9XbFpXY0hwYVJWcFhWMWRHU0ZKc1pGTmhNV3cyVm10amVHUXhUbkpPVmxwT1ZteGFVMVl3WkZOVU1YQllUVlJTYVUxWFVqQlpNRlpMVkRGYVZWSnJiRmRpUjJoeVZsVmFZVk5HVm5WUmJGWllVMFZLVEZkclVrZGpiVlpYVm01U2FsSlVWbTlaYkZVd1RWWmFTRTVZWkZaaVZscEhWRlpXVjFWc1drWlRiVVphWWtaYWFGbDZSbE5YUjA1R1pFZHNWMkpyU2tkV1ZscFRVakZTZEZKdVNrOVhSVFZXVkZaYVMxVXhVbkpYYms1cVZteHdNRlJXVlRWaVIwWTJWbTV3VjAxV1NsQlVhMXBTWlVaT2MxcEhSbE5TTWswMVdtdGFWMU5YU2paVmJYaFRWMGRvUmxkc1ZsZGhNV1J6VjFod2FGSkdjRmxaYTJSdVpXeFNjMVpZYUZOV2JYY3lWa2R6TlZZeFNsaGtSRTVYVW0xb00xa3ljM2hqYXpGVlYyeGtWMUpzY0ZCWFZtUTBZekExVjFSWWJHdFNNMUpYV1d0YVMxSldhM2RWYlRsV1VtdHdSMWt3YUVkWFJtUkpVV3hPWVZZemFETldiRnByWkVkR1IyTkdaRTVTUlVreFZtdFNRMkV4U25KTlNHUk9WbXhhVlZsc2FFTlVNVlp4VVZob1QySkhVbnBXVjNSaFZERmFWVlp1YUZkTmFrVjNWa2Q0WVZKc1NuRldiRlpPVWpGS1dGWkdVa2RqTWs1WFVtNVNiRkpVVmxSVmJGWldaVVphUjFkc1RsSk5hMXBJV1RCYWIxZEdaRWxSYkVKWFlURlZlRmt3V210WFJURlhWMnMxVGxZelkzbFdNalYzVmpGV1IxZFlhRk5oYkVwWlZtcE9RMVV4VW5KV1ZFWlBZa2hDU1ZwRldrTlhSazVJWVVaR1YxWXphR2haVkVFMVVXeENWVTFVYUZCV1JVVjZWRzV3Vm1WVk5VVlVWRlpQWVdzd2VGUXhVa3BOYXpGd1kwVm9WbFpZWkhoYWExSlNUV3hzZEZadGRGcE5iRnB4VkZod1EyRXhhM2xTYldoUFpXMU5lbGRyVW10aFJUVnhVMjEwV21WclJYbFVWV1JoWVVac05sRlVVazlXTVVZelZEQlNVMkZHYkhGWk0yUlBZV3RLY2xSdE1VWmxWbkJJVjIxb1lWWkZSalZVVlZKYVpXeHNkRkp0ZEdGV01GWTJWREJTWVU5R1VuSldiR2h0VVZRd09XWkVhM2RPZW1NeFRXcFJlazlVV1hwT1ZHdDVUbXBKY1ZJeFJrMUxibmQ0VFZSbmVVNTZhM2xQVkZrMVRsUkdhVTF0U1RWWlZHY3lXV3BvYUZwVVJUTk9iVlpvVFZSSk1VNTZXVEZhYlZGNFRUSmFhbGxVWnpKT2FteHNUVlJSZUZsVVRtaE9SRTB5VG1wV2FFMUVTVFJhVjAwMFprVTFSbFl6ZHowPXxVSG81TkZSRldubGtWVlV5VlVWS01WUlVNV1pOVkdobVRGUkdPRTlVUVROT2VsVjVUa1JOTlU1cVRURlBWRWt5VFdsd1NGVlZkM0ZtUjBacFdXMVJNVnBVVG14Tk1sVXlXa1JDYUU1SFRYbE5WMHBxVFZSak1FMTZSWGhQVjBsNlRWZGFiVmw2VW14TmJWVjNXWHBDYlZwVVRUUk5iVVpzVGxSak5GcFhTVFJPYlZWNFdsZFNhVTlIUlRGWlZHZzRWR3RXV0daQlBUMD18Tm9uZXw5MDc3NTI0Mzk2MzU5MjYyKkdRTCp8NDhlN2EzMDI3MzI2MzI1M2UyYWM1Mjc1MjVlMDRlZTZjNjU4NzhkMzc4NDM5MWFkNzg0Y2Q3M2RlMWRmMjczYnxORVd8 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: Search query 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). ````