{ "openapi": "3.0.1", "info": { "title": "IG Bulk DM", "description": "Boost your Instagram outreach with the Instagram Bulk DM Sender. This powerful Apify Actor allows you to send personalized direct messages to multiple Instagram users automatically. Designed for efficiency, account safety, it supports message randomization and smart delays to mimic human behavior.", "version": "0.0", "x-build-id": "UPbPF0xm26CN2AHH7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api402~IG-Bulk-DM/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api402-IG-Bulk-DM", "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/api402~IG-Bulk-DM/runs": { "post": { "operationId": "runs-sync-api402-IG-Bulk-DM", "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/api402~IG-Bulk-DM/run-sync": { "post": { "operationId": "run-sync-api402-IG-Bulk-DM", "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": [ "usernames", "message" ], "properties": { "cookies": { "title": "Instagram Cookies (JSON)", "type": "string", "description": "Instagram cookies exported from your browser in JSON format (Cookie-Editor → Export → JSON). Paste the full JSON array here. Recommended over Session ID as it provides full authentication context." }, "sessionId": { "title": "Session ID (alternative to Cookies)", "type": "string", "description": "Your Instagram sessionid cookie value. Find it in DevTools → Application → Cookies → instagram.com → sessionid. Use this OR the Cookies field — not both." }, "usernames": { "title": "Target Usernames / Direct Thread Links", "type": "array", "description": "List of Instagram usernames, direct thread URLs (e.g., https://www.instagram.com/direct/t/17847593121604684), or thread IDs (e.g., 17847593121604684) to send messages to.", "items": { "type": "string" } }, "message": { "title": "Message Template", "type": "string", "description": "Message to send. Use {option1|option2|option3} for random variations. Use [username] or [firstname] as dynamic placeholders. Example: 'Hey [firstname] {hola|hi|hello}!'" }, "min_delay": { "title": "Minimum Delay (seconds)", "minimum": 30, "type": "integer", "description": "Minimum delay between sending messages (in seconds). Recommended: 60-120 seconds to avoid rate limits.", "default": 90 }, "max_delay": { "title": "Maximum Delay (seconds)", "minimum": 60, "type": "integer", "description": "Maximum delay between sending messages (in seconds). Recommended: 120-300 seconds.", "default": 180 }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy configuration. Use Apify Residential Proxy for best results — datacenter IPs are often blocked by Instagram." }, "save_session": { "title": "Save Session", "type": "boolean", "description": "Whether to save the authenticated browser session to the Key-Value store after the run (key: SESSION). Useful for resuming without re-authenticating.", "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 } } }, "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 } } } } } } } } } }