{
  "openapi": "3.0.1",
  "info": {
    "title": "Strategy Execution Research Builder",
    "description": "Discover implementation examples and turn source-backed evidence into deterministic OKRs, KPIs, Balanced Scorecard views, and executive briefs.",
    "version": "0.1",
    "x-build-id": "iKKp1DQczuZC1gPMO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solutionssmart~strategy-execution-research-builder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solutionssmart-strategy-execution-research-builder",
        "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/solutionssmart~strategy-execution-research-builder/runs": {
      "post": {
        "operationId": "runs-sync-solutionssmart-strategy-execution-research-builder",
        "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/solutionssmart~strategy-execution-research-builder/run-sync": {
      "post": {
        "operationId": "run-sync-solutionssmart-strategy-execution-research-builder",
        "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": {
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Optional best-effort query to find additional implementation examples. Seed URLs remain the most reliable starting point."
          },
          "seedUrls": {
            "title": "Seed URLs",
            "type": "array",
            "description": "Preferred starting URLs. This is the most reliable way to get focused, high-quality results in v1.",
            "items": {
              "type": "string"
            }
          },
          "allowDomains": {
            "title": "Allowed domains",
            "type": "array",
            "description": "Only crawl these trusted domains and their subdomains.",
            "items": {
              "type": "string"
            }
          },
          "blockDomains": {
            "title": "Blocked domains",
            "type": "array",
            "description": "Never crawl these domains or subdomains, even if they appear in discovery.",
            "items": {
              "type": "string"
            }
          },
          "sourceType": {
            "title": "Source types",
            "uniqueItems": true,
            "type": "array",
            "description": "Optional source categories to guide the type of implementation material you want to prioritize.",
            "items": {
              "type": "string",
              "enum": [
                "Business journals",
                "Corporate websites",
                "Case study databases",
                "Industry reports",
                "News articles"
              ]
            }
          },
          "frameworkType": {
            "title": "Framework types",
            "uniqueItems": true,
            "type": "array",
            "description": "Frameworks to prioritize when extracting evidence and generating outputs.",
            "items": {
              "type": "string",
              "enum": [
                "Strategic Planning",
                "Strategic Thinking",
                "VUCA / VUCA-Prime",
                "McKinsey 7S Model",
                "ADKAR Change Model",
                "Kotter's 8-Step Process",
                "Blue Ocean Strategy",
                "EOS/Traction",
                "Balanced Scorecard"
              ]
            }
          },
          "dateRange": {
            "title": "Date range",
            "type": "object",
            "description": "Optional publication date window for narrowing the evidence set.",
            "properties": {
              "from": {
                "title": "From",
                "type": "string",
                "editor": "textfield",
                "description": "Earliest publication date to include."
              },
              "to": {
                "title": "To",
                "type": "string",
                "editor": "textfield",
                "description": "Latest publication date to include."
              }
            },
            "additionalProperties": false
          },
          "industry": {
            "title": "Industry",
            "type": "string",
            "description": "Optional industry context used to frame the generated outputs."
          },
          "companySize": {
            "title": "Company size",
            "type": "string",
            "description": "Optional company size context for output framing."
          },
          "region": {
            "title": "Region",
            "type": "string",
            "description": "Optional region used to narrow research context and output framing."
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Select preferred language codes for discovery and labeling.",
            "items": {
              "type": "string",
              "enum": [
                "en",
                "de",
                "fr",
                "es",
                "pt",
                "it",
                "nl",
                "sv",
                "no",
                "da",
                "fi",
                "pl",
                "cs",
                "ro",
                "hu",
                "tr",
                "ar",
                "he",
                "hi",
                "zh",
                "ja",
                "ko"
              ]
            }
          },
          "includePdf": {
            "title": "Include PDFs",
            "type": "boolean",
            "description": "Enable PDF fetching and parsing. This can improve coverage, but may be slower than HTML-only runs.",
            "default": false
          },
          "followDepth": {
            "title": "Follow depth",
            "minimum": 0,
            "maximum": 2,
            "type": "integer",
            "description": "How far to expand from each starting page. Lower values are usually cleaner and more focused.",
            "default": 1
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Maximum number of normalized evidence records to store.",
            "default": 10
          },
          "dedupe": {
            "title": "Deduplicate records",
            "type": "boolean",
            "description": "Reduce repeated URLs and overlapping evidence records.",
            "default": true
          },
          "summaryWords": {
            "title": "Summary words",
            "minimum": 60,
            "maximum": 400,
            "type": "integer",
            "description": "Approximate word budget for per-record and run-level summaries.",
            "default": 150
          },
          "executionArtifacts": {
            "title": "Execution artifacts",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose which deterministic execution-ready outputs to generate from the extracted evidence.",
            "items": {
              "type": "string",
              "enum": [
                "OKRs",
                "KPIs",
                "BSC",
                "EOS Components",
                "Project Management Plan",
                "RACI Matrix",
                "OCAI Culture Profile",
                "Executive Report"
              ]
            },
            "default": [
              "OKRs",
              "KPIs",
              "BSC",
              "Executive Report"
            ]
          },
          "okrHorizon": {
            "title": "OKR horizon",
            "enum": [
              "Quarter",
              "Half-Year",
              "Annual"
            ],
            "type": "string",
            "description": "Planning horizon for generated OKRs.",
            "default": "Quarter"
          },
          "bscPerspectives": {
            "title": "Balanced scorecard perspectives",
            "uniqueItems": true,
            "type": "array",
            "description": "Balanced Scorecard perspectives to include in the generated mapping.",
            "items": {
              "type": "string",
              "enum": [
                "Financial",
                "Customer",
                "Internal Process",
                "Learning & Growth"
              ]
            },
            "default": [
              "Financial",
              "Customer",
              "Internal Process",
              "Learning & Growth"
            ]
          },
          "eosQuarter": {
            "title": "EOS quarter",
            "type": "string",
            "description": "Optional EOS quarter label such as `Q1-2026`."
          },
          "pmMethodology": {
            "title": "PM methodology",
            "enum": [
              "Agile",
              "Waterfall",
              "Hybrid",
              "PRINCE2",
              "PMI/PMBOK"
            ],
            "type": "string",
            "description": "Methodology label to use if project plan outputs are enabled.",
            "default": "Hybrid"
          },
          "teamRoster": {
            "title": "Team roster",
            "type": "array",
            "description": "Optional team roster used when generating RACI rows and ownership fields.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "name": {
                  "title": "Name",
                  "type": "string",
                  "editor": "textfield",
                  "description": "Team member name."
                },
                "role": {
                  "title": "Role",
                  "type": "string",
                  "editor": "textfield",
                  "description": "Primary role or function."
                },
                "email": {
                  "title": "Email",
                  "type": "string",
                  "editor": "textfield",
                  "description": "Optional email address."
                },
                "department": {
                  "title": "Department",
                  "type": "string",
                  "editor": "textfield",
                  "description": "Optional department name."
                }
              },
              "required": [
                "name",
                "role"
              ]
            }
          },
          "meetingCadence": {
            "title": "Meeting cadence",
            "type": "object",
            "description": "Meeting cadence preferences used for EOS-style and operating-rhythm outputs.",
            "properties": {
              "weeklyL10": {
                "title": "Weekly L10",
                "type": "boolean",
                "editor": "checkbox",
                "description": "Include weekly L10 meetings in EOS-style outputs.",
                "default": true
              },
              "monthlyOps": {
                "title": "Monthly ops",
                "type": "boolean",
                "editor": "checkbox",
                "description": "Include monthly operations reviews.",
                "default": true
              },
              "quarterlyPlanning": {
                "title": "Quarterly planning",
                "type": "boolean",
                "editor": "checkbox",
                "description": "Include quarterly planning sessions.",
                "default": true
              }
            },
            "additionalProperties": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}