> ## 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. # Ad Details > Get details for a specific Facebook Ad Library entry by Ad ID. For ads with multiple versions, the title should be sourced from the `cards` object in the response. 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/facebook-ad-library/ad-details 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/facebook-ad-library/ad-details: get: tags: - facebookAdLibrary summary: Ad Details description: >- Get details for a specific Facebook Ad Library entry by Ad ID. For ads with multiple versions, the title should be sourced from the `cards` object in the response. operationId: facebookAdLibrary_Ad_Details parameters: - name: id in: query description: Facebook Ad Id required: false schema: type: string example: '702369045530963' - name: url in: query description: Facebook Ad URL required: false schema: type: string example: https://www.facebook.com/ads/library?id=1185617869915074 - name: get_transcript in: query description: >- Get the transcript of the ad. This is a new feature, so let me know if its not working how you expected. required: false schema: type: boolean example: false - 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:** - `data.adArchiveID`: The actual ad ID (note: `adid` is always 0 — always use `adArchiveID`) - `data.isActive`: Whether the ad is currently running - `data.pageName`: Name of the Facebook page running the ad - `data.pageID`: Facebook page ID - `data.startDateString`: ISO timestamp of when the ad started running - `data.endDateString`: ISO timestamp of when the ad stopped (or is scheduled to stop) - `data.publisherPlatform`: Platforms the ad runs on (e.g., facebook, instagram, messenger) - `data.snapshot.title`: Ad headline/title - `data.snapshot.body`: Ad body copy - `data.snapshot.cta_text`: Call-to-action button text (e.g., `"Install Now"`, `"Shop Now"`) - `data.snapshot.cta_type`: CTA type identifier (e.g., `"INSTALL_MOBILE_APP"`, `"SHOP_NOW"`) - `data.snapshot.cards[0].title`: Title from the first carousel card (for multi-creative ads) - `data.snapshot.cards[0].body`: Body text from the first carousel card content: application/json: examples: full: summary: Full Response value: success: true data: success: true adid: 0 adArchiveID: 3557423444566854 archiveTypes: {} categories: '0': 0 containsDigitallyCreatedMedia: false containsSensitiveContent: false collationCount: null collationID: null currency: '' endDate: 1770537600 entityType: person_profile fevInfo: null finServAdData: is_deemed_finserv: false is_limited_delivery: false gatedType: eligible hasUserReported: false hiddenSafetyData: false hideDataStatus: NONE impressionsWithIndex: impressionsText: null impressionsIndex: -1 isAAAEligible: false isAdAccountActioned: false isActive: true isProfilePage: false pageID: 1542166686041969 pageInfo: null pageIsDeleted: false pageName: Shopee politicalCountries: {} reachEstimate: null regionalRegulationData: finserv: is_deemed_finserv: false is_limited_delivery: false tw_anti_scam: is_limited_delivery: false reportCount: null snapshot: ad_creative_id: '120214193865470606' cards: '0': original_image_url: >- https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwFmnXJY&_nc_oc=AdlnFNvaCYKuwq9XQ8qjmVidpEgC_3TRxIqb58PoxGII4RvNlpS1ZZXelOrGRTVDiRs&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_Aftq91c9ZaQ-d56K6rBu0FS8M-9b29Uee7qnojLMM3cMcg&oe=698EF609 resized_image_url: >- https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwFmnXJY&_nc_oc=AdlnFNvaCYKuwq9XQ8qjmVidpEgC_3TRxIqb58PoxGII4RvNlpS1ZZXelOrGRTVDiRs&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_AfuX3sQHiOMO598uo26NklZhA0ExNfCZ3taoOUD7Df3e_g&oe=698EF609 watermarked_resized_image_url: '' body: >- Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat! caption: play.google.com cta_type: INSTALL_MOBILE_APP cta_text: Install Now title: >- Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i link_description: GARANSI TEPAT WAKTU di Shopee! 🧡 link_url: null body_translations: {} byline: null caption: null cta_text: Install now dynamic_item_flags: '0': {} '1': {} '2': {} '3': {} '4': {} '5': {} dynamic_versions: 2168887 edited_snapshots: {} effective_authorization_category: NONE event: {} extra_images: {} extra_links: {} extra_texts: {} extra_videos: {} instagram_shopping_products: {} display_format: dpa title: >- Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i link_description: GARANSI TEPAT WAKTU di Shopee! 🧡 link_url: null page_welcome_message: null images: {} videos: {} creation_time: 1734109297 page_id: 1542166686041969 page_name: Shopee page_profile_picture_url: >- https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470221141_598719742707546_5888493433237993681_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rSXK_QyCxC8Q7kNvwEJLNRh&_nc_oc=Adkotq79Vg-clup96CofB6e4_0atik8CLIDQRbGslKeCSjvmpzIND5FgFp9JRplqnhI&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_Aft00gURPqoSqKaZ-_0N1INoE__hk8n-oRC7QUK7pAILuA&oe=698EF1AC page_categories: '2301': App page page_entity_type: person_profile page_is_profile_page: false instagram_actor_name: Shopee instagram_profile_pic_url: >- https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/470129690_856310040046044_288555385467158142_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=XmmalUqE8poQ7kNvwHyCVDV&_nc_oc=AdmgsLfFrlgbJgAHDdqmEBbHuVmQwr6ERPjQ7BgFcUL9kkh0aXbHp5GYyvulpwu2t4A&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_AfthSLf9YFw1Q_hMR1i1KeLnwrhrxkSvFmVQLcxjlI-teQ&oe=698ED902 instagram_url: '' instagram_handle: '' is_reshared: false version: 3 body: >- Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat! brazil_tax_id: null branded_content: null current_page_name: Shopee disclaimer_label: null page_like_count: 31605854 page_profile_uri: https://www.facebook.com/ShopeeID/ page_is_deleted: false root_reshared_post: null cta_type: INSTALL_MOBILE_APP additional_info: null ec_certificates: null country_iso_code: null instagram_branded_content: null final_url: null spend: null startDate: 1749106800 stateMediaRunLabel: null publisherPlatform: '0': facebook '1': instagram '2': audience_network '3': messenger menuItems: {} targetedOrReachedCountries: {} totalActiveTime: null url: https://www.facebook.com/ads/library?id=3557423444566854 startDateString: '2025-06-05T07:00:00.000Z' endDateString: '2026-02-08T08:00:00.000Z' aaa_info: null creditsUsed: 1 trimmed: summary: Trimmed Response value: success: true data: success: true adid: 0 adArchiveID: 3557423444566854 archiveTypes: {} categories: '0': 0 containsDigitallyCreatedMedia: false containsSensitiveContent: false collationCount: null collationID: null currency: '' endDate: 1770537600 entityType: person_profile fevInfo: null finServAdData: is_deemed_finserv: false is_limited_delivery: false gatedType: eligible hasUserReported: false hiddenSafetyData: false hideDataStatus: NONE impressionsWithIndex: impressionsText: null impressionsIndex: -1 isAAAEligible: false isAdAccountActioned: false isActive: true isProfilePage: false pageID: 1542166686041969 pageInfo: null pageIsDeleted: false pageName: Shopee politicalCountries: {} reachEstimate: null regionalRegulationData: finserv: is_deemed_finserv: false is_limited_delivery: false tw_anti_scam: is_limited_delivery: false reportCount: null snapshot: ad_creative_id: '120214193865470606' cards: '0': original_image_url: >- https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwFmnXJY&_nc_oc=AdlnFNvaCYKuwq9XQ8qjmVidpEgC_3TRxIqb58PoxGII4RvNlpS1ZZXelOrGRTVDiRs&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_Aftq91c9ZaQ-d56K6rBu0FS8M-9b29Uee7qnojLMM3cMcg&oe=698EF609 resized_image_url: >- https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwFmnXJY&_nc_oc=AdlnFNvaCYKuwq9XQ8qjmVidpEgC_3TRxIqb58PoxGII4RvNlpS1ZZXelOrGRTVDiRs&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_AfuX3sQHiOMO598uo26NklZhA0ExNfCZ3taoOUD7Df3e_g&oe=698EF609 watermarked_resized_image_url: '' body: >- Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat! caption: play.google.com cta_type: INSTALL_MOBILE_APP cta_text: Install Now title: >- Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i link_description: GARANSI TEPAT WAKTU di Shopee! 🧡 link_url: null body_translations: {} byline: null caption: null cta_text: Install now dynamic_item_flags: '0': {} '1': {} '2': {} '3': {} '4': {} '5': {} dynamic_versions: 2168887 edited_snapshots: {} effective_authorization_category: NONE event: {} extra_images: {} extra_links: {} extra_texts: {} extra_videos: {} instagram_shopping_products: {} display_format: dpa title: >- Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i link_description: GARANSI TEPAT WAKTU di Shopee! 🧡 link_url: null page_welcome_message: null images: {} videos: {} creation_time: 1734109297 page_id: 1542166686041969 page_name: Shopee page_profile_picture_url: >- https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470221141_598719742707546_5888493433237993681_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rSXK_QyCxC8Q7kNvwEJLNRh&_nc_oc=Adkotq79Vg-clup96CofB6e4_0atik8CLIDQRbGslKeCSjvmpzIND5FgFp9JRplqnhI&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_Aft00gURPqoSqKaZ-_0N1INoE__hk8n-oRC7QUK7pAILuA&oe=698EF1AC page_categories: '2301': App page page_entity_type: person_profile page_is_profile_page: false instagram_actor_name: Shopee instagram_profile_pic_url: >- https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/470129690_856310040046044_288555385467158142_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=XmmalUqE8poQ7kNvwHyCVDV&_nc_oc=AdmgsLfFrlgbJgAHDdqmEBbHuVmQwr6ERPjQ7BgFcUL9kkh0aXbHp5GYyvulpwu2t4A&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_AfthSLf9YFw1Q_hMR1i1KeLnwrhrxkSvFmVQLcxjlI-teQ&oe=698ED902 instagram_url: '' instagram_handle: '' is_reshared: false version: 3 body: >- Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat! brazil_tax_id: null branded_content: null current_page_name: Shopee disclaimer_label: null page_like_count: 31605854 page_profile_uri: https://www.facebook.com/ShopeeID/ page_is_deleted: false root_reshared_post: null cta_type: INSTALL_MOBILE_APP additional_info: null ec_certificates: null country_iso_code: null instagram_branded_content: null final_url: null spend: null startDate: 1749106800 stateMediaRunLabel: null publisherPlatform: '0': facebook '1': instagram '2': audience_network '3': messenger menuItems: {} targetedOrReachedCountries: {} totalActiveTime: null url: https://www.facebook.com/ads/library?id=3557423444566854 startDateString: '2025-06-05T07:00:00.000Z' endDateString: '2026-02-08T08:00:00.000Z' aaa_info: null 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). ````