Stock Information Extractor

---

TL;DR

• Input: One search query (company name or ticker)
• Output: List of matching stocks with symbol, names, exchange, quote type, and market data
• Use it for: Dashboards, automation, symbol lookup, portfolio tools
• Result time: Usually under a few seconds

---

Table of contents

• Try it now
• Overview
• Usage examples
• Features
• Configuration
• Usage
• Output
• For bloggers & tutorial writers
• Integration
• Technical details
• FAQ
• Resources

---

Try it now

Action	Link
Run in Apify Console	Open Actor → Start
API (sync)	POST https://api.apify.com/v2/acts/YOUR_USERNAME~stock-information-extractor/run-sync

Replace YOUR_USERNAME with your Apify username.

---

Overview

The Stock Information Extractor searches stocks via the MultipleWords assets API and returns market values. You provide a search term (company name or ticker), and the Actor returns a list of matching instruments with symbol, short name, long name, exchange, quote type, and market data (price, volume, market cap, 52-week range).

This Actor is useful when you need stock lookups on demand, in workflows, or as part of an automated pipeline.

Common use cases

Category	Examples
Content	Dashboards, symbol lookup, autocomplete
Marketing	Portfolio tools, research, data pipelines
Automation	Scheduled lookups, workflows, bots
Development	Mock data, demos, internal tools

Note: Usage rights depend on the upstream API and your Apify plan. Review terms before commercial use.

---

Usage examples

Paste these into the Search query field or API input.

Scenario	Query
Apple	apple
Tesla	tesla
By ticker	AAPL
Hospitality REIT	APLE

---

Features

• Stock search by name or ticker
• Returns market values (price, volume, market cap, 52-week range)
• Clean JSON output for easy integration
• Input validation and retries with backoff
• Runs fully on Apify (Console, API, automation tools)

---

Configuration

All settings are provided via the Actor input.

Input parameters

Parameter	Type	Required	Default	Description
q	string	No	apple	Search term (company name or ticker)

Search tips

• Use company name (e.g. apple, tesla) or ticker (e.g. AAPL).
• Leave empty to use the default search (apple).

Example input

{
  "q": "apple"
}

---

Usage

Apify Console

1. Open the Actor in Apify Console.
2. Enter a search query in the Search query field (or use the default).
3. Click Start and check the Output tab for the list of matching stocks and market data.

API (run-sync)

Replace YOUR_USERNAME with your Apify username and YOUR_API_TOKEN with your Apify API token.

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~stock-information-extractor/run-sync?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"q": "apple"}'

Response includes runId, status, and dataset items with query and results array.

---

Output

Each run writes one or more items to the default dataset. Each item looks like:

Field	Description
query	Search query used
results	Array of matching stocks with market values

Each item in results has:

Field	Description
symbol	Ticker symbol (e.g. AAPL, APLE)
shortName	Short name (e.g. Apple Inc.)
longName	Long name (e.g. Apple Inc.)
currency	Currency code
exchange	Exchange code (e.g. NMS, NYQ, FRA)
quoteType	Quote type (e.g. EQUITY, ETF)
currentPrice	Current price
regularMarketPrice	Regular market price
previousClose	Previous close
open	Open price
dayHigh	Day high
dayLow	Day low
volume	Volume
marketCap	Market cap
fiftyTwoWeekHigh	52-week high
fiftyTwoWeekLow	52-week low
averageVolume	Average volume

Example output (dataset item)

{
  "query": "apple",
  "results": [
    {
      "symbol": "AAPL",
      "shortName": "Apple Inc.",
      "longName": "Apple Inc.",
      "currency": "USD",
      "exchange": "NMS",
      "quoteType": "EQUITY",
      "currentPrice": 225.50,
      "regularMarketPrice": 225.50,
      "previousClose": 224.20,
      "open": 224.50,
      "dayHigh": 226.10,
      "dayLow": 223.80,
      "volume": 45000000,
      "marketCap": 3500000000000,
      "fiftyTwoWeekHigh": 235.00,
      "fiftyTwoWeekLow": 165.00,
      "averageVolume": 52000000
    }
  ]
}

In the Apify Console Output tab you can view the table of results (query, symbol, short name, long name, currency, exchange, quote type, prices, volume, market cap, 52-week range).

---

For bloggers & tutorial writers

You can use this Actor in tutorials, blog posts, or videos without running it first:

• Input: Use the Example input or Usage examples table.
• Output: Use the Example output above to show what users get.
• API: Use the API (run-sync) curl example; remind readers to replace YOUR_USERNAME and YOUR_API_TOKEN.

---

Integration

• Make (Integromat) — Use the Apify module and select this Actor; map your search term to the Search query input.
• Zapier — Use the Apify Zapier app and choose "Run Actor"; select this Actor and pass the query.
• Custom apps — Call the Apify API (/run or /run-sync) with the same input JSON.

---

Technical details

• Runtime: Node.js (see Dockerfile).
• Input: Validated against the input schema; invalid input returns a clear error.
• External API: GET https://multiplewords.com/assets_management/api/stocks/search_with_values/?q=...; failures are retried with backoff.

---

FAQ

How long does a run take?
Usually under a few seconds for a single search.

Can I search by ticker?
Yes. Use q as a company name or a ticker symbol (e.g. AAPL).

What market data is returned?
Each result includes current price, previous close, open, day high/low, volume, market cap, 52-week high/low, and average volume when available from the API.

Do I need an API key for the stocks API?
The Actor uses its own integration; you only need your Apify account and (for API calls) your Apify API token.

---

Resources

• Apify Console — Run the Actor and view datasets
• Apify API — Run actors programmatically