{
"openapi": "3.0.1",
"info": {
"title": "Facebook Search Profiles Scraper | People by Name or Keyword",
"description": "Facebook people search scraper: find public profiles by name, job or keyword, filter by city, employer or school, and export Facebook ID, profile link, name, job title, employer, school, city, gender and photos. No login, no Facebook account. Our default run returned 50 profiles in 47 seconds.",
"version": "1.0",
"x-build-id": "FvgcZybxXQc96XISr"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~facebook-search-profiles-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-facebook-search-profiles-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/silentflow~facebook-search-profiles-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-facebook-search-profiles-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/silentflow~facebook-search-profiles-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-facebook-search-profiles-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": {
"searchQueries": {
"title": "🔎 Names or keywords",
"type": "array",
"description": "What you would type in Facebook's people search, one per line: a full name (john smith, María García), a job or niche (real estate agent, software engineer) or a business owner's trade (wedding photographer). Each line is a separate search, and a profile found by two searches is saved once.",
"default": [
"john smith"
],
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 Facebook search links",
"type": "array",
"description": "Search pages copied from your browser, one per line: https://www.facebook.com/search/people/?q=john%20smith, https://www.facebook.com/search/top/?q=nurse or a public directory page such as https://www.facebook.com/public/John-Smith. The search text is read from the link, and so are the City, Work and Education filters you set on the people search page. Profile, page or group links are skipped.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "🔢 Max profiles per search",
"minimum": 1,
"type": "integer",
"description": "How many profiles to save for each name, keyword or link, each one a row. Facebook ranks the closest matches first: a common name or a job returns a few hundred profiles, a rare name a handful.",
"default": 50
},
"location": {
"title": "📍 City or country",
"type": "string",
"description": "Only people Facebook places in this city: London, Chicago, Lagos. Add the state or country to pick between cities of the same name (London, Ontario). A country or a region (Germany, California) also works: then only the profiles that show it in their city, hometown, job or school are kept. Leave empty to search worldwide."
},
"employer": {
"title": "🏢 Employer",
"type": "string",
"description": "Only people who list this company or organisation as a workplace, current or past: Google, Mayo Clinic, or the employer's Facebook page link for an exact match (https://www.facebook.com/Google). The run uses the best matching Facebook page and names it in the log."
},
"school": {
"title": "🎓 School",
"type": "string",
"description": "Only people who list this university or school: Harvard University, University of Lagos, or the school's Facebook page link. The run uses the best matching Facebook page and names it in the log."
},
"includeDetails": {
"title": "🧾 Add profile details",
"type": "boolean",
"description": "Opens the public page of each profile to add what it shows without login: gender, every workplace and school with the employer's page link, a larger profile photo, the cover photo, and for professional profiles their bio, category, websites, city and followers. Turn off for faster runs with only what the search card shows (name, photo, and job or city when Facebook prints them).",
"default": true
}
}
},
"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
}
}
}
}
}
}
}
}
}
}