Facebook Page Photo Gallery & Engagement Scraper

{
  "description": "Collect public Facebook photos from a page, profile, album, photo permalink, tagged collection, or albums list.",
  "properties": {
    "includeAlbums": {
      "default": false,
      "description": "For page and profile URLs, also walk every album listed on the page's Albums tab and collect its photos. A photos_albums URL implies this automatically.",
      "prefill": false,
      "title": "Also collect albums",
      "type": "boolean"
    },
    "includeDetails": {
      "default": true,
      "description": "Open each photo to add its caption, timestamp, reactions, comments, shares, tagged people, owner, album, and post link. Turn off for a fast grid-only export; album date bounds still read only the timestamp needed for filtering.",
      "prefill": true,
      "title": "Include photo details",
      "type": "boolean"
    },
    "newerThan": {
      "description": "Only include photos posted on or after this date (YYYY-MM-DD). Applied by Facebook for page and tagged tabs. For albums the actor reads each photo timestamp (even with includeDetails off) and applies the bound; rows stay grid-only.",
      "editor": "textfield",
      "prefill": "",
      "title": "Only photos newer than",
      "type": "string"
    },
    "olderThan": {
      "description": "Only include photos posted on or before this date (YYYY-MM-DD). Applied by Facebook for page and tagged tabs. For albums the actor reads each photo timestamp (even with includeDetails off) and applies the bound; rows stay grid-only.",
      "editor": "textfield",
      "prefill": "",
      "title": "Only photos older than",
      "type": "string"
    },
    "photoTab": {
      "default": "uploaded",
      "description": "For page and profile URLs: photos uploaded by the page, or photos where the page is tagged by others. Ignored for album and photo URLs.",
      "editor": "select",
      "enum": [
        "uploaded",
        "tagged"
      ],
      "enumTitles": [
        "Photos uploaded by the page",
        "Photos the page is tagged in"
      ],
      "prefill": "uploaded",
      "title": "Photo tab",
      "type": "string"
    },
    "resultsLimit": {
      "default": 100,
      "description": "Global cap across all Start URLs. The actor keeps paginating until this many photos are collected or the source runs out.",
      "editor": "number",
      "minimum": 1,
      "prefill": 1,
      "title": "Maximum number of photos",
      "type": "integer"
    },
    "startUrls": {
      "description": "Facebook page, profile, photos tab, tagged tab, albums tab, album, or single-photo URL. Bare handles such as nasa are accepted too.",
      "editor": "requestListSources",
      "items": {
        "properties": {
          "url": {
            "description": "Facebook page, profile, photo album, photos tab, tagged tab, or photo permalink.",
            "title": "URL of a web page",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "prefill": [
        {
          "url": "https://www.facebook.com/humansofnewyork/photos"
        }
      ],
      "title": "Facebook URLs",
      "type": "array"
    },
    "storeImages": {
      "default": true,
      "description": "Copy each full-size image and thumbnail to Apify storage and return non-expiring URLs. The signed Facebook originals and their expiry are kept in the record.",
      "prefill": true,
      "title": "Store images permanently",
      "type": "boolean"
    }
  },
  "required": [
    "startUrls"
  ],
  "schemaVersion": 1,
  "title": "Facebook Photos Scraper Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "One row per public Facebook photo with image and thumbnail links, caption, timestamp, reaction breakdown, comments, shares, tagged people, owner/page/album/post context, and source metadata.",
  "properties": {
    "photos": {
      "description": "Dataset of public Facebook photos with engagement and context fields. Empty fields are omitted.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Facebook Photo Data",
      "type": "string"
    }
  },
  "title": "Facebook Page Photo Gallery & Engagement Scraper Output"
}

{
  "actorSpecification": 1,
  "title": "Facebook Photos Data",
  "views": {
    "detailed": {
      "display": {
        "component": "table",
        "properties": {
          "albumId": {
            "format": "text",
            "label": "Album ID"
          },
          "albumName": {
            "format": "text",
            "label": "Album"
          },
          "altText": {
            "format": "text",
            "label": "Alt text"
          },
          "angryCount": {
            "format": "number",
            "label": "Angry"
          },
          "authorName": {
            "format": "text",
            "label": "Author"
          },
          "authorUrl": {
            "format": "link",
            "label": "Author URL"
          },
          "caption": {
            "format": "text",
            "label": "Caption"
          },
          "careCount": {
            "format": "number",
            "label": "Care"
          },
          "commentsCount": {
            "format": "number",
            "label": "Comments"
          },
          "createdTime": {
            "format": "number",
            "label": "Created (Unix)"
          },
          "detailsStatus": {
            "format": "text",
            "label": "Details"
          },
          "hahaCount": {
            "format": "number",
            "label": "Haha"
          },
          "imageExpiresAt": {
            "format": "text",
            "label": "Image expires"
          },
          "imageHeight": {
            "format": "number",
            "label": "Height"
          },
          "imageUrl": {
            "format": "link",
            "label": "Image"
          },
          "imageUrlOriginal": {
            "format": "link",
            "label": "Image (original)"
          },
          "imageWidth": {
            "format": "number",
            "label": "Width"
          },
          "inputUrl": {
            "format": "link",
            "label": "Input URL"
          },
          "likeCount": {
            "format": "number",
            "label": "Like"
          },
          "likesCount": {
            "format": "number",
            "label": "Reactions total"
          },
          "loveCount": {
            "format": "number",
            "label": "Love"
          },
          "ocrText": {
            "format": "text",
            "label": "OCR text (alt text)"
          },
          "pageFollowers": {
            "format": "number",
            "label": "Page followers"
          },
          "pageId": {
            "format": "text",
            "label": "Page ID"
          },
          "pageName": {
            "format": "text",
            "label": "Page"
          },
          "pageUrl": {
            "format": "link",
            "label": "Page URL"
          },
          "photoId": {
            "format": "text",
            "label": "Photo ID"
          },
          "photoUrl": {
            "format": "link",
            "label": "Photo URL"
          },
          "postId": {
            "format": "text",
            "label": "Post ID"
          },
          "postUrl": {
            "format": "link",
            "label": "Post URL"
          },
          "reactionsByType": {
            "format": "object",
            "label": "Reactions by type"
          },
          "reactionsTotal": {
            "format": "number",
            "label": "Reactions"
          },
          "sadCount": {
            "format": "number",
            "label": "Sad"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped at"
          },
          "shareCount": {
            "format": "number",
            "label": "Shares"
          },
          "sourceType": {
            "format": "text",
            "label": "Source"
          },
          "taggedPeople": {
            "format": "array",
            "label": "Tagged people"
          },
          "thumbnailUrl": {
            "format": "link",
            "label": "Thumbnail"
          },
          "thumbnailUrlOriginal": {
            "format": "link",
            "label": "Thumbnail (original)"
          },
          "timestamp": {
            "format": "text",
            "label": "Posted"
          },
          "uploaderId": {
            "format": "text",
            "label": "Uploader ID"
          },
          "uploaderName": {
            "format": "text",
            "label": "Uploader"
          },
          "uploaderUrl": {
            "format": "link",
            "label": "Uploader URL"
          },
          "wowCount": {
            "format": "number",
            "label": "Wow"
          }
        }
      },
      "title": "Detailed",
      "transformation": {
        "fields": [
          "photoId",
          "photoUrl",
          "imageUrl",
          "imageUrlOriginal",
          "imageExpiresAt",
          "imageWidth",
          "imageHeight",
          "thumbnailUrl",
          "thumbnailUrlOriginal",
          "caption",
          "altText",
          "ocrText",
          "createdTime",
          "timestamp",
          "likesCount",
          "likeCount",
          "loveCount",
          "careCount",
          "hahaCount",
          "wowCount",
          "sadCount",
          "angryCount",
          "reactionsByType",
          "reactionsTotal",
          "commentsCount",
          "shareCount",
          "taggedPeople",
          "authorName",
          "authorUrl",
          "uploaderId",
          "uploaderName",
          "uploaderUrl",
          "pageId",
          "pageName",
          "pageUrl",
          "pageFollowers",
          "albumId",
          "albumName",
          "postId",
          "postUrl",
          "sourceType",
          "detailsStatus",
          "inputUrl",
          "scrapedAt"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "caption": {
            "format": "text",
            "label": "Caption"
          },
          "commentsCount": {
            "format": "number",
            "label": "Comments"
          },
          "imageUrl": {
            "format": "link",
            "label": "Image"
          },
          "pageName": {
            "format": "text",
            "label": "Page"
          },
          "photoId": {
            "format": "text",
            "label": "Photo ID"
          },
          "photoUrl": {
            "format": "link",
            "label": "Photo URL"
          },
          "reactionsTotal": {
            "format": "number",
            "label": "Reactions"
          },
          "shareCount": {
            "format": "number",
            "label": "Shares"
          },
          "thumbnailUrl": {
            "format": "link",
            "label": "Thumbnail"
          },
          "timestamp": {
            "format": "text",
            "label": "Posted"
          }
        }
      },
      "title": "Overview",
      "transformation": {
        "fields": [
          "photoId",
          "photoUrl",
          "imageUrl",
          "thumbnailUrl",
          "caption",
          "pageName",
          "timestamp",
          "reactionsTotal",
          "commentsCount",
          "shareCount"
        ]
      }
    }
  }
}