View raw JSON
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"title": "Input schema for the empty project actor.",
"required": [
"startUrls"
],
"properties": {
"startUrls": {
"type": "array",
"title": "Facebook URLs",
"editor": "requestListSources",
"example": [
{
"url": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl"
}
],
"prefill": [
{
"url": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl"
}
],
"description": "Required list of selected Facebook post URLs, supplied as request-list entries with a url property. Post targets can include regular, image, video or reel posts; the prefilled link is an example."
},
"viewOption": {
"enum": [
"RANKED_THREADED",
"RECENT_ACTIVITY",
"RANKED_UNFILTERED"
],
"type": "string",
"title": "Comments mode",
"editor": "select",
"default": "RANKED_UNFILTERED",
"example": "RANKED_UNFILTERED",
"enumTitles": [
"Most relevant",
"Newest",
"All"
],
"description": "Optional view: RANKED_THREADED for Most relevant, RECENT_ACTIVITY for Newest, or RANKED_UNFILTERED for All/unfiltered, which is the default. All does not guarantee all comments. A date filter forces RECENT_ACTIVITY."
},
"resultsLimit": {
"type": "integer",
"title": "Results amount",
"editor": "number",
"example": 50,
"minimum": 1,
"prefill": 50,
"description": "Optional integer of at least 1. If omitted, collection requests as many results as possible. The prefilled 50 is not a default. Nested replies can exceed the requested amount, so this is not a strict total."
},
"includeNestedComments": {
"type": "boolean",
"title": "Include comment replies",
"editor": "checkbox",
"default": false,
"example": false,
"description": "Optional, false by default. Enabling it requests up to three levels of comments and replies per post; each available comment or reply is returned as a separate result. It does not guarantee a complete thread."
},
"onlyCommentsNewerThan": {
"type": "string",
"title": "📅 Extract comments that are newer than",
"editor": "datepicker",
"example": "2024-01-01",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
"dateType": "absoluteOrRelative",
"description": "Optional UTC publication-time filter requesting comments newer than an absolute YYYY-MM-DD or ISO date-time, or within a relative period in minutes, hours, days, weeks, months or years. It forces RECENT_ACTIVITY and can add a charge. The example date is not a default.",
"sectionCaption": "Time frame",
"sectionDescription": "Use this if you only want to scrape comments from a specific period of time."
}
},
"description": "Required request object containing the selected Facebook post list and optional comment view, requested amount, nested-reply and date settings.",
"schemaVersion": 1
}
},
"additionalProperties": false
}