Search Facebook ad library companies

Search Facebook Ad Library companies / advertisers by name.

GET/v1/facebook/ad-library/companies/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

Search query text for Facebook ad library companies.

min 1 chars · max 512 chars

Response fields
25

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

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

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

Responses

Company search results for the requested query.