Skip to main content
GET
/
v1
/
scrape
/
facebook-ad-library
/
ad-details
Ad Details
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details \
  --header 'X-API-Key: <api-key>'
{
  "adid": 0,
  "adArchiveID": 702369045530963,
  "archiveTypes": [],
  "categories": [
    0
  ],
  "containsDigitallyCreatedMedia": false,
  "containsSensitiveContent": false,
  "collationCount": null,
  "collationID": null,
  "currency": "",
  "endDate": 1747983600,
  "entityType": "person_profile",
  "fevInfo": null,
  "finServAdData": {
    "is_deemed_finserv": false,
    "is_limited_delivery": false
  },
  "gatedType": "eligible",
  "hasUserReported": false,
  "hiddenSafetyData": false,
  "hideDataStatus": "NONE",
  "impressionsWithIndex": {
    "impressionsText": null,
    "impressionsIndex": -1
  },
  "isAAAEligible": true,
  "isAdAccountActioned": false,
  "isActive": false,
  "isProfilePage": false,
  "pageID": 166258896830103,
  "pageInfo": null,
  "pageIsDeleted": false,
  "pageName": "Porto Montenegro",
  "politicalCountries": [],
  "reachEstimate": null,
  "regionalRegulationData": {
    "finserv": {
      "is_deemed_finserv": false,
      "is_limited_delivery": false
    },
    "tw_anti_scam": {
      "is_limited_delivery": false
    }
  },
  "reportCount": null,
  "snapshot": {
    "ad_creative_id": 1066536401993375,
    "cards": [],
    "body_translations": {},
    "byline": null,
    "caption": "www.portomontenegro.com",
    "cta_text": "Learn more",
    "dynamic_item_flags": {},
    "dynamic_versions": null,
    "edited_snapshots": [],
    "effective_authorization_category": "NONE",
    "event": [],
    "extra_images": [],
    "extra_links": [],
    "extra_texts": [],
    "extra_videos": [],
    "instagram_shopping_products": [],
    "display_format": "video",
    "title": null,
    "link_description": null,
    "link_url": "https://www.portomontenegro.com/attractions-events/boka-place-grand-opening/",
    "page_welcome_message": null,
    "images": [],
    "videos": [
      {
        "video_hd_url": "https://video-lga3-1.xx.fbcdn.net/v/t42.1790-2/491479560_702369072197627_5775200790449116407_n.?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=hwX4c3kvwLsQ7kNvwFl2d_Q&_nc_oc=AdlG8xo51B_VLh8mOjXqjG0Mad3sb7Q-j-8ZZzP-s_j3sHdDkDUJwrrmYd7R9UyfaOA&_nc_zt=28&_nc_ht=video-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfKBmgSKPootHiGNb9xgL2zB15Omax_hVTaa2bzRsjzn_w&oe=6843812F",
        "video_sd_url": "https://video-lga3-1.xx.fbcdn.net/v/t42.1790-2/499448662_702369075530960_5981246750517589666_n.?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=cg4ziP_jjpkQ7kNvwEd7Ymr&_nc_oc=AdlMwa_AeLm6TknZdG_S5L26DNIi_LeoUM_iw58qxM3z4hkKIeJOinIjGuvP4T1zl8I&_nc_zt=28&_nc_ht=video-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfK-DFpMEBShiZb3JUsjv_0EAC7saMqut0dI5fJGTAK8hQ&oe=6843A9D6",
        "watermarked_video_sd_url": "",
        "watermarked_video_hd_url": "",
        "video_preview_image_url": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.35426-6/499149696_1837810423819060_5242520759436861939_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=h-Gc3OVWRsQQ7kNvwENP9GF&_nc_oc=AdnHZtuO7JE08Yptly2LO3_sk-XEiw2Dx_ZHE2FyzV8AY1Y-zm24L3Na7ap1rdpO-f8&_nc_zt=14&_nc_ht=scontent-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfKr3Go0i5YNKCoOfapvk0fO7DxfBFYazfPdNnjbBHnnEA&oe=684381BA"
      }
    ],
    "creation_time": 1747908203,
    "page_id": 598631456674530,
    "page_name": "Porto Montenegro Experience",
    "page_profile_picture_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.35426-6/498588182_739875508369121_8639482247199838788_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CL4JqnVkRzgQ7kNvwEVYWpq&_nc_oc=AdkdPEIQctV4dKggCb8YIFBwzdb5ghgYdYUDAEqQ8mcGtCVOr3QZZ_-kg9lil60EMOg&_nc_zt=14&_nc_ht=scontent-lga3-3.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfIJsuOZfJyoWeHNlOp18Nn7Y1xmM79egJLCXKItT0-qjQ&oe=68439344",
    "page_categories": {
      "197251360301109": "Marina"
    },
    "page_entity_type": "person_profile",
    "page_is_profile_page": false,
    "instagram_actor_name": "Porto Montenegro Experience",
    "instagram_profile_pic_url": "https://scontent-lga3-2.xx.fbcdn.net/v/t39.35426-6/499922917_1078294804160843_5583552140592065526_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=EWHzIxDAk20Q7kNvwFgPQrS&_nc_oc=AdmbvB4ypz9F2BrlQ7FcUMcvfR5JvoCggHJ1a4Ntu3ZXQ8KoiUCOTCYzvZ1z6gYiIJo&_nc_zt=14&_nc_ht=scontent-lga3-2.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfJd0SOIGy12aEqb4GS4Kz86YOdg3NpQ5OL9W-RRnBHPBQ&oe=6843A343",
    "instagram_url": "",
    "instagram_handle": "",
    "is_reshared": false,
    "version": 3,
    "body": "Reflections ripple, light gathers,<br /> and tomorrow brings a new rhythm to the square. <br /> <br /> One day until the Grand Opening of Boka Place.",
    "brazil_tax_id": null,
    "branded_content": {
      "page_id": 166258896830103,
      "page_name": "Porto Montenegro",
      "page_profile_picture_url": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.35426-6/499920502_2382687582132053_334434608727983440_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=zJEq2b_i4xwQ7kNvwEhuat_&_nc_oc=AdnryrPnSzR5YCB7wO-EVqpswUJ2l8xDDXiCjJN6b4rhZJ2c8809t5QTDa7OwUq9ueU&_nc_zt=14&_nc_ht=scontent-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfLZibsXYNxUNvp9LT4tOJWbf-3uFIkWN4e5ke-s5FqGdw&oe=68438B15",
      "page_categories": {
        "197251360301109": "Marina"
      },
      "current_page_name": "Porto Montenegro",
      "page_profile_uri": "https://www.facebook.com/portomontenegrotivat/",
      "page_is_deleted": false
    },
    "current_page_name": "Porto Montenegro Experience",
    "disclaimer_label": null,
    "page_like_count": 1,
    "page_profile_uri": "https://www.facebook.com/61575286107814/",
    "page_is_deleted": false,
    "root_reshared_post": null,
    "cta_type": "LEARN_MORE",
    "additional_info": null,
    "ec_certificates": null,
    "country_iso_code": null,
    "instagram_branded_content": {
      "instagram_bc_sponsor_id": "17841400741682419",
      "instagram_bc_sponsor_name": "porto_montenegro"
    }
  },
  "spend": null,
  "startDate": 1747897200,
  "stateMediaRunLabel": null,
  "publisherPlatform": [
    "facebook",
    "instagram",
    "audience_network"
  ],
  "menuItems": [],
  "targetedOrReachedCountries": [],
  "totalActiveTime": 41782,
  "url": "https://www.facebook.com/ads/library?id=702369045530963",
  "startDateString": "2025-05-22T07:00:00.000Z",
  "endDateString": "2025-05-23T07:00:00.000Z",
  "aaa_info": {
    "targets_eu": true,
    "location_audience": [
      {
        "name": "Dubrovnik, Croatia",
        "num_obfuscated": 0,
        "type": "CITY",
        "excluded": false
      }
    ],
    "gender_audience": "All",
    "age_audience": {
      "min": 18,
      "max": 65
    },
    "eu_total_reach": 1657,
    "age_country_gender_reach_breakdown": [
      {
        "country": "HR",
        "age_gender_breakdowns": [
          {
            "age_range": "45-54",
            "male": 101,
            "female": 77,
            "unknown": 4
          },
          {
            "age_range": "55-64",
            "male": 55,
            "female": 55,
            "unknown": 1
          },
          {
            "age_range": "65+",
            "male": 37,
            "female": 29,
            "unknown": null
          },
          {
            "age_range": "18-24",
            "male": 161,
            "female": 152,
            "unknown": 7
          },
          {
            "age_range": "25-34",
            "male": 374,
            "female": 238,
            "unknown": 8
          },
          {
            "age_range": "35-44",
            "male": 196,
            "female": 133,
            "unknown": 5
          }
        ]
      }
    ],
    "payer_beneficiary_data": [
      {
        "payer": "Porto Montenegro",
        "beneficiary": "Porto Montenegro"
      }
    ],
    "has_violating_payer_beneficiary": false,
    "is_ad_taken_down": false
  }
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
id
string
required

Facebook Ad Id

Example:

"702369045530963"

​
get_transcript
boolean

Get the transcript of the ad. This is a new feature, so let me know if its not working how you expected.

Example:

false

​
trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

Key Response Fields:

  • adArchiveID: This is the ad id. You'd think it'd be 'adid', but facebook decided to make it confusing 🤦‍♂️
​
adid
integer
required
Example:

0

​
adArchiveID
integer
required
Example:

702369045530963

​
archiveTypes
any[]
required
​
categories
integer[]
required
​
containsDigitallyCreatedMedia
boolean
required
Example:

false

​
containsSensitiveContent
boolean
required
Example:

false

​
currency
string
required
Example:

""

​
endDate
integer
required
Example:

1747983600

​
entityType
string
required
Example:

"person_profile"

​
finServAdData
object
required
​
gatedType
string
required
Example:

"eligible"

​
hasUserReported
boolean
required
Example:

false

​
hiddenSafetyData
boolean
required
Example:

false

​
hideDataStatus
string
required
Example:

"NONE"

​
impressionsWithIndex
object
required
​
isAAAEligible
boolean
required
Example:

true

​
isAdAccountActioned
boolean
required
Example:

false

​
isActive
boolean
required
Example:

false

​
isProfilePage
boolean
required
Example:

false

​
pageID
integer
required
Example:

166258896830103

​
pageIsDeleted
boolean
required
Example:

false

​
pageName
string
required
Example:

"Porto Montenegro"

​
politicalCountries
any[]
required
​
regionalRegulationData
object
required
​
snapshot
object
required
​
startDate
integer
required
Example:

1747897200

​
publisherPlatform
string[]
required
​
menuItems
any[]
required
​
targetedOrReachedCountries
any[]
required
​
totalActiveTime
integer
required
Example:

41782

​
url
string
required
Example:

"https://www.facebook.com/ads/library?id=702369045530963"

​
startDateString
string
required
Example:

"2025-05-22T07:00:00.000Z"

​
endDateString
string
required
Example:

"2025-05-23T07:00:00.000Z"

​
aaa_info
object
required
​
collationCount
null
​
collationID
null
​
fevInfo
null
​
pageInfo
null
​
reachEstimate
null
​
reportCount
null
​
spend
null
​
stateMediaRunLabel
null