# BVL Stock Exchange Listed Companies & Quotes Scraper (`scrapers_lat/latam-stock-exchanges-scraper`) Actor

Scrape Lima Stock Exchange (BVL Peru) listed companies and live quotes: ticker, sector, last price, bid/ask, change %, volume, market cap, board and index membership. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/latam-stock-exchanges-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Other, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.20 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![LATAM Stock Exchange Listed Companies & Quotes Scraper](https://scrapers.lat/banners/latam-stock-exchanges-scraper.png)](https://console.apify.com/actors/nYODe3S5Xst35QedV/input)

## LATAM Stock Exchange Listed Companies & Quotes Scraper

Here is one real result, with every field the actor returns:

```json
{
  "exchange": "BVL",
  "country": "Peru",
  "recordType": "equity",
  "ticker": "MINSURI1",
  "isin": "PEP622005002",
  "companyCode": "62200",
  "companyName": "MINSUR S.A.",
  "sector": "Mineras",
  "sectorCode": "CM",
  "subSectorCode": "CM01",
  "securityType": "Equity",
  "lastPrice": 7.36,
  "currency": "PEN",
  "changePct": 0.1360544218,
  "buyPrice": 7.34,
  "sellPrice": 7.36,
  "dayOpen": 7.34,
  "dayHigh": 7.36,
  "dayLow": 7.34,
  "dayClose": 7.35,
  "volume": 3883,
  "tradedAmount": 28533.67,
  "operations": 28,
  "sharesOutstanding": 961000840,
  "marketCap": 7072966182.4,
  "nominalValue": 1,
  "priceDate": "2026-08-07",
  "chairman": "Fortunato Juan Jose Brescia Moreyra",
  "generalManager": "Juan Luis Alfredo Kruger Sayán",
  "boardSize": 7,
  "indexMemberships": ["S&P Peru Select 20% Capped Index (USD)", "S&P Peru Total Index (PEN)", "S&P Peru Select 20% Capped Index (PEN)", "S&P Peru Total Index (USD)"],
  "indexMembershipCount": 4,
  "website": "WWW.MINSUR.COM",
  "phone": "215 8330",
  "address": "Jr. Giovanni Batista Lorenzo Bernini Nº 149, Oficina 501 A, San Borja, Lima",
  "active": true,
  "source": "Bolsa de Valores de Lima (BVL)",
  "observedAt": "2026-08-10T14:34:45.456Z"
}
```

The most complete LATAM stock exchange scraper available. It returns every field the Bolsa de Valores de Lima (BVL) exposes per listed company and security, including live quotes, market cap, shares outstanding, board officers, index memberships and contact details, plus headline index quotes, filterable by sector.

**📥 [Input](https://apify.com/scrapers_lat/latam-stock-exchanges-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/latam-stock-exchanges-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/latam-stock-exchanges-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/latam-stock-exchanges-scraper/examples)**

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Coverage](https://img.shields.io/badge/Coverage-Peru%20\(BVL\)-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)
![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)

### What it does

The actor reads the Bolsa de Valores de Lima (BVL) listed-securities and quotes feeds, applies the sector filter you pass as input, and writes one normalized record per company/security to the run's dataset. Each equity record carries the ticker, ISIN, issuer code, sector, live quote (last, bid, ask, open, high, low, close), volume, traded amount, number of operations, shares outstanding, market cap, nominal value, board chairman and general manager, index memberships and company contact details. Optionally include the exchange's headline index quotes and fixed-income (bond) securities. Missing source values are returned as `null`.

### Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 mining-sector companies plus the exchange's index quotes.

```json
{
  "sectors": ["CM"],
  "maxCompanies": 10,
  "includeIndices": true,
  "includeFixedIncome": false
}
```

Leave `sectors` empty to return every listed company. Accepts BVL sector codes (`CB` banks, `CM` mining, `CI` industrial, `CP` utilities, `CG` agrarian, `CS` insurance, `CD` diversified, `FI` investment funds, `CA` pension funds) or a sector name substring such as `MINERAS`.

### Input reference

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `sectors` | string\[] | no | `["CM"]` | Filter by BVL sector code (`CB`, `CM`, `CI`, `CP`, `CG`, `CS`, `CD`, `FI`, `CA`) or a sector name substring, for example `MINERAS`. Empty for all. |
| `maxCompanies` | integer | no | `10` | Maximum company/security quote records to return. |
| `includeIndices` | boolean | no | `true` | Also return the exchange's headline index quotes (value, change %, open, high, low, close). |
| `includeFixedIncome` | boolean | no | `false` | Also include fixed-income (bond) securities in addition to equities. |

### Output reference

One dataset item per security or index. Types: `string`, `integer`, `number`, `boolean`, `string[]`, or `null` when the source value is absent.

| Field | Type | Description |
|---|---|---|
| `exchange` | string | Exchange code. Always `BVL`. |
| `country` | string | Country. Always `Peru`. |
| `recordType` | string | `equity` or `index`. |
| `ticker` | string | Ticker / nemonico. |
| `isin` | string | ISIN code. |
| `companyCode` | string | Issuer code. |
| `companyName` | string | Company / index name. |
| `sector` | string | Sector name. |
| `sectorCode` | string | Sector code. |
| `subSectorCode` | string | Sub-sector code. |
| `securityType` | string | `Equity`, `Fixed income`, or `Index`. |
| `lastPrice` | number | Last traded price. |
| `currency` | string | Currency: `PEN` or `USD`. |
| `changePct` | number | Change percent versus previous close. |
| `buyPrice` | number | Best bid. |
| `sellPrice` | number | Best ask. |
| `dayOpen` | number | Session open. |
| `dayHigh` | number | Session high. |
| `dayLow` | number | Session low. |
| `dayClose` | number | Session close. |
| `volume` | number | Quantity negotiated. |
| `tradedAmount` | number | Traded amount. |
| `operations` | integer | Number of operations. |
| `sharesOutstanding` | number | Shares outstanding. |
| `marketCap` | number | Market capitalization. |
| `nominalValue` | number | Nominal value per share. |
| `priceDate` | string | Quote date (`YYYY-MM-DD`). |
| `chairman` | string | Board chairman. |
| `generalManager` | string | General manager. |
| `boardSize` | integer | Number of board members. |
| `indexMemberships` | string\[] | Indices the security belongs to. |
| `indexMembershipCount` | integer | Number of index memberships. |
| `website` | string | Company website. |
| `phone` | string | Company phone. |
| `address` | string | Company address. |
| `active` | boolean | Issuer active flag. |
| `source` | string | Data source. Always the BVL. |
| `observedAt` | string | ISO 8601 timestamp of when the record was collected. |
| `error` | string | `null` on success. On a failed run, a single item with a populated `error` field is written instead. |

### Example output record

Real record from a live run (input `{"sectors":["CM"],"maxCompanies":10,"includeIndices":true,"includeFixedIncome":false}`):

```json
{
  "exchange": "BVL",
  "country": "Peru",
  "recordType": "equity",
  "ticker": "MINSURI1",
  "isin": "PEP622005002",
  "companyCode": "62200",
  "companyName": "MINSUR S.A.",
  "sector": "Mineras",
  "sectorCode": "CM",
  "subSectorCode": "CM01",
  "securityType": "Equity",
  "lastPrice": 7.36,
  "currency": "PEN",
  "changePct": 0.1360544218,
  "buyPrice": 7.34,
  "sellPrice": 7.36,
  "dayOpen": 7.34,
  "dayHigh": 7.36,
  "dayLow": 7.34,
  "dayClose": 7.35,
  "volume": 3883,
  "tradedAmount": 28533.67,
  "operations": 28,
  "sharesOutstanding": 961000840,
  "marketCap": 7072966182.4,
  "nominalValue": 1,
  "priceDate": "2026-08-07",
  "chairman": "Fortunato Juan Jose Brescia Moreyra",
  "generalManager": "Juan Luis Alfredo Kruger Sayán",
  "boardSize": 7,
  "indexMemberships": ["S&P Peru Select 20% Capped Index (USD)", "S&P Peru Total Index (PEN)", "S&P Peru Select 20% Capped Index (PEN)", "S&P Peru Total Index (USD)"],
  "indexMembershipCount": 4,
  "website": "WWW.MINSUR.COM",
  "phone": "215 8330",
  "address": "Jr. Giovanni Batista Lorenzo Bernini Nº 149, Oficina 501 A, San Borja, Lima",
  "active": true,
  "source": "Bolsa de Valores de Lima (BVL)",
  "observedAt": "2026-08-10T14:34:45.456Z"
}
```

### Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace `<TOKEN>` with your Apify API token.

Run synchronously and get dataset items in one call:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~latam-stock-exchanges-scraper/run-sync-get-dataset-items?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"sectors":["CB"],"maxCompanies":25,"includeIndices":true}'
```

Start a run asynchronously:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~latam-stock-exchanges-scraper/runs?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"sectors":[],"maxCompanies":200,"includeFixedIncome":true}'
```

Apify CLI:

```bash
apify call scrapers_lat/latam-stock-exchanges-scraper \
  --input '{"sectors":["MINERAS"],"maxCompanies":10}'
```

### Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing `format`:

```bash
## JSON
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=json"

## CSV
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=csv"

## Paginate large datasets
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&offset=1000&limit=1000"
```

`<DATASET_ID>` is returned as `defaultDatasetId` in the run object. Use `offset` and `limit` to page through large result sets. `clean=true` drops empty and internal fields.

### Billing and limits

- **Pay per result.** You are charged per company/security record returned (`result` event). See the [pricing tab](https://apify.com/scrapers_lat/latam-stock-exchanges-scraper/pricing) for the current per-result price.
- **No charge on failure.** If a run errors, the actor writes a single item with a populated `error` field and does not charge for it. Empty runs cost nothing.
- **Spend cap respected.** Set `maxTotalChargeUsd` on the run; once reached, the actor stops emitting and charging further billable results.
- **Free Apify plans** are capped at 10 records per run. Upgrade for higher `maxCompanies`.

### FAQ and troubleshooting

**A run returned 0 records. Why?**
The sector filter matched no listed securities. Clear `sectors` to return all companies, or confirm the sector code. Zero-result runs are not charged.

**Which exchange does this cover?**
The Bolsa de Valores de Lima (BVL) in Peru. Records carry `exchange: BVL` and `country: Peru`.

**How do I filter by sector?**
Pass a BVL sector code (for example `CM` for mining) or a sector name substring (for example `MINERAS`) in `sectors`.

**Can I get index quotes too?**
Yes. Keep `includeIndices` on to add the exchange's headline index quotes as records with `recordType: index`.

**Why is a quote field null?**
The security did not trade in the session, or the source did not publish that value. Missing values are returned as `null`, never invented.

**Is this an official BVL tool?**
No. This actor is independent and has no affiliation with the Bolsa de Valores de Lima. It reads only data that the exchange publishes publicly. Use it in accordance with the BVL terms.

### Related scrapers

- [LATAM Central Banks FX Scraper](https://apify.com/scrapers_lat/latam-central-banks-fx-scraper): FX, policy and inflation rates from LATAM central banks.
- [Taiwan TWSE Disclosures Scraper](https://apify.com/scrapers_lat/taiwan-twse-disclosures-scraper): Taiwan Stock Exchange company disclosures.
- [SEC EDGAR Company Filings Scraper](https://apify.com/scrapers_lat/sec-edgar-filings-scraper): US SEC filings by ticker or CIK.

### More scrapers at scrapers.lat

Built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at [scrapers.lat](https://scrapers.lat).

***

> Independent tool, not affiliated with the Bolsa de Valores de Lima. Accesses only publicly available BVL data. Use in accordance with the BVL terms.

# Actor input Schema

## `sectors` (type: `array`):

Filter listed companies by sector. Accepts BVL sector codes (CB banks, CM mining, CI industrial, CP utilities, CG agrarian, CS insurance, CD diversified, FI investment funds, CA pension funds) or a sector name substring (for example 'MINERAS'). Leave empty to return every listed company.

## `maxCompanies` (type: `integer`):

Maximum number of company/security quote records to return.

## `includeIndices` (type: `boolean`):

Also return the exchange's headline index quotes (value, change %, open, high, low, close).

## `includeFixedIncome` (type: `boolean`):

Also include fixed-income securities (bonds) in addition to equities. Off by default (equities only).

## Actor input object example

```json
{
  "sectors": [
    "CM"
  ],
  "maxCompanies": 10,
  "includeIndices": true,
  "includeFixedIncome": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "sectors": [
        "CM"
    ],
    "maxCompanies": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/latam-stock-exchanges-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "sectors": ["CM"],
    "maxCompanies": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/latam-stock-exchanges-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "sectors": [
    "CM"
  ],
  "maxCompanies": 10
}' |
apify call scrapers_lat/latam-stock-exchanges-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/latam-stock-exchanges-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/nYODe3S5Xst35QedV/builds/oJ8fgV96rEUW45KTc/openapi.json