> ## 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 Ads > Search the LinkedIn Ad Library 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/linkedin-ad-library/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/linkedin-ad-library/search: get: tags: - linkedinAdLibrary summary: Search Ads description: Search the LinkedIn Ad Library operationId: linkedinAdLibrary_Search_Ads parameters: - name: company in: query description: The company name to search for. 'Microsoft' for example required: false schema: type: string example: microsoft - name: keyword in: query description: The keyword to search for required: false schema: type: string example: scraping - name: countries in: query description: 'Comma separated list of countries. Example: US,CA,MX' required: false schema: type: string example: US,CA,MX - name: startDate in: query description: 'Start date to search for. Format: YYYY-MM-DD' required: false schema: type: string example: '2024-01-01' - name: endDate in: query description: 'End date to search for. Format: YYYY-MM-DD' required: false schema: type: string example: '2024-01-10' - name: paginationToken in: query description: Pagination token to paginate through results required: false schema: type: string example: 640547184-1743616612000 responses: '200': description: >- Successful response **Key Response Fields:** - `ads[0].id`: Unique ad identifier - `ads[0].description`: Full ad body text/copy - `ads[0].headline`: Ad headline (may be `null`) - `ads[0].poster`: Name of the company running the ad - `ads[0].adType`: Format of the ad (e.g. `Single Image Ad`, `Video Ad`, `Carousel Ad`) - `ads[0].advertiser`: Advertiser display name - `ads[0].advertiserLinkedinPage`: URL to the advertiser's LinkedIn company page - `ads[0].image`: URL of the ad's image asset (may be `null`) - `ads[0].cta`: Call-to-action button text (e.g. `Learn more`, `Request Demo`) - `ads[0].destinationUrl`: Landing page URL - `ads[0].targeting.language`: Audience language targeting description - `ads[0].targeting.location`: Audience location targeting description - `ads[0].startDate` / `endDate`: ISO 8601 timestamps for ad run period - `ads[0].totalImpressions`: Impression range string (e.g. `5k-10k`) or `null` - `ads[0].url`: Direct link to this ad in the LinkedIn Ad Library - `paginationToken`: Token to pass as `paginationToken` for the next page - `isLastPage`: Boolean indicating whether this is the final page of results content: application/json: example: success: true data: success: true ads: '0': id: '1140187154' description: >- Most foreclosure attorneys pay $50-100 per lead from aggregators. Those leads are shared with 5-10 other firms. Conversion rate: 2-3% if you're lucky. Here's what exclusive, pre-qualified leads look like: → 100 leads/month: $5,000 → 10% conversion rate: 10 new clients → $6,000 average case value: $60,000 revenue → ROI: 1,100% These aren't scraped from lis pendens lists. They're homeowners who've actively requested help through our intake system — before they've talked to anyone else. You get: name, phone, email, mortgage details, and a pre-qualification score so you know who to prioritize. One South Florida firm generated $120K in case revenue using this system. We're selective about who we work with. Take the 2-minute assessment to see if your firm qualifies. headline: null poster: Foreclosure prevention today posterTitle: Promoted promotedBy: null targeting: {} image: >- https://media.licdn.com/dms/image/v2/D4D10AQEOyJApJjptKw/image-shrink_1280/B4DZwBRNN_H0Ac-/0/1769547814081/Linkedin_Ad_2jpg?e=2147483647&v=beta&t=irh7O7L69m_3rxsxiPhBKlsPG986fCJJ0sfn4N3mF64 video: null carouselImages: {} url: https://www.linkedin.com/ad-library/detail/1140187154 adType: Single Image Ad advertiser: Foreclosure prevention today advertiserLinkedinPage: https://www.linkedin.com/company/111293908 cta: null destinationUrl: null adDuration: '' startDate: null endDate: null totalImpressions: null impressionsByCountry: {} '1': id: '1139557184' description: >- Access the web's data. Clean, ready, and at scale. Book a meeting with one of our data experts and we'll identify the best solution for your needs. headline: Book a quick 30-minute Discovery Call poster: Zyte posterTitle: Promoted promotedBy: null targeting: {} image: >- https://media.licdn.com/dms/image/v2/D4E10AQEYo5mdQZyhEQ/image-shrink_1280/B4EZnJNdpBJgAM-/0/1760017375838/webscrapingapi2_v4png?e=2147483647&v=beta&t=Refjn2tB-b3_mTMcMXVBj7lNkc5QSMEkt790J-DYTP0 video: null carouselImages: {} url: https://www.linkedin.com/ad-library/detail/1139557184 adType: Single Image Ad advertiser: Zyte advertiserLinkedinPage: https://www.linkedin.com/company/2450827 cta: Learn more destinationUrl: >- https://www.zyte.com/?utm_source=linkedin&utm_medium=paid&utm_campaign=SAAS_Retargeting_Lead_Gen&hsa_acc=507803102&hsa_cam=757256484&hsa_grp=478152434&hsa_ad=1139557184&hsa_net=linkedin&hsa_ver=3&trk=ad_library_ad_preview_headline_content adDuration: '' startDate: null endDate: null totalImpressions: null impressionsByCountry: {} '2': id: '1174793313' description: >- Scraping at scale requires trust. IPRoyal proxies are built for reliable performance. headline: IPRoyal - Reliable Proxies for Success poster: IPRoyal posterTitle: Promoted promotedBy: null targeting: language: Targeting includes English location: |- Targeting includes United States, Australia and 2 others New Zealand, Europe Targeting excludes India, Egypt image: >- https://media.licdn.com/dms/image/v2/D4D10AQHMqLVjbh0VwQ/image-shrink_1280/B4DZqmsGvMKIAM-/0/1763733173685/01_DataScrapingBusinessIntelligence_1200x1200jpg?e=2147483647&v=beta&t=L2YlJTBCcA2HFvnTrMb13rhrwypTRiW848Xu4FzwOSk video: null carouselImages: {} url: https://www.linkedin.com/ad-library/detail/1174793313 adType: Single Image Ad advertiser: IPRoyal advertiserLinkedinPage: https://www.linkedin.com/company/71890168 cta: Request Demo destinationUrl: >- https://iproyal.com/?utm_source=linkedin&utm_medium=cpc&utm_campaign=enterprise&utm_content=data_scraping_2&trk=ad_library_ad_preview_headline_content adDuration: Ran from Feb 6, 2026 to Feb 8, 2026 startDate: '2026-02-06T00:00:00.000Z' endDate: '2026-02-08T00:00:00.000Z' totalImpressions: 5k-10k impressionsByCountry: {} paginationToken: 1140187154-1770319878944 isLastPage: false creditsUsed: 1 '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error 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). ````