Social Fetch
Facebook

Search Facebook ad library companies

Search Facebook ad library companies by name.

Operation

GET/v1/facebook/ad-library/companies/search
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

querystringrequired(query)

Search query text for Facebook ad library companies.

min 1 chars · max 512 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

dataquery
stringrequired

Search query that was evaluated for this response.

datacompanies
arrayrequired

Companies returned for the search query.

datacompanies[]platform
stringrequired

Social platform for this company result.

one of: facebook

datacompanies[]pageId
stringrequired

Facebook page id for use with other ad library endpoints.

min 1 chars

datacompanies[]name
stringrequired

Company or page name.

min 1 chars

datacompanies[]category
stringrequirednullable

Page category label when available.

datacompanies[]imageUrl
stringrequirednullable

Profile image URL when available.

datacompanies[]likes
integerrequirednullable

Page like count when available.

≥ 0

datacompanies[]verification
stringrequirednullable

Verification status label when available.

datacompanies[]country
stringrequirednullable

Country associated with the page when available.

datacompanies[]entityType
stringrequirednullable

Entity type reported for the page when available.

datacompanies[]pageAlias
stringrequirednullable

Public page alias or username when available.

datacompanies[]pageDeleted
booleanrequirednullable

Whether the page is marked as deleted when reported.

datacompanies[]instagram
objectrequired

Linked Instagram details when available.

datacompanies[]instagramusername
stringrequirednullable

Linked Instagram username when available.

datacompanies[]instagramfollowers
integerrequirednullable

Linked Instagram follower count when available.

≥ 0

datacompanies[]instagramverified
booleanrequirednullable

Whether the linked Instagram account is verified.

datatotalCompanies
integerrequired

Number of companies returned in this response.

≥ 0

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Company search results for the requested query.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page