🚀 Facebook Ad Library Suggestions Actor > Search Facebook Ad Library for brand pages and get comprehensive brand information This actor searches Facebook's Ad Library for brand pages based on a brand name and returns detailed information including verification status, follower counts, Instagram integration, and more. --- ## ✨ What It Offers - 🔍 Smart Brand Search - Find brand pages in Facebook Ad Library - 📊 Rich Data - Get comprehensive brand information: - Page verification status - Facebook likes and follower counts - Instagram username and follower counts - Page category and classification - Profile images and avatars - 🔄 Reliable - Automatic retry logic for failed requests - ⚡ Fast - Optimized for quick results --- ## 📥 Input Provide the brand name you want to search for: json { "brand_name": "Nike" } | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | brand_name | string | ✅ Yes | The brand name to search for in Facebook Ad Library | Example: json { "brand_name": "Apple" } --- ## 📤 Output The actor returns an array of brand suggestions with detailed information: json { "suggestions": [ { "adlibrary_url": "15087023444", "brand_name": "Nike", "category": "Sportswear Store", "avatar_url": "https://scontent...", "likes": 39569063, "verification": "BLUE_VERIFIED", "page_alias": "nike", "ig_username": "nike", "ig_followers": 298381769, "ig_verification": true } ], "metadata": { "timestamp": "2025-11-16T09:13:16.588382", "brand_name": "Nike", "total_results": 15 } } ### Output Fields Explained | Field | Description | |-------|-------------| | adlibrary_url | Facebook page ID (use this to access the page in Ad Library) | | brand_name | Name of the brand/page | | category | Page category (e.g., "Sportswear Store", "Product/service") | | avatar_url | URL to the page's profile image | | likes | Number of Facebook page likes | | verification | Verification status: "BLUE_VERIFIED" or "NOT_VERIFIED" | | page_alias | Facebook page username/alias | | ig_username | Instagram username (if connected) | | ig_followers | Instagram follower count (if available) | | ig_verification | Whether the Instagram account is verified (true/false) | ### Metadata Each result includes metadata: - timestamp - When the search was performed - brand_name - The searched brand name - total_results - Number of suggestions found --- ## 🚨 Error Handling If an error occurs, the actor returns an error object: json { "error": "Request failed: Connection timeout", "raw_response": "...", "timestamp": "2025-11-16T09:13:16.588382" } The actor automatically handles: - Network errors - API errors - Invalid responses --- ## 📝 Notes - Results are currently limited to the Indian market (country code: IN) - The actor searches for all ad types - All requests are made through a configured proxy for reliability --- ## 🎯 Use Cases - Brand Research - Find official brand pages and verify authenticity - Competitor Analysis - Discover related brands and pages - Social Media Intelligence - Get Instagram and Facebook metrics - Brand Verification - Check verification status of brand pages