TOOL API

call-actor

Call any Actor from the Apify Store. WORKFLOW: 1. Use fetch-actor-details to get the Actor's input schema 2. Call this tool with the actor name and proper input based on the schema If the actor name is not in "username/name" format, use search-actors to resolve the correct Actor first. For MCP server Actors: - Use fetch-actor-details with output={ mcpTools: true } to list available tools - Call using format: "actorName:toolName" (e.g., "apify/actors-mcp-server:fetch-apify-docs") IMPORTANT: - Typically returns a datasetId and preview of output items - Use get-actor-output tool with the datasetId to fetch full results - Use dedicated Actor tools when available for better experience There are two ways to run Actors: 1. Dedicated Actor tools (e.g., apify--rag-web-browser): These are pre-configured tools, offering a simpler and more direct experience. 2. Generic call-actor tool (call-actor): Use this when a dedicated tool is not available or when you want to run any Actor dynamically. This tool is especially useful if you do not want to add specific tools or your client does not support dynamic tool registration. USAGE: - Always use dedicated tools when available (e.g., apify--rag-web-browser) - Use the generic call-actor tool only if a dedicated tool does not exist for your Actor. - This tool supports async execution via the `async` parameter: - **When `async: false` or not provided** (default): Waits for completion and returns results immediately with dataset preview. Use this whenever the user asks for data or results. - **When `async: true`**: Starts the run and returns immediately with runId. Only use this when the user explicitly asks to run the Actor in the background or does not need immediate results. EXAMPLES: - user_input: Get instagram posts using apify/instagram-scraper