{
  "openapi": "3.0.1",
  "info": {
    "title": "Facebook Post Scraper: Reactions and Shares by URL",
    "description": "Scrape public Facebook posts by URL without a login: paste post, photo, video, reel, group or share links and get reactions by type, comments, shares, exact video plays, text, author, media and link preview. Free rows for dead links, change tracking for re-checks. Pay per post.",
    "version": "0.1",
    "x-build-id": "MdJ1qo8CTphsga1YB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/automation_craft~facebook-post-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-automation_craft-facebook-post-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/automation_craft~facebook-post-scraper/runs": {
      "post": {
        "operationId": "runs-sync-automation_craft-facebook-post-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/automation_craft~facebook-post-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-automation_craft-facebook-post-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "postUrls": {
            "title": "Post links",
            "type": "array",
            "description": "Links of public Facebook posts: page and profile posts (number or pfbid links), photos (/photo/?fbid=, photo.php, /<page>/photos/), videos (/videos/, /watch/?v=), reels (/reel/), public group posts (/groups/<group>/posts/ or /permalink/), permalink.php and story.php links, share links (/share/p/, /share/r/, /share/v/), fb.watch and m.facebook.com links. Up to 5,000 links. Page, profile and group home links are not read (a free row says so).",
            "items": {
              "type": "string"
            }
          },
          "maxPosts": {
            "title": "Most posts in this run",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Stop after this many posts were delivered. Links not read get one free row that lists them. Empty: every link is read, within your charge limit and the run's allowance of unpaid work (pages that bill nothing, such as dead links, are bounded per run; a free row lists any link it stops before)."
          },
          "postedAfter": {
            "title": "Only posts created after",
            "type": "string",
            "description": "Deliver only posts created on or after this time (UTC): YYYY-MM-DD (from 00:00), YYYY-MM-DD HH:MM or YYYY-MM-DDTHH:MM (seconds and a closing Z or +00:00 allowed, UTC only), today, yesterday, or a time back from the run's start such as \"7 days\", \"2 weeks\", \"3 months\" or \"12 hours\". An older post gets a free row instead of its row (it is read, not charged)."
          },
          "postedBefore": {
            "title": "Only posts created before",
            "type": "string",
            "description": "Deliver only posts created on or before this time (UTC), in the same forms as above (YYYY-MM-DD to 23:59:59). A newer post gets a free row instead of its row (it is read, not charged)."
          },
          "includeTopComments": {
            "title": "Include the top comments the post shows",
            "type": "boolean",
            "description": "Add the comments the post's own page shows to a logged out visitor (usually up to 10, with text, author, time, reactions and reply count) to each row, at no extra charge. Videos and reels show none. Empty: off."
          },
          "includeTranscript": {
            "title": "Include video captions (transcript)",
            "type": "boolean",
            "description": "For videos and reels that carry Facebook's own captions, add their text as the transcript (one more small download per video, no extra charge). A video without captions says so in transcriptStatus; no speech is transcribed. Empty: off."
          },
          "includeAuthorDetails": {
            "title": "Include author follower counts",
            "type": "boolean",
            "description": "Add the author's follower count as Facebook shows it (rounded, for example 28M), the verified mark and the category where shown, read once per author per run from the author's page embed (no extra charge). Empty: off."
          },
          "includeAllPhotos": {
            "title": "Read every photo of a post",
            "type": "boolean",
            "description": "A post page shows its first five photos. When a post has more, read its photo set too (one more page for that post only, no extra charge) so photos holds every photo and video Facebook shows; mediaTotal and photosComplete say how many the post has and whether all came. Empty: on."
          },
          "reelShareCount": {
            "title": "Read reel share counts",
            "type": "boolean",
            "description": "Reels are read from their video page (exact plays, reactions by type) and then from their reel page for the share count, which Facebook shows rounded on larger reels (shareCountIsExact says so). Turn off to skip the second page: the reel row then has no share count. Empty: on."
          },
          "memoryName": {
            "title": "Change tracking: memory name",
            "type": "string",
            "description": "Name a watch list (for example \"campaign october\"). Each run then adds the figures of the last run that read the same post under this name (previous) and the difference (change), so a scheduled run shows how reactions, comments, shares and plays moved. Every post read is still a Post. A memory belongs to this Actor and your account."
          },
          "resetMemory": {
            "title": "Reset the memory",
            "type": "boolean",
            "description": "Forget the figures kept under the memory name before this run (no post then has previous figures). Empty: off."
          },
          "maxConcurrency": {
            "title": "Posts read at once",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "How many links are read at the same time (each on its own address). Empty: 4."
          },
          "proxyUrls": {
            "title": "Your own proxies",
            "type": "string",
            "description": "Optional: your own proxy addresses, one per line, as http://user:password@host:port, used instead of the Apify datacenter pool this Actor uses on its own. Up to 50."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}