M
MesmerTools
GET/v1/facebook/adLibrary/search/companies

Search companies API

Typeahead-style search over advertisers in the public Facebook Ad Library. Use this to resolve a brand or product name to a `page_id` you can then feed into /v1/facebook/adLibrary/company/ads.

Authentication

Include x-api-key: <your_key> in your request headers
Requests without a valid key get a 401 Unauthorized. Revoked keys return 403 Forbidden.
Get a key

Parameters

queryRequired
string
Page name to search for.
countryOptional
stringdefault: US
ISO country code biasing results.

Example request

curl "https://mesmer.tools/api/v1/facebook/adLibrary/search/companies?query=Notion&country=US" \
  -H "x-api-key: <YOUR_API_KEY>"

Try it now

Hits the live endpoint with your API key.

Saved locally in your browser. Mint a key in /admin/api-keys.

Response schema

Trimmed example — see Field reference for descriptions.

{
  "success": true,
  "credits_remaining": -1,
  "searchResults": [
    {
      "page_id": "232540286768801",
      "name": "Notion",
      "page_alias": "NotionHQ",
      "category": "Software",
      "country": "US",
      "entity_type": "BUSINESS",
      "image_uri": "https://scontent.fbom29-1.fna.fbcdn.net/...jpg",
      "likes": 412300,
      "page_is_deleted": false,
      "verification": "BLUE_VERIFIED",
      "ig_username": "notionhq",
      "ig_followers": 580200,
      "ig_verification": "BLUE_VERIFIED"
    },
    "...more results"
  ]
}

Field reference

Each searchResults[] entry — the fields you'll most likely use.

page_id
string
Stable Facebook Page id. Pass to /company/ads to list a Page's ads.
name
string
Display name of the Page.
page_alias
string
URL-safe vanity name (`facebook.com/<page_alias>`).
category
string
Facebook's Page category label (e.g. "Software").
country
string
ISO country code of the Page's listed country.
entity_type
string
PERSON | BUSINESS | UNKNOWN.
image_uri
string
Profile picture URL.
likes
number
Page Like count.
ig_username
string
Linked Instagram username, if any.
ig_followers
number
Instagram follower count of the linked IG account.
Previous
Post comments
/v1/reddit/post/comments
Next
Search ads
/v1/facebook/adLibrary/search/ads