🚀 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:

{
  "brand_name": "Nike"
}

Parameter	Type	Required	Description
brand_name	string	✅ Yes	The brand name to search for in Facebook Ad Library

Example:

{
  "brand_name": "Apple"
}

---

📤 Output

The actor returns an array of brand suggestions with detailed information:

{
  "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:

{
  "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