{ "openapi": "3.0.1", "info": { "title": "Creator Contact & Socials Resolver", "description": "Turn creator profile URLs (YouTube, TikTok, Instagram, Linktree, websites) into contact rows: name, followers, bio, every linked social account, emails and website from the public page and its bio-link page. One row per input; blocked pages return an error field instead of failing the run.", "version": "0.1", "x-build-id": "FaakCdhXKNu9VTlNL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/findcreators~creator-contact-resolver/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-findcreators-creator-contact-resolver", "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/findcreators~creator-contact-resolver/runs": { "post": { "operationId": "runs-sync-findcreators-creator-contact-resolver", "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/findcreators~creator-contact-resolver/run-sync": { "post": { "operationId": "run-sync-findcreators-creator-contact-resolver", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Creator URLs", "minItems": 1, "uniqueItems": true, "type": "array", "description": "One creator per line: a YouTube channel, TikTok profile, Instagram profile, Linktree / Beacons / any bio-link page, or a personal website. Full URLs work best (https://www.tiktok.com/@name). A bare '@name' is rejected because the platform is ambiguous.", "items": { "type": "string" } }, "followLinkPages": { "title": "Follow bio-link pages and websites", "type": "boolean", "description": "When a profile links to a Linktree-style page or a personal website, open it too and collect the socials and emails listed there. Turn off to read only the profile page itself.", "default": true }, "maxHops": { "title": "Maximum link hops", "minimum": 0, "maximum": 2, "type": "integer", "description": "How many pages deep to follow bio-link pages and websites. 1 = profile plus the pages it links to directly. 2 = also the pages those pages link to. Only Linktree-style pages and plain websites are followed; other social profiles are listed, not opened.", "default": 1 }, "minDelaySeconds": { "title": "Minimum delay between requests to the same site (seconds)", "minimum": 0, "maximum": 60, "type": "integer", "description": "Polite pacing per host, plus up to one second of random jitter. Lower values run faster but get blocked more often, especially on TikTok and Instagram. Use 0 only with rotating residential proxies.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to route requests through. TikTok and Instagram block datacenter IPs frequently; residential proxies give noticeably better results for those two platforms." }, "youtubeApiKey": { "title": "YouTube Data API key (optional)", "type": "string", "description": "Optional. With a key, YouTube channels are read through the official Data API (reliable subscriber counts, full description). Without it the public channel page is parsed, which works but breaks whenever YouTube changes its markup. The key is never written to the dataset or logs." } } }, "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 } } }, "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 } } } } } } } } } }