Social Fetch
Facebook

Search Facebook ad library companies

Search Facebook ad library companies by name.

GET/v1/facebook/ad-library/companies/search
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
query*stringquery

Search query text for Facebook ad library companies.

min 1 chars · max 512 chars

Response fields
23

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Companies returned for the search query.

datacompanies[]platform
string

Social platform for this company result.

one of: facebook

datacompanies[]pageId
string

Facebook page id for use with other ad library endpoints.

min 1 chars

datacompanies[]name
string

Company or page name.

min 1 chars

datacompanies[]category
stringnullable

Page category label when available.

datacompanies[]imageUrl
stringnullable

Profile image URL when available.

datacompanies[]likes
integernullable

Page like count when available.

≥ 0

datacompanies[]verification
stringnullable

Verification status label when available.

datacompanies[]country
stringnullable

Country associated with the page when available.

datacompanies[]entityType
stringnullable

Entity type reported for the page when available.

datacompanies[]pageAlias
stringnullable

Public page alias or username when available.

datacompanies[]pageDeleted
booleannullable

Whether the page is marked as deleted when reported.

Linked Instagram details when available.

datacompanies[]instagramusername
stringnullable

Linked Instagram username when available.

datacompanies[]instagramfollowers
integernullable

Linked Instagram follower count when available.

≥ 0

datacompanies[]instagramverified
booleannullable

Whether the linked Instagram account is verified.

datatotalCompanies
integer

Number of companies returned in this response.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/facebook/ad-library/companies/search?query=value" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Company search results for the requested query.

On this page

No Headings