Skip to main content
GET
/
v1
/
scrape
/
facebook-ad-library
/
search-companies
Search for Companies
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "searchResults": {
      "0": {
        "page_id": "33693527731",
        "category": "Clothing (Brand)",
        "image_uri": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.30808-1/462706481_931553435664825_1534082515114296213_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=zGq4SzdNLogQ7kNvwGrjg-R&_nc_oc=AdlDEnIkMwc3w9yq-Fqt6waOlZ5pFUKT6Mu2SzuHF0A4GPNmtkuhtcTChwcdh7fZAR0&_nc_zt=24&_nc_ht=scontent-sea1-1.xx&_nc_gid=gSVIaGqsybhf6jC_M7Hslw&oh=00_AfsC6-cazbSy94aQiX4JWoVbwSJE5i-F6F3NAYjj0ZekBg&oe=698EEF17",
        "likes": 3444605,
        "verification": "BLUE_VERIFIED",
        "name": "lululemon",
        "country": null,
        "entity_type": "PERSON_PROFILE",
        "ig_username": "lululemon",
        "ig_followers": 5437603,
        "ig_verification": true,
        "page_alias": "lululemon",
        "page_is_deleted": false
      }
    }
  },
  "creditsUsed": 1
}

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.

💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
query
string
required

Keyword to search for

Example:

"nike"

Response

Successful response

Key Response Fields:

  • data.searchResults[0].page_id: The company's ad library page ID — use this with the Company Ads endpoint
  • data.searchResults[0].name: Company display name
  • data.searchResults[0].category: Facebook page category
  • data.searchResults[0].image_uri: Company logo/profile image URL
  • data.searchResults[0].likes: Total Facebook page likes
  • data.searchResults[0].verification: Verification status (e.g., "BLUE_VERIFIED")
  • data.searchResults[0].ig_username: Associated Instagram username
  • data.searchResults[0].ig_followers: Instagram follower count
  • data.searchResults[0].ig_verification: Whether the Instagram account is verified
  • data.searchResults[0].entity_type: Facebook entity type (e.g., "PERSON_PROFILE")