{
  "openapi": "3.0.1",
  "info": {
    "title": "Facebook Scraper & API | EveryInfra",
    "description": "Unofficial Facebook data via one Actor: search, profile, user_posts, post, comments, followers, ads, group_posts, marketplace, reviews, advertiser_search, ad_detail, events_search, marketplace_item and 2 more. Pay per request, no start fee. First 3 requests free across EveryInfra Actors.",
    "version": "0.1",
    "x-build-id": "diroLlZPH598Pj5zj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blushing_parachute~everyinfra-facebook-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blushing_parachute-everyinfra-facebook-api",
        "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/blushing_parachute~everyinfra-facebook-api/runs": {
      "post": {
        "operationId": "runs-sync-blushing_parachute-everyinfra-facebook-api",
        "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/blushing_parachute~everyinfra-facebook-api/run-sync": {
      "post": {
        "operationId": "run-sync-blushing_parachute-everyinfra-facebook-api",
        "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",
        "required": [
          "action"
        ],
        "properties": {
          "action": {
            "title": "Action",
            "enum": [
              "search",
              "profile",
              "user_posts",
              "post",
              "comments",
              "followers",
              "ads",
              "group_posts",
              "marketplace",
              "reviews",
              "advertiser_search",
              "ad_detail",
              "events_search",
              "marketplace_item",
              "page_events",
              "post_transcript"
            ],
            "type": "string",
            "description": "What to fetch. Each action uses only the fields listed for it below; other fields are ignored when empty.",
            "default": "search"
          },
          "keyword": {
            "title": "keyword",
            "type": "string",
            "description": "Used by `search` (required), `ads` (required), `marketplace` (required), `advertiser_search` (required), `events_search` (required). Specifies the search query for distinct platform endpoints. For search, it searches public posts; for ads, it accepts ad keywords or direct Ad Library and Page URLs; for marketplace, it accepts item search terms or complete Marketplace search URLs. Each action queries a different dataset rather than returning the same results under different field names."
          },
          "content_type": {
            "title": "content_type",
            "enum": [
              "latest",
              "most_popular"
            ],
            "type": "string",
            "description": "Used by `search`. Sorts results for the search action using allowed values latest for newer posts or most_popular for popular posts. Despite its name, content_type acts as a sorting dimension and does not filter by media format, such as images or videos."
          },
          "since": {
            "title": "since",
            "type": "string",
            "description": "Used by `search`. Filters post publication dates for the search action from this start date, recommended in YYYY-MM-DD format. Combined with until, it forms the query date range; it does not filter ad run times or comment creation times."
          },
          "until": {
            "title": "until",
            "type": "string",
            "description": "Used by `search`. Filters post publication dates for the search action up to this end date, recommended in YYYY-MM-DD format. Combined with since, it forms the query date range; it does not control ad expiration dates."
          },
          "url": {
            "title": "url",
            "type": "string",
            "description": "Used by `profile` (required), `user_posts` (required), `post` (required), `comments` (required), `group_posts` (required), `reviews` (required), `ad_detail` (required), `marketplace_item` (required), `page_events` (required), `post_transcript` (required). Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions."
          },
          "username": {
            "title": "username",
            "type": "string",
            "description": "Used by `followers` (required). Specifies the Facebook account or Page identifier without an @ symbol for the followers action. This capability returns a total follower count object rather than an exported list of individual follower profiles or a user relationship graph."
          },
          "channel": {
            "title": "channel",
            "type": "string",
            "description": "Used by `followers`. This parameter is used for compatibility with the account identifier in the followers action. If username is supplied, it takes precedence, and public requests must still include the required username parameter. This parameter does not represent a chat channel ID."
          },
          "country": {
            "title": "country",
            "type": "string",
            "description": "Used by `ads`. Specifies the country code for keyword queries in the ads action, such as US (defaults to US). Values are converted to uppercase when constructing request URLs. If keyword is provided as a complete URL, the parameters embedded in that URL take precedence and this country setting is not applied."
          },
          "status": {
            "title": "status",
            "type": "string",
            "description": "Used by `ads`. Filters ad page status with allowed values: all (default), active (currently running), or inactive (stopped). This represents ad delivery status rather than ad review status. When keyword is an Ad Library URL, its embedded active_status may differ from this parameter; keep the two consistent."
          },
          "sort": {
            "title": "sort",
            "type": "string",
            "description": "Used by `group_posts`. Specifies post ordering for group_posts using top for top posts or recent for posts with recent activity, defaulting to chronological order if omitted. The recent option is based on activity rather than post creation time alone. Unsupported string values fall back to chronological order instead of returning an error."
          },
          "location": {
            "title": "location",
            "type": "string",
            "description": "Used by `marketplace`. Specifies the city path identifier for marketplace, such as nyc (defaults to nyc). It does not accept free-form street addresses. If keyword contains a complete Marketplace URL, that URL takes precedence and location is ignored."
          },
          "page_token": {
            "title": "page_token",
            "type": "string",
            "description": "Used by `events_search`, `page_events`. Page token for `events_search` and `page_events`. Leave it out for the first page, then pass back the previous response's `next_page_token` exactly as received; the last page has none."
          },
          "limit": {
            "title": "limit",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "How many results to request for list actions. Defaults and maximums per action: `search` 10 (max 200); `user_posts` 10 (max 50); `comments` 10 (max 50); `ads` 20 (max 200); `group_posts` 20 (max 200); `marketplace` 20 (max 200); `reviews` 20 (max 200); `advertiser_search` 15 (max 15). Billing: `search` one event per started block of 10 results; `user_posts` one event per started block of 10 results; `comments` one event per started block of 10 results; `ads` one event per started block of 20 results; `group_posts` one event per started block of 20 results; `marketplace` one event per started block of 20 results; `reviews` one event per started block of 20 results; `advertiser_search` one event per non-empty request, whatever the row count."
          },
          "params": {
            "title": "params (advanced)",
            "type": "object",
            "description": "Optional JSON object with the same fields as above, for API and integration use. Flat fields and params must not disagree."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}