Facebook Scraper

Get Facebook Ad Library Ad Details

Get a Facebook ad's details from its ID or URL: page, active status, run dates, text, images, videos and link.

1 creditNo API key needed

Endpoint

Parameters

NameTypeRequiredNote
idstring · optionalstringoptional

Facebook Ad Id

urlstring · optionalstringoptional

Facebook Ad URL

trimboolean · optionalbooleanoptional

Set to true for a trimmed down version of the response

cache_max_agestring · optionalstringoptional

See the Caching page for details.

One of: 1d, 3d, 7d, 14d, 30d

get_transcriptboolean · optionalbooleanoptional

Transcription is opt-in via get_transcript=true. Over 120 seconds, videos cannot be AI-transcribed by default. These routes remain synchronous. Allow at least 30 seconds on your client.

Response schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "pageID": {
      "type": "number"
    },
    "endDate": {
      "type": "number"
    },
    "isActive": {
      "type": "boolean"
    },
    "pageName": {
      "type": "string"
    },
    "snapshot": {
      "type": "object",
      "additionalProperties": {}
    },
    "adArchiveID": {
      "type": "number"
    },
    "isAAAEligible": {
      "type": "boolean"
    },
    "reachEstimate": {},
    "totalActiveTime": {
      "type": "number"
    },
    "politicalCountries": {
      "type": "array"
    }
  },
  "additionalProperties": true
}

Get started

How to use this tool

  1. Connect your AI

    Add Connie to ChatGPT, Claude or Slack once, and this tool comes with it. There’s no API key or account to set up.

  2. Ask for the outcome

    Describe what you need in plain words. Your AI runs this tool when the job calls for it, along with any others it needs.

  3. Make it a workflow

    Add it as a step in a workflow that runs the same way every time, on a schedule or when something happens.

  4. Stay in control

    Choose whether it runs on its own or asks first. When it asks, you see an Allow or Deny card before any credits are spent.