Facebook

Company search

Advertisers in Meta's Ad Library by name, with the Page id the company ads endpoint takes: up to 15.

GET/v1/facebook/ad-library/companies/search1 credit

Headers

Get your API key

x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

query*stringrequiredquery

Words to search for.

min 1 chars · max 200 chars · example: nike

Response fields

dataarray

The result: one object, or a list for the endpoints that return several.

data[].page_idstring

The advertiser's Page id: the company ads endpoint takes it.

data[].namestringnullable

Its name.

data[].handlestringnullable

The part of its link after facebook.com/.

data[].categorystringnullable

Its category.

data[].likesintegernullable

Its Page's likes.

data[].verifiedbooleannullable

Whether Facebook shows its badge.

data[].picturestringnullable

Its picture's link.

data[].instagram_handlestringnullable

Its Instagram account, where it has one.

data[].instagram_followersintegernullable

Its Instagram account's followers.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/facebook/ad-library/companies/search?query=nike' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": [    {      "page_id": "string",      "name": "string",      "handle": "string",      "category": "string",      "likes": 0,      "verified": true,      "picture": "string",      "instagram_handle": "string",      "instagram_followers": 0    }  ],  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}

Company ads

An advertiser's ads in Meta's Ad Library, about 10 a page.

Profile

A profile's card: name, bio, links, followers, following and post count. A private account's card too, with private true.