{
  "openapi": "3.0.1",
  "info": {
    "title": "Earnings Call Transcript API - SEC 8-K Filings Parser & Monitor",
    "description": "Speaker-tagged earnings call transcripts with Q&A pairs, plus SEC 8-K filings parsed from EDGAR: item codes, press releases, guidance sentences, sentiment. Full-text keyword search across all US filers. Pay-per-result, no start fee.",
    "version": "0.1",
    "x-build-id": "0VSMHCZPBS0UOKQtW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/johnvc~earnings-call-transcript-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-johnvc-earnings-call-transcript-api",
        "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/johnvc~earnings-call-transcript-api/runs": {
      "post": {
        "operationId": "runs-sync-johnvc-earnings-call-transcript-api",
        "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/johnvc~earnings-call-transcript-api/run-sync": {
      "post": {
        "operationId": "run-sync-johnvc-earnings-call-transcript-api",
        "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": [
          "dataType"
        ],
        "properties": {
          "tickers": {
            "title": "Tickers",
            "type": "array",
            "description": "List stock ticker symbols to fetch, for example 'AAPL' or 'NVDA'. CIK numbers also work. Each ticker is processed independently and tagged in the output. Leave empty only when Search Keyword is set, which switches the Actor to full-text search across all US companies.",
            "items": {
              "type": "string"
            }
          },
          "dataType": {
            "title": "Data Type",
            "enum": [
              "filings",
              "transcripts",
              "both"
            ],
            "type": "string",
            "description": "Choose what to return: parsed SEC 8-K filings, structured earnings call transcripts, or both.",
            "default": "both"
          },
          "filingsLimit": {
            "title": "Max Filings Per Ticker",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Set how many 8-K filings to return per ticker, newest first. In keyword search mode this caps total results across all companies. Default 10.",
            "default": 10
          },
          "transcriptsLimit": {
            "title": "Max Transcripts Per Ticker",
            "minimum": 1,
            "maximum": 40,
            "type": "integer",
            "description": "Set how many earnings call transcripts to return per ticker, newest quarter first. Default 4, which covers one year of calls.",
            "default": 4
          },
          "searchKeyword": {
            "title": "Search Keyword (full-text mode)",
            "type": "string",
            "description": "Search this word or phrase across 8-K filings from ALL US companies using SEC EDGAR full-text search, for example 'guidance withdrawal' or 'material weakness'. When set, tickers become an optional company filter and dataType is treated as 'filings'."
          },
          "eventCategories": {
            "title": "Event Categories",
            "type": "array",
            "description": "Filter 8-K filings to these event categories, for example 'earnings' or 'executive_changes'. Each category maps to the matching 8-K item codes. Combine freely with Item Codes below.",
            "items": {
              "type": "string",
              "enum": [
                "earnings",
                "guidance",
                "mergers_acquisitions",
                "executive_changes",
                "cybersecurity",
                "bankruptcy",
                "restructuring",
                "accounting_issues",
                "delisting",
                "governance",
                "other_events"
              ],
              "enumTitles": [
                "Earnings releases (Item 2.02)",
                "Guidance and Reg FD (Items 2.02, 7.01)",
                "Mergers and acquisitions (Items 1.01, 1.02, 2.01)",
                "Executive changes (Item 5.02)",
                "Cybersecurity incidents (Item 1.05)",
                "Bankruptcy (Item 1.03)",
                "Restructuring and impairments (Items 2.05, 2.06)",
                "Accounting issues (Items 4.01, 4.02)",
                "Delisting notices (Item 3.01)",
                "Governance and votes (Items 5.01, 5.03, 5.07)",
                "Other events (Item 8.01)"
              ]
            }
          },
          "itemCodes": {
            "title": "8-K Item Codes",
            "type": "array",
            "description": "Filter 8-K filings to these item codes, for example '2.02' (results of operations), '5.02' (officer departures), or '1.05' (material cybersecurity incidents). Accepts any code from the full 8-K item map 1.01 through 9.01. Leave empty to return filings for all items.",
            "items": {
              "type": "string"
            }
          },
          "dateFrom": {
            "title": "Date From (YYYY-MM-DD)",
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "type": "string",
            "description": "Return only filings and transcripts dated on or after this date, format YYYY-MM-DD, for example 2025-01-01. Leave empty to default to roughly the last 12 months."
          },
          "dateTo": {
            "title": "Date To (YYYY-MM-DD)",
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "type": "string",
            "description": "Return only filings and transcripts dated on or before this date, format YYYY-MM-DD. Leave empty for no upper bound."
          },
          "includeFullText": {
            "title": "Include Full Text",
            "type": "boolean",
            "description": "Include the complete per-item filing text, full press release body, and full transcript in every record. Off by default to keep records small; structured fields (speakers, Q&A pairs, guidance sentences, sentiment scores) are always included.",
            "default": false
          },
          "metadataOnly": {
            "title": "Metadata Only (cheap mode)",
            "type": "boolean",
            "description": "Return filing metadata and item codes without fetching or parsing document bodies. Faster and lighter, ideal for alerting on new filings. Off by default.",
            "default": false
          },
          "onlyNew": {
            "title": "Only New Records (monitoring)",
            "type": "boolean",
            "description": "Skip records already returned by previous runs of this Actor on your account. Turn on together with a schedule to emit only newly filed 8-Ks and newly published transcripts on each run.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}