{ "openapi": "3.0.1", "info": { "title": "Facebook ID Finder", "description": "Convert Facebook URLs, vanity names or @handles into numeric IDs. Works for pages, profiles, groups, posts, videos and reels, and returns the ID, name, vanity name, object type, current and classic Page IDs and the source URL. No Facebook login needed.", "version": "0.0", "x-build-id": "U84gruLA4VabAfv4E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~facebook-id-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-facebook-id-finder", "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/axiomworks~facebook-id-finder/runs": { "post": { "operationId": "runs-sync-axiomworks-facebook-id-finder", "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/axiomworks~facebook-id-finder/run-sync": { "post": { "operationId": "run-sync-axiomworks-facebook-id-finder", "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": [ "urls" ], "properties": { "urls": { "title": "Facebook URLs, vanity names or @handles", "type": "array", "description": "Facebook targets to resolve, e.g. [\"https://www.facebook.com/nasa\", \"@Meta\", \"cocacola\"]. Accepts full or scheme-less Facebook URLs, mobile/web/mbasic links, numeric URL paths and fb.watch short links. Supply at least one string; duplicates are normalized. Only resolved targets produce dataset rows; see UNRESOLVED for skipped targets.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum distinct targets to process (1–10,000)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap on distinct input URLs processed, e.g. 10. Integer 1–10,000, default 100. Duplicate normalized URLs do not count twice. Unresolved targets still count toward this cap, so the dataset may contain fewer rows.", "default": 100 }, "fetchDetails": { "title": "Fetch public details (true or false)", "type": "boolean", "description": "Whether to request public Facebook pages, e.g. true (default), to add name, vanity, canonicalUrl, pageId and ownerId when available. Set false to resolve numeric URL IDs without fetching; vanity URLs still need requests. resolveFromUrlOnly=true overrides this option.", "default": true }, "resolveFromUrlOnly": { "title": "Parse numeric URL IDs only (true or false)", "type": "boolean", "description": "Whether to disable all Facebook requests, e.g. true for profile.php?id=4 or /groups/1449013568720516. Boolean, default false. Overrides fetchDetails. Vanity names and short links without numeric IDs cannot resolve in this mode; replace them with numeric URLs or set false.", "default": false }, "maxConcurrency": { "title": "Parallel target workers (1–10)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of targets processed concurrently, e.g. 3. Integer 1–10, default 3. HTTP requests remain spaced about one second apart across all workers; this option does not remove request pacing.", "default": 3 }, "proxyConfiguration": { "title": "Facebook request proxy settings (object)", "type": "object", "description": "Proxy settings for public Facebook requests, e.g. {\"useApifyProxy\":true,\"apifyProxyGroups\":[\"RESIDENTIAL\"]} (default). The first attempt uses datacenter, then the configured proxy, then residential. Offline URL parsing needs no proxy. No Facebook login or cookies are accepted.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }