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 group URLs",
"editor": "requestListSources",
"example": [
{
"url": "https://www.facebook.com/groups/874728723021553"
}
],
"prefill": [
{
"url": "https://www.facebook.com/groups/874728723021553"
}
],
"description": "Required list of selected public Facebook group URLs, supplied as entries containing url. The prefilled group is an example, not a default. Access and visible posts can change; private groups are unsupported."
},
"viewOption": {
"enum": [
"CHRONOLOGICAL",
"RECENT_ACTIVITY",
"TOP_POSTS",
"CHRONOLOGICAL_LISTINGS"
],
"type": "string",
"title": "📜 Sorting order",
"editor": "select",
"default": "CHRONOLOGICAL",
"example": "CHRONOLOGICAL",
"prefill": "CHRONOLOGICAL",
"enumTitles": [
"New posts",
"Newest activity",
"Most relevant",
"BuySell items"
],
"description": "Default CHRONOLOGICAL (New posts). RECENT_ACTIVITY follows newest activity, not necessarily new publication; TOP_POSTS follows source relevance; CHRONOLOGICAL_LISTINGS works only for BuySell groups. resultsLimit applies only to CHRONOLOGICAL."
},
"resultsLimit": {
"type": "integer",
"title": "✍️ Number of posts",
"editor": "number",
"example": 20,
"minimum": 1,
"prefill": 20,
"description": "Optional integer of at least 1, used only with New posts. There is no default; the prefilled 20 is an example. Omitting it requests as many accessible posts as possible, not complete coverage. Other sorting modes do not have a reliable count limit from this setting."
},
"searchGroupYear": {
"type": "string",
"title": "🗓 Search keyword by year",
"editor": "textfield",
"example": "2024",
"description": "Optional year used together with searchGroupKeyword, not a standalone year filter. Search coverage is limited and the year restriction may not take effect; check returned publication times rather than assuming complete yearly coverage. There is no default."
},
"onlyPostsNewerThan": {
"type": "string",
"title": "Posts 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 publication-time lower bound toward the present, with no default. Accepts YYYY-MM-DD, full or partial ISO timestamps, or relative periods such as 1 hour or 2 months; timestamps use UTC. It does not guarantee complete coverage or exact inclusion at the boundary, and does not filter by post edits or engagement time.",
"sectionCaption": "Time frame",
"sectionDescription": "Use this if you only want to scrape posts from a specific period of time."
},
"searchGroupKeyword": {
"type": "string",
"title": "Search by letter (words are allowed, but will not return any results in most cases)",
"editor": "textfield",
"example": "a",
"description": "Optional letter or keyword search with very limited coverage without sign-in. Whole words may yield no results; one or two letters are possible search choices, not guaranteed matches. Current filtering effectiveness and complete keyword coverage are not guaranteed. Check the returned text."
}
},
"description": "Required request object containing the selected public group URLs and optional sorting, count, publication-time or limited search choices. It retrieves accessible posts and any supplied top-comment context; it does not request private access or a member list.",
"schemaVersion": 1
}
},
"additionalProperties": false
}