Search for Companies
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"searchResults": {
"0": {
"page_id": "33693527731",
"category": "Clothing (Brand)",
"image_uri": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.30808-1/462706481_931553435664825_1534082515114296213_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=zGq4SzdNLogQ7kNvwGrjg-R&_nc_oc=AdlDEnIkMwc3w9yq-Fqt6waOlZ5pFUKT6Mu2SzuHF0A4GPNmtkuhtcTChwcdh7fZAR0&_nc_zt=24&_nc_ht=scontent-sea1-1.xx&_nc_gid=gSVIaGqsybhf6jC_M7Hslw&oh=00_AfsC6-cazbSy94aQiX4JWoVbwSJE5i-F6F3NAYjj0ZekBg&oe=698EEF17",
"likes": 3444605,
"verification": "BLUE_VERIFIED",
"name": "lululemon",
"country": null,
"entity_type": "PERSON_PROFILE",
"ig_username": "lululemon",
"ig_followers": 5437603,
"ig_verification": true,
"page_alias": "lululemon",
"page_is_deleted": false
}
}
},
"credits_used": 1
}{
"error": "Missing required parameter: handle",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}Facebook Ad Library
Search for Companies
Search for companies by name and get their ad library page id
GET
/
v1
/
scrape
/
facebook-ad-library
/
search-companies
Search for Companies
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/search-companies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"searchResults": {
"0": {
"page_id": "33693527731",
"category": "Clothing (Brand)",
"image_uri": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.30808-1/462706481_931553435664825_1534082515114296213_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=zGq4SzdNLogQ7kNvwGrjg-R&_nc_oc=AdlDEnIkMwc3w9yq-Fqt6waOlZ5pFUKT6Mu2SzuHF0A4GPNmtkuhtcTChwcdh7fZAR0&_nc_zt=24&_nc_ht=scontent-sea1-1.xx&_nc_gid=gSVIaGqsybhf6jC_M7Hslw&oh=00_AfsC6-cazbSy94aQiX4JWoVbwSJE5i-F6F3NAYjj0ZekBg&oe=698EEF17",
"likes": 3444605,
"verification": "BLUE_VERIFIED",
"name": "lululemon",
"country": null,
"entity_type": "PERSON_PROFILE",
"ig_username": "lululemon",
"ig_followers": 5437603,
"ig_verification": true,
"page_alias": "lululemon",
"page_is_deleted": false
}
}
},
"credits_used": 1
}{
"error": "Missing required parameter: handle",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}💳 1 credit per request
Authorizations
Query Parameters
Keyword to search for
Example:
"nike"
Response
Successful response
Key Response Fields:
data.searchResults[0].page_id: The company's ad library page ID — use this with the Company Ads endpointdata.searchResults[0].name: Company display namedata.searchResults[0].category: Facebook page categorydata.searchResults[0].image_uri: Company logo/profile image URLdata.searchResults[0].likes: Total Facebook page likesdata.searchResults[0].verification: Verification status (e.g.,"BLUE_VERIFIED")data.searchResults[0].ig_username: Associated Instagram usernamedata.searchResults[0].ig_followers: Instagram follower countdata.searchResults[0].ig_verification: Whether the Instagram account is verifieddata.searchResults[0].entity_type: Facebook entity type (e.g.,"PERSON_PROFILE")