# Tmx Listed Company Directory Spider (`getdataforme/tmx-listed-company-directory-spider`) Actor This Apify actor scrapes comprehensive data from the Toronto Stock Exchange company directory, delivering real-time prices, market caps, dividends, and detailed profiles.... - **URL**: https://apify.com/getdataforme/tmx-listed-company-directory-spider.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** AI, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Description This Apify actor scrapes comprehensive data from the Toronto Stock Exchange company directory, delivering real-time prices, market caps, dividends, and detailed profiles.... --- ## Tmx Listed Company Directory Spider The Tmx Listed Company Directory Spider is a powerful Apify Actor designed to scrape and extract comprehensive data from the Toronto Stock Exchange (TSX) company directory. It provides detailed information on listed companies, including financial metrics, market data, and company profiles, enabling users to gather insights efficiently. This tool is ideal for investors, analysts, and businesses seeking up-to-date stock market information without manual effort. ### Features - **Comprehensive Data Extraction**: Retrieves detailed company profiles, including symbols, prices, market caps, dividends, and descriptions from TSX listings. - **Real-Time Market Data**: Captures live pricing, volume, and performance metrics like price changes and moving averages. - **Flexible URL Configuration**: Allows customization of scraping targets with support for multiple TSX endpoints. - **High Reliability**: Built on Apify's robust infrastructure for consistent, error-free data collection. - **Structured Output**: Delivers clean JSON data ready for analysis, integration, or export to formats like CSV and Excel. - **Scalable Performance**: Handles large directories efficiently with minimal resource usage. - **Easy Integration**: Seamlessly connects with other tools for automated workflows in finance and research. ### Input Parameters | Parameter | Type | Required | Description | Example | |-----------|----------|----------|-----------------------------------------------------------------------------|---------| | Urls | array | Yes | An array of URLs to scrape from the TSX company directory. Must include at least one valid HTTP/HTTPS URL. | ["https://www.tsx.com/json/company-directory/recent/tsx"] | ### Example Usage #### Input Configuration ```json { "Urls": [ "https://www.tsx.com/json/company-directory/recent/tsx" ] } ```` #### Output Example ```json [ { "symbol": "RCTR", "name": "First Trust Bloomberg Nuclear Power ETF", "date": 1768539600, "price": 19.15, "price_change": 0.59, "percent_change": 3.178879, "exchange_name": "Toronto Stock Exchange", "exchange_short_name": "TSX", "exchange_code": "TSX", "market_place": null, "sector": "", "industry": "", "volume": 197, "open_price": 19.15, "day_high": 19.15, "day_low": 19.15, "market_cap": 957500, "market_cap_all_classes": 957500, "pe_ratio": 24.55, "prev_close": 18.56, "dividend_frequency": null, "dividend_yield": null, "dividend_amount": null, "dividend_currency": null, "beta": null, "eps": null, "ex_dividend_date": "", "long_description": "The investment strategy of the First Trust ETF is to provide exposure to the Index by holding securities of First Trust Bloomberg Nuclear Power ETF, a U.S.-listed index ETF which is managed by an affiliate of the Manager which seeks to replicate or substantially replicate the performance of the Index. The First Trust ETF seeks to replicate, to the extent possible, the performance of an index of companies that are exposed to nuclear power, net of expenses, initially the Bloomberg Nuclear Power Index.", "full_description": "The investment strategy of the First Trust ETF is to provide exposure to the Index by holding securities of First Trust Bloomberg Nuclear Power ETF, a U.S.-listed index ETF which is managed by an affiliate of the Manager which seeks to replicate or substantially replicate the performance of the Index. The First Trust ETF seeks to replicate, to the extent possible, the performance of an index of companies that are exposed to nuclear power, net of expenses, initially the Bloomberg Nuclear Power Index.", "website": "", "email": "", "phone_number": "", "full_address": "CA", "employees": "", "share_out_standing": 50000, "total_debt_to_equity": "", "total_shares_out_standing": 50000, "shares_escrow": null, "vwap": 19.1499999, "dividend_pay_date": null, "weeks_52_high": 20.94, "weeks_52_low": 18.56, "alpha": null, "average_volume_10d": 67, "average_volume_20d": 113, "average_volume_30d": 114, "average_volume_50d": 205, "price_to_book": 1.4, "price_to_cash_flow": "", "return_on_equity": "", "return_on_assets": "", "day_21_moving_avg": 19.76619, "day_50_moving_avg": 19.723333, "day_200_moving_avg": 19.723333, "dividend_3_years": "", "dividend_5_years": "", "datatype": "etf", "issue_type": "", "sec_type": null, "close": 19.06, "qm_description": "", "currency": "CAD", "actor_id": "3m17V7p1CagvvBCVY", "run_id": "W8ZyffLkL7Rg0xjkf" }, { "symbol": "CEQP", "name": "CI Equity+ Asset Allocation ETF Fund", "date": 1769403600, "price": 19, "price_change": 0.39, "percent_change": 2.095648, "exchange_name": "Toronto Stock Exchange", "exchange_short_name": "TSX", "exchange_code": "TSX", "market_place": null, "sector": "", "industry": "", "volume": 0, "open_price": null, "day_high": null, "day_low": null, "market_cap": 1900000, "market_cap_all_classes": 1900000, "pe_ratio": "", "prev_close": 18.61, "dividend_frequency": "Quarterly", "dividend_yield": 0.061, "dividend_amount": 0.0029, "dividend_currency": "CAD", "beta": null, "eps": null, "ex_dividend_date": "2026-03-25 00:00:00.0", "long_description": "In order to achieve its investment objective, the fund invests indirectly in a portfolio of global equity securities and other assets. The portfolio adviser seeks to maintain a long-term strategic asset allocation of approximately 92 percent equity securities and 8 percent in other assets including but not limited to digital assets or commodities (under normal market conditions). The portfolio asset mix may be reconstituted and rebalanced from time to time at the discretion of the portfolio adviser. The funds investment objective is to provide longterm capital growth.", "full_description": "In order to achieve its investment objective, the fund invests indirectly in a portfolio of global equity securities and other assets. The portfolio adviser seeks to maintain a long-term strategic asset allocation of approximately 92 percent equity securities and 8 percent in other assets including but not limited to digital assets or commodities (under normal market conditions). The portfolio asset mix may be reconstituted and rebalanced from time to time at the discretion of the portfolio adviser. The funds investment objective is to provide longterm capital growth.", "website": "", "email": "", "phone_number": "", "full_address": "CA", "employees": "", "share_out_standing": 100000, "total_debt_to_equity": "", "total_shares_out_standing": 100000, "shares_escrow": null, "vwap": null, "dividend_pay_date": "2026-03-31", "weeks_52_high": 20.34, "weeks_52_low": 18.61, "alpha": null, "average_volume_10d": 32, "average_volume_20d": 82, "average_volume_30d": 186, "average_volume_50d": 218, "price_to_book": null, "price_to_cash_flow": "", "return_on_equity": "", "return_on_assets": "", "day_21_moving_avg": 19.611904, "day_50_moving_avg": 19.724104, "day_200_moving_avg": 19.724104, "dividend_3_years": "", "dividend_5_years": "", "datatype": "etf", "issue_type": "", "sec_type": null, "close": 19.01, "qm_description": "", "currency": "CAD", "actor_id": "3m17V7p1CagvvBCVY", "run_id": "W8ZyffLkL7Rg0xjkf" }, { "symbol": "HPYB", "name": "Harvest Premium Yield Canadian Bank ETF", "date": 1768885200, "price": 11.62, "price_change": 0.19, "percent_change": 1.662292, "exchange_name": "Toronto Stock Exchange", "exchange_short_name": "TSX", "exchange_code": "TSX", "market_place": null, "sector": "", "industry": "", "volume": 19361, "open_price": 11.48, "day_high": 11.65, "day_low": 11.48, "market_cap": 19463500, "market_cap_all_classes": 19463500, "pe_ratio": "", "prev_close": 11.43, "dividend_frequency": null, "dividend_yield": 2.41, "dividend_amount": 0.07, "dividend_currency": "CAD", "beta": null, "eps": null, "ex_dividend_date": "2026-03-13 00:00:00.0", "long_description": "The fund invests, directly or indirectly, in equity securities of Canadian banks listed on the TSX, initially focusing on six Canadian banks. Security selection is based on fundamental financial characteristics and the ability of the underlying securities to generate option premiums. The fund employs a broad range of option-writing strategies, including covered call and covered put options, to generate income and support long-term capital appreciation. Exposure to bank equities may be obtained directly, through exchange-traded mutual funds (including those managed by the Manager), or through derivatives linked to equity securities. The fund may also use put options for hedging purposes. As an alternative mutual fund, it may employ strategies not available to conventional mutual funds, including higher issuer concentration, borrowing, short selling, and leverage, in accordance with regulatory limits and its investment objectives.", "full_description": "The fund invests, directly or indirectly, in equity securities of Canadian banks listed on the TSX, initially focusing on six Canadian banks. Security selection is based on fundamental financial characteristics and the ability of the underlying securities to generate option premiums. The fund employs a broad range of option-writing strategies, including covered call and covered put options, to generate income and support long-term capital appreciation. Exposure to bank equities may be obtained directly, through exchange-traded mutual funds (including those managed by the Manager), or through derivatives linked to equity securities. The fund may also use put options for hedging purposes. As an alternative mutual fund, it may employ strategies not available to conventional mutual funds, including higher issuer concentration, borrowing, short selling, and leverage, in accordance with regulatory limits and its investment objectives. Harvest Premium Yield Canadian Bank ETF seeks to generate longterm capital appreciation and income by investing in equity securities of Canadian banks and by generating option premium income, while seeking to preserve capital.", "website": "", "email": "", "phone_number": "", "full_address": "CA", "employees": "", "share_out_standing": 1675000, "total_debt_to_equity": "", "total_shares_out_standing": 1675000, "shares_escrow": null, "vwap": 11.6028042, "dividend_pay_date": "2026-03-19", "weeks_52_high": 12.42, "weeks_52_low": 11.4, "alpha": null, "average_volume_10d": 27504, "average_volume_20d": 32801, "average_volume_30d": 30623, "average_volume_50d": 27540, "price_to_book": null, "price_to_cash_flow": "", "return_on_equity": "", "return_on_assets": "", "day_21_moving_avg": 11.841894, "day_50_moving_avg": 11.805195, "day_200_moving_avg": 11.805195, "dividend_3_years": "", "dividend_5_years": "", "datatype": "etf", "issue_type": "", "sec_type": null, "close": 11.62, "qm_description": "", "currency": "CAD", "actor_id": "3m17V7p1CagvvBCVY", "run_id": "W8ZyffLkL7Rg0xjkf" } ] ``` ### Use Cases - **Market Research and Analysis**: Gather data on TSX-listed companies for portfolio management and trend analysis. - **Competitive Intelligence**: Monitor competitors' stock performance, market caps, and financial ratios. - **Price Monitoring**: Track real-time prices, changes, and historical highs/lows for investment decisions. - **Content Aggregation**: Collect company descriptions and profiles for financial blogs or reports. - **Academic Research**: Access structured data for studies on market behavior and economic indicators. - **Business Automation**: Integrate with dashboards for automated alerts on dividend yields or volume spikes. ### Installation and Usage 1. Search for "Tmx Listed Company Directory Spider" in the Apify Store 2. Click "Try for free" or "Run" 3. Configure input parameters 4. Click "Start" to begin extraction 5. Monitor progress in the log 6. Export results in your preferred format (JSON, CSV, Excel) ### Output Format The Actor outputs an array of JSON objects, each representing a TSX-listed company. Key fields include: `symbol` (stock ticker), `name` (company name), `price` (current price), `price_change` and `percent_change` (daily changes), `market_cap` (market capitalization), `volume` (trading volume), `dividend_yield` and related fields, `long_description` (detailed company info), and various financial metrics like P/E ratio, beta, and moving averages. Fields may be null or empty if data is unavailable. The output is clean and ready for direct use in applications. ### Support For custom/simplified outputs or bug reports, please contact: - Email: support@getdataforme.com - Subject line: "custom support" - Contact form: https://getdataforme.com/contact/ We're here to help you get the most out of this Actor! # Actor input Schema ## `Urls` (type: `array`): The urls for the spider. ## Actor input object example ```json { "Urls": [ "https://www.tsx.com/json/company-directory/recent/tsx" ] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/tmx-listed-company-directory-spider").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("getdataforme/tmx-listed-company-directory-spider").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call getdataforme/tmx-listed-company-directory-spider --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/tmx-listed-company-directory-spider", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Tmx Listed Company Directory Spider", "description": "This Apify actor scrapes comprehensive data from the Toronto Stock Exchange company directory, delivering real-time prices, market caps, dividends, and detailed profiles....", "version": "0.0", "x-build-id": "j2ChCYHOUi8htKgiV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~tmx-listed-company-directory-spider/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-tmx-listed-company-directory-spider", "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/getdataforme~tmx-listed-company-directory-spider/runs": { "post": { "operationId": "runs-sync-getdataforme-tmx-listed-company-directory-spider", "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/getdataforme~tmx-listed-company-directory-spider/run-sync": { "post": { "operationId": "run-sync-getdataforme-tmx-listed-company-directory-spider", "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": { "Urls": { "title": "Urls", "minItems": 1, "type": "array", "description": "The urls for the spider.", "default": [ "https://www.tsx.com/json/company-directory/recent/tsx" ], "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```