> ## 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.

# Pin

> Get Pinterest pin details

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


## OpenAPI

````yaml GET /v1/scrape/pinterest/pin
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/pin:
    get:
      tags:
        - pinterest
      summary: Pin
      description: Get Pinterest pin details
      operationId: pinterest_Pin
      parameters:
        - name: url
          in: query
          description: Pinterest pin URL
          required: true
          schema:
            type: string
            example: https://www.pinterest.com/pin/1124351863225567517/
        - 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:**
            - `entityId`: Pin unique ID
            - `title`: Pin title
            - `description`: Full pin description text
            - `link`: External destination URL
            - `domain`: Source domain of the linked content
            - `pinner.username`: Pinner's handle
            - `pinner.followerCount`: Pinner's follower count
            - `aggregatedPinData.aggregatedStats.saves`: Total save count
            - `repinCount`: Number of repins
            - `createdAt`: Pin creation timestamp
            - `board.name`: Board name the pin belongs to
            - `images_474x.url`: Medium resolution image URL
          content:
            application/json:
              examples:
                full:
                  summary: Full Response
                  value:
                    success: true
                    entityId: '1124351863225567517'
                    seoAltText: >-
                      chicken linguine with text overlay that reads cowboy
                      butter chicken linguine
                    dominantColor: '#c79743'
                    originPinner: null
                    embed: null
                    isGoLinkless: false
                    digitalMediaSourceType: null
                    link: >-
                      https://smokerecipes.blogspot.com/2025/04/cowboy-pasta-recipe.html
                    mobileLink: null
                    trackedLink: >-
                      https://smokerecipes.blogspot.com/2025/04/cowboy-pasta-recipe.html
                    utmLink: >-
                      https://smokerecipes.blogspot.com/2025/04/cowboy-pasta-recipe.html?utm_source=Pinterest&utm_medium=organic
                    trackingParams: >-
                      CwABAAAAEDE1NzQ3MDIyNzAyNjIxMjILAAcAAAAPdW5rbm93bi91bmtub3duAA
                    isViewedByOwnerOrEmployeeOrPartnerOfBusiness: null
                    images_236x:
                      height: 472
                      width: 236
                      url: >-
                        https://i.pinimg.com/236x/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                    images_136x136:
                      height: 136
                      width: 136
                      url: >-
                        https://i.pinimg.com/136x136/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                    images_60x60:
                      url: >-
                        https://i.pinimg.com/60x60/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                    images_170x:
                      url: >-
                        https://i.pinimg.com/236x/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                    images_474x:
                      url: >-
                        https://i.pinimg.com/474x/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                      height: 948
                      width: 474
                    images_564x:
                      url: >-
                        https://i.pinimg.com/564x/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                      height: 1024
                      width: 512
                    images_736x:
                      url: >-
                        https://i.pinimg.com/736x/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                      height: 1024
                      width: 512
                    images_600x315:
                      url: >-
                        https://i.pinimg.com/600x315/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                    images_orig:
                      url: >-
                        https://i.pinimg.com/originals/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                    imageSignature: 14287288a2314a6607a5304f1364b91f
                    linkUtmApplicableAndReplaced: 1
                    isDownstreamPromotion: false
                    category: ''
                    domain: smokerecipes.blogspot.com
                    isPromoted: false
                    linkDomain:
                      officialUser: null
                      id: RG9tYWluOjEwNDAyNjE0ODg3NzU3OTc1MjY=
                      __typename: Domain
                    promoter: null
                    isEligibleForPdp: false
                    isOosProduct: false
                    isStaleProduct: false
                    shoppingFlags: {}
                    pinner:
                      blockedByMe: false
                      id: VXNlcjoxMTI0MzUyMDAwNjI5NDEzMjQy
                      entityId: '1124352000629413242'
                      __typename: User
                      fullName: Grace Carter
                      imageSmallUrl: >-
                        https://i.pinimg.com/30x30_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      imageLargeUrl: >-
                        https://i.pinimg.com/140x140_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      username: gracecartergra
                      imageMediumUrl: >-
                        https://i.pinimg.com/75x75_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      explicitlyFollowedByMe: false
                      firstName: Grace Carter
                      isVerifiedMerchant: false
                      verifiedIdentity:
                        verified: null
                      followerCount: 49
                    promotedIsRemovable: false
                    description: >-
                      🧈🍗 Creamy Cowboy Butter Chicken Linguine is comfort food
                      at its finest! Imagine tender chicken tossed in rich,
                      buttery sauce over a bed of linguine – pure deliciousness.
                      This easy pasta recipe is perfect for cozy nights and
                      special occasions alike. Serve with garlic bread for the
                      ultimate meal! 😋 #CowboyButterChicken #CreamyPasta
                      #ComfortFood #EasyPastaRecipes #ChickenDinner #CozyMeals
                      #DinnerIdeas #WeekendDinners #PastaLove 🍝
                    imageSpec_236x:
                      url: >-
                        https://i.pinimg.com/236x/14/28/72/14287288a2314a6607a5304f1364b91f.jpg
                    gridTitle: >-
                      Creamy Cowboy Butter Chicken Linguine – Comfort Food
                      Perfection
                    title: >-
                      Creamy Cowboy Butter Chicken Linguine – Comfort Food
                      Perfection
                    videos: null
                    closeupUnifiedDescription: >-
                      🧈🍗 Creamy Cowboy Butter Chicken Linguine is comfort food
                      at its finest! Imagine tender chicken tossed in rich,
                      buttery sauce over a bed of linguine – pure deliciousness.
                      This easy pasta recipe is perfect for cozy nights and
                      special occasions alike. Serve with garlic bread for the
                      ultimate meal! 😋 #CowboyButterChicken #CreamyPasta
                      #ComfortFood #EasyPastaRecipes #ChickenDinner #CozyMeals
                      #DinnerIdeas #WeekendDinners #PastaLove 🍝
                    aggregatedPinData:
                      entityId: '5426653175719443145'
                      id: QWdncmVnYXRlZFBpbkRhdGE6NTQyNjY1MzE3NTcxOTQ0MzE0NQ==
                      aggregatedStats:
                        saves: 419
                      commentCount: 0
                      didItData:
                        imagesCount: 0
                    isEligibleForAggregatedComments: true
                    richMetadata:
                      recipe: null
                      article:
                        __typename: ArticleMetadata
                        datePublished: Fri, 25 Apr 2025 00:00:00 +0000
                      description: >-
                        Please follow this link .       When I think about
                        comfort food that brings a big, warm hug in a bowl, my
                        mind always wan...
                      title: Cowboy Pasta Recipe
                      products: null
                      aggregateRating: null
                      tutorial: null
                      siteName: smokerecipes.blogspot.com
                      url: >-
                        https://smokerecipes.blogspot.com/2025/04/cowboy-pasta-recipe.html
                    totalReactionCount: 2
                    board:
                      privacy: public
                      url: /gracecartergra/dessert-ideas/
                      name: Dessert Ideas
                      id: Qm9hcmQ6MTEyNDM1MTkzMTkxMTA4NDIyOQ==
                      entityId: '1124351931911084229'
                      pinCount: 66
                      sectionCount: 0
                      boardOrderModifiedAt: Thu, 08 May 2025 10:26:08 +0000
                      coverImageSpec_222x:
                        url: >-
                          https://i.pinimg.com/222x/01/2a/aa/012aaa8e30bd3a524d5cb0d8c609a0e9.jpg
                      coverImageSpec_400x300:
                        url: >-
                          https://i.pinimg.com/400x300/01/2a/aa/012aaa8e30bd3a524d5cb0d8c609a0e9.jpg
                      coverImageSpec_216x146:
                        url: >-
                          https://i.pinimg.com/216x146/01/2a/aa/012aaa8e30bd3a524d5cb0d8c609a0e9.jpg
                      imageCoverHdUrl: >-
                        https://i.pinimg.com/474x/01/2a/aa/012aaa8e30bd3a524d5cb0d8c609a0e9.jpg
                      imageCoverUrl: >-
                        https://i.pinimg.com/200x150/01/2a/aa/012aaa8e30bd3a524d5cb0d8c609a0e9.jpg
                      imageThumbnailUrl: >-
                        https://i.pinimg.com/upload/1124351931911084229_board_thumbnail_2025-05-01-13-14-02_6039_60.jpg
                      collaboratedByMe: false
                      isCollaborative: false
                      owner:
                        entityId: '1124352000629413242'
                        id: VXNlcjoxMTI0MzUyMDAwNjI5NDEzMjQy
                    richSummary:
                      displayName: Cowboy Pasta Recipe
                      products: {}
                    storyPinDataId: null
                    storyPinData: null
                    gridAttribution: null
                    sponsorship: null
                    nativeCreator:
                      entityId: '1124352000629413242'
                      fullName: Grace Carter
                      imageMediumUrl: >-
                        https://i.pinimg.com/75x75_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      imageSmallUrl: >-
                        https://i.pinimg.com/30x30_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      username: gracecartergra
                      isVerifiedMerchant: false
                      verifiedIdentity:
                        verified: null
                      id: VXNlcjoxMTI0MzUyMDAwNjI5NDEzMjQy
                      blockedByMe: false
                      explicitlyFollowedByMe: false
                      followerCount: 49
                      imageLargeUrl: >-
                        https://i.pinimg.com/140x140_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      profileUrl: https://www.pinterest.com/gracecartergra/
                    pinJoin:
                      visualAnnotation:
                        '0': Easy Cowboy Butter Chicken Linguine Recipe
                        '1': Cowboy Butter Chicken Linguini
                        '2': Easy Cowboy Butter Chicken Linguine
                        '3': Cowboy Butter Chicken Linguine Recipe
                        '4': Cowboy Chicken Butter Linguine
                        '5': Creamy Cowboy Butter Chicken Linguine
                        '6': Quick Cowboy Butter Chicken Linguine
                        '7': Creamy Cowboy Butter Chicken Linguini
                        '8': Cowboys Butter Chicken Linguine
                      annotationsWithLinksArray:
                        '0':
                          name: Easy Cowboy Butter Chicken Linguine Recipe
                          url: >-
                            /ideas/easy-cowboy-butter-chicken-linguine-recipe/906761486092/
                        '1':
                          name: Cowboy Butter Chicken Linguini
                          url: /ideas/cowboy-butter-chicken-linguini/901554649237/
                      seoBreadcrumbs:
                        '0':
                          __typename: SeoBreadcrumbs
                          name: Food And Drink
                          url: /ideas/food-and-drink/918530398158/
                      seoCanonicalDomain: www.pinterest.com
                      seoCanonicalUrl: >-
                        /pin/simple-and-delicious-cowboy-butter-chicken-pasta-linguine-recipe-in-2025--70437490512745/
                    shareCount: 439
                    reactionCountsData:
                      '0':
                        reactionCount: 2
                        reactionType: 1
                    unauthOnPageDescription: >-
                      🧈🍗 Creamy Cowboy Butter Chicken Linguine is comfort food
                      at its finest! Imagine tender chicken tossed in rich,
                      buttery sauce over a bed of linguine – pure deliciousness.
                      This easy pasta recipe is perfect for cozy nights and
                      special occasions alike. Serve with garlic bread for the
                      ultimate meal! 😋 #CowboyButterChicken #CreamyPasta
                      #ComfortFood #EasyPastaRecipes #ChickenDinner #CozyMeals
                      #DinnerIdeas #WeekendDinners #PastaLove 🍝
                    carouselData: null
                    unauthOnGridTitle: >-
                      Creamy Cowboy Butter Chicken Linguine – Comfort Food
                      Perfection
                    genAiTopics: null
                    isUnsafeForComments: false
                    seeMoreUserFeedback: null
                    recommendationReason: null
                    adData: null
                    adMatchReason: 0
                    sourceInterest: null
                    advertiserId: null
                    campaignId: null
                    pinPromotionId: null
                    adTargetingAttribution: null
                    adTargetingAttributionReasons: null
                    promotedPartnershipAdvertiserName: null
                    promotedPartnershipAttributionName: null
                    isEligibleForPromotedPartnership: false
                    isThirdPartyAd: false
                    commentsDisabled: true
                    doneByMe: true
                    closeupAttribution:
                      entityId: '1124352000629413242'
                      username: gracecartergra
                      id: VXNlcjoxMTI0MzUyMDAwNjI5NDEzMjQy
                    collectionPin: null
                    isHidden: false
                    isUnsafe: false
                    visualObjects: {}
                    affiliateDisclosure: null
                    affiliateLink: null
                    shipsToUserCountry: false
                    closeupUnifiedAttribution:
                      __typename: User
                      id: VXNlcjoxMTI0MzUyMDAwNjI5NDEzMjQy
                      entityId: '1124352000629413242'
                      imageMediumUrl: >-
                        https://i.pinimg.com/75x75_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      followerCount: 49
                      followedByMe: false
                      username: gracecartergra
                      isAdsOnlyProfile: false
                      adsOnlyProfileSite: null
                      isVerifiedMerchant: false
                      fullName: Grace Carter
                      verifiedIdentity:
                        verified: null
                    isRepin: false
                    favoriteUserCount: 0
                    favoritedByMe: false
                    createdAt: Sun, 06 Apr 2025 06:52:37 +0000
                    attribution: null
                    mediaAttribution: null
                    pinAdditionalNote: null
                    translations: null
                    descriptionLinks: {}
                    userMentionTags: null
                    seoNoindexReason: null
                    unauthOnPageTitle: >-
                      Creamy Cowboy Butter Chicken Linguine – Comfort Food
                      Perfection
                    repinCount: 6896
                    seoDescription: >-
                      Feb 11, 2025 - This Pin was discovered by Xemobo. Discover
                      (and save!) your own Pins on Pinterest
                    seoTitle: >-
                      Pin by Xemobo on nice | Recipes, Chicken recipes, Linguine
                      recipes
                    seoUrl: /pin/1124351863225567517/
                    descriptionHtml: >-
                      🧈🍗 Creamy Cowboy Butter Chicken Linguine is comfort food
                      at its finest! Imagine tender chicken tossed in rich,
                      buttery sauce over a bed of linguine – pure deliciousness.
                      This easy pasta recipe is perfect for cozy nights and
                      special occasions alike. Serve with garlic bread for the
                      ultimate meal! 😋 <a class="pintag"
                      href="/explore/CowboyButterChicken/"
                      title="#CowboyButterChicken explore
                      Pinterest">#CowboyButterChicken</a> <a class="pintag"
                      href="/explore/CreamyPasta/" title="#CreamyPasta explore
                      Pinterest">#CreamyPasta</a> <a class="pintag"
                      href="/explore/ComfortFood/" title="#ComfortFood explore
                      Pinterest">#ComfortFood</a> <a class="pintag"
                      href="/explore/EasyPastaRecipes/" title="#EasyPastaRecipes
                      explore Pinterest">#EasyPastaRecipes</a> <a class="pintag"
                      href="/explore/ChickenDinner/" title="#ChickenDinner
                      explore Pinterest">#Chicken</a>
                    priceCurrency: USD
                    id: UGluOjExMjQzNTE4NjMyMjU1Njc1MTc=
                    credits_used: 1
                trimmed:
                  summary: Trimmed Response
                  value:
                    success: true
                    entityId: '1124351863225567517'
                    seoAltText: >-
                      chicken linguine with text overlay that reads cowboy
                      butter chicken linguine
                    originPinner: null
                    pinner:
                      blockedByMe: false
                      id: VXNlcjoxMTI0MzUyMDAwNjI5NDEzMjQy
                      entityId: '1124352000629413242'
                      __typename: User
                      fullName: Grace Carter
                      imageSmallUrl: >-
                        https://i.pinimg.com/30x30_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      imageLargeUrl: >-
                        https://i.pinimg.com/140x140_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      username: gracecartergra
                      imageMediumUrl: >-
                        https://i.pinimg.com/75x75_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      explicitlyFollowedByMe: false
                      firstName: Grace Carter
                      isVerifiedMerchant: false
                      verifiedIdentity:
                        verified: null
                      followerCount: 49
                    description: >-
                      🧈🍗 Creamy Cowboy Butter Chicken Linguine is comfort food
                      at its finest! Imagine tender chicken tossed in rich,
                      buttery sauce over a bed of linguine – pure deliciousness.
                      This easy pasta recipe is perfect for cozy nights and
                      special occasions alike. Serve with garlic bread for the
                      ultimate meal! 😋 #CowboyButterChicken #CreamyPasta
                      #ComfortFood #EasyPastaRecipes #ChickenDinner #CozyMeals
                      #DinnerIdeas #WeekendDinners #PastaLove 🍝
                    shareCount: 439
                    nativeCreator:
                      entityId: '1124352000629413242'
                      fullName: Grace Carter
                      imageMediumUrl: >-
                        https://i.pinimg.com/75x75_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      imageSmallUrl: >-
                        https://i.pinimg.com/30x30_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      username: gracecartergra
                      isVerifiedMerchant: false
                      verifiedIdentity:
                        verified: null
                      id: VXNlcjoxMTI0MzUyMDAwNjI5NDEzMjQy
                      blockedByMe: false
                      explicitlyFollowedByMe: false
                      followerCount: 49
                      imageLargeUrl: >-
                        https://i.pinimg.com/140x140_RS/cf/dd/05/cfdd05ab7a756091fb820f69b2ef195a.jpg
                      profileUrl: https://www.pinterest.com/gracecartergra/
                    createdAt: Sun, 06 Apr 2025 06:52:37 +0000
                    repinCount: 6896
                    totalReactionCount: 2
                    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: Pinterest pin 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).

````