# Crypto Fear and Greed Index Scraper (`parseforge/alternative-me-fear-greed-scraper`) Actor

Pull the daily Alternative.me Crypto Fear and Greed Index. Returns the 0-100 sentiment score and its classification (Extreme Fear to Extreme Greed) for every day in the requested history window.

- **URL**: https://apify.com/parseforge/alternative-me-fear-greed-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $27.75 / 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/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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 😨 Crypto Fear and Greed Index Scraper

> 🚀 **Export the Crypto Fear and Greed Index in seconds.** Pull the daily 0-100 sentiment score plus its classification, going back to **February 2018**, in a single run. No sign-up, no token plumbing, no manual paging.

> 🕒 **Last updated:** 2026-05-15 · **📊 7 fields** per record · **📅 2018-02-01 → today** · **📈 Daily readings** · **🔁 Live per run**

The **Crypto Fear and Greed Index Scraper** queries the alternative.me sentiment feed and returns **7 fields per day**, including the 0-100 index value, the textual classification (Extreme Fear, Fear, Neutral, Greed, Extreme Greed), the source timestamp in ISO and Unix form, the time until the next update, and a scrape timestamp. The index is the most widely cited crypto-sentiment gauge, blending volatility, market momentum, social signals, dominance, and survey data into a single daily reading.

The dataset covers **every day from 2018-02-01 to today** (2,500+ readings as of mid-2026), plus the live current-day value. This Actor streams the chosen window as CSV, Excel, JSON, or XML in under thirty seconds. Pick the last 30 days, the last year, or the entire history with one parameter.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Crypto traders, sentiment analysts, content creators, fund managers, journalists, ML researchers, dashboard builders | Sentiment overlays on price charts, contrarian-trading signals, regime classification, weekly newsletter charts, ML feature engineering, social-media content |

---

### 📋 What the Crypto Fear and Greed Index Scraper does

Two run modes in a single Actor:

- 📅 **Window mode.** Pull the last N days (1-5000) of daily readings.
- 📜 **Full history mode.** Pass `limit: 0` to pull every reading back to February 2018.

Each record includes the calendar date, the index value (0 = extreme fear, 100 = extreme greed), the textual classification bucket, both ISO and Unix timestamps, and the seconds until the next scheduled update.

> 💡 **Why it matters:** crypto sentiment swings drive flows. A daily 0-100 score with a 7+ year history is a rare, clean feature for trading systems, content pipelines, and macro dashboards. This Actor turns that history into a downloadable dataset in one click.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded sentiment dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>limit</code></td><td>integer</td><td><code>30</code></td><td>Number of days of history to pull, starting from today. Use <code>0</code> for full history back to 2018-02-01.</td></tr>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free plan caps at 10, paid plan at 1,000,000.</td></tr>
</tbody>
</table>

**Example: last 365 days for a yearly chart.**

```json
{
    "limit": 365,
    "maxItems": 365
}
````

**Example: full history back to 2018.**

```json
{
    "limit": 0,
    "maxItems": 5000
}
```

> ⚠️ **Good to Know:** the index updates once per day, so consecutive intra-day runs return the same value until the next scheduled update. The `timeUntilUpdateSeconds` field tells you how long until the source publishes the next reading. The `value` field is the official daily snapshot, not a rolling average.

***

### 📊 Output

Each daily reading record contains **7 fields**. Download the dataset as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 📅 `date` | string (YYYY-MM-DD) | `"2026-05-15"` |
| 📊 `value` | number | `64` |
| 🏷️ `valueClassification` | string | `"Greed"` |
| 🕒 `timestamp` | ISO 8601 | `"2026-05-15T00:00:00.000Z"` |
| 🕒 `timestampUnix` | number | `1779638400` |
| 🕒 `timeUntilUpdateSeconds` | number | `41832` |
| 🕒 `scrapedAt` | ISO 8601 | `"2026-05-15T00:00:00.000Z"` |

#### 📦 Sample records

<details>
<summary><strong>📈 Greed reading: a recent day in a bull regime</strong></summary>

```json
{
    "date": "2026-05-15",
    "value": 64,
    "valueClassification": "Greed",
    "timestamp": "2026-05-15T00:00:00.000Z",
    "timestampUnix": 1779638400,
    "timeUntilUpdateSeconds": 41832,
    "scrapedAt": "2026-05-15T00:00:00.000Z"
}
```

</details>

<details>
<summary><strong>📉 Extreme Fear reading: COVID crash, March 2020</strong></summary>

```json
{
    "date": "2020-03-13",
    "value": 8,
    "valueClassification": "Extreme Fear",
    "timestamp": "2020-03-13T00:00:00.000Z",
    "timestampUnix": 1584057600,
    "scrapedAt": "2026-05-15T00:00:00.000Z"
}
```

</details>

<details>
<summary><strong>😱 Extreme Greed reading: ATH cycle peak, November 2021</strong></summary>

```json
{
    "date": "2021-11-09",
    "value": 84,
    "valueClassification": "Extreme Greed",
    "timestamp": "2021-11-09T00:00:00.000Z",
    "timestampUnix": 1636416000,
    "scrapedAt": "2026-05-15T00:00:00.000Z"
}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 📅 | **7+ years of daily history.** Continuous coverage from 2018-02-01 to today, including major bull and bear regimes. |
| 🎯 | **One-parameter window.** Last 30 days for chart overlays, full history for backtests. |
| 🧾 | **7 fields per record.** Date, 0-100 score, textual class, ISO and Unix timestamps, and update countdown. |
| ⚡ | **Fast.** 30 days in under 2 seconds, full history in under 5 seconds. |
| 🔁 | **Live per run.** Today's reading plus the historical tail in a single pull. |
| 🚫 | **No authentication.** Public daily index. No login, no token. |
| 📥 | **Multi-format export.** CSV, Excel, JSON, or XML, ready for spreadsheets, warehouses, or pipelines. |

> 📊 A clean, dated 0-100 sentiment series is a foundational feature for crypto research, content, and trading systems.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ Crypto Fear and Greed Index Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **2018 → today** | **Live per run** | last N days, full history | ⚡ 1 min |
| Hand-rolled feed client | Free + dev time | Full | Per request | Custom code | 🐢 Hours |
| Commercial sentiment vendors | $$$ / month | Multi-source | Hourly | Many | ⏳ Hours |
| Manual portal screenshots | Free | One day at a time | Daily | None | 🕒 Tedious |

Pick this Actor when you want a clean, dated sentiment series with no plumbing, ready for charts, alerts, and ML features.

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Go to the Crypto Fear and Greed Index Scraper page on the Apify Store.
3. 🎯 **Set input.** Pick a history window (or `0` for full history) and set `maxItems`.
4. 🚀 **Run it.** Click **Start** and let the Actor pull your daily readings.
5. 📥 **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to downloaded dataset: **2-4 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 📊 Trading & Strategy Research

- Contrarian entry signals at extreme-fear readings
- Risk-off triggers when greed crosses key thresholds
- Regime-classification overlays on price models
- Mean-reversion studies on the 0-100 score

</td>
<td width="50%" valign="top">

#### 📰 Content & Newsletters

- Weekly market-sentiment recaps with charts
- Headline imagery driven by today's classification
- Social posts on regime flips (Fear to Greed)
- Year-in-review charts of sentiment swings

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🤖 ML & Quant Pipelines

- Feature engineering for crypto-price models
- Sentiment-aware portfolio rebalancing
- Backtesting datasets for systematic strategies
- Composite indicators blending sentiment and on-chain data

</td>
<td width="50%" valign="top">

#### 📱 Apps & Dashboards

- Mobile-app sentiment widgets
- Trading-platform sidebar feeds
- Discord and Telegram daily-sentiment bots
- Portfolio dashboards with sentiment overlays

</td>
</tr>
</table>

***

### 🔌 Automating Crypto Fear and Greed Index Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. A daily run after the source updates keeps your sentiment time-series in sync with no manual work.

***

### 🌟 Beyond business use cases

The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Behavioural-finance studies of crypto sentiment
- Time-series analyses linking sentiment to price returns
- Coursework on market psychology and indicators
- Reproducible studies with cited dataset pulls

</td>
<td width="50%">

#### 🎨 Personal and creative

- Hobbyist sentiment dashboards and journals
- Visual art driven by daily sentiment colours
- Personal trading journals with daily index context
- Side projects exploring sentiment-driven content

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Educational explainers on market psychology
- Open datasets for student investing clubs
- Transparent benchmarks for community trading challenges
- Resources for new crypto investors learning emotion control

</td>
<td width="50%">

#### 🧪 Experimentation

- Train classifiers that predict next-day index moves
- Validate sentiment-app product ideas with real history
- Prototype agent pipelines that summarise weekly mood
- Test newsletter content cadences with live sentiment

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Crypto%20Fear%20and%20Greed%20Index%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Crypto%20Fear%20and%20Greed%20Index%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Crypto%20Fear%20and%20Greed%20Index%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Crypto%20Fear%20and%20Greed%20Index%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### 🧩 How does it work?

Pick a window of N days (or `0` for full history) and click Start. The Actor pulls the daily readings and returns one structured record per day, oldest to newest. No browser automation, no captchas, no setup.

#### 📏 How accurate is the index?

The index is the official 0-100 daily score published by alternative.me, blending volatility, momentum, dominance, social, and survey signals. It's a sentiment proxy, not a price prediction.

#### 🔁 How often does the index refresh?

Once per day. The `timeUntilUpdateSeconds` field on each record tells you how long until the source publishes the next reading.

#### 📅 How far back does the history go?

To 2018-02-01. Pass `limit: 0` to pull the entire history (around 2,500+ daily readings as of mid-2026), or pass any positive number for a window starting today.

#### 🏷️ What do the classifications mean?

The 0-100 score maps to five buckets: Extreme Fear (0-24), Fear (25-49), Neutral (50), Greed (51-74), Extreme Greed (75-100). The `valueClassification` field returns the textual label.

#### ⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor daily after the source's update window and keep a downstream database in sync.

#### ⚖️ Is this data legal to use?

The index is publicly published for research and reference use. Always credit the source if you embed it in a public dashboard or article.

#### 💼 Can I use this data commercially?

Yes, with attribution. The index is widely cited in newsletters, dashboards, and trading content. Always credit the source per its terms.

#### 💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you scheduling, higher concurrency, and larger datasets.

#### 🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

#### 🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

***

### 🔌 Integrate with any app

Crypto Fear and Greed Index Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe sentiment data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh sentiment readings into your trading dashboard, or alert your team in Slack when the regime flips.

***

### 🔗 Recommended Actors

- [**📈 Deribit Options Summary Scraper**](https://apify.com/parseforge/deribit-options-summary-scraper) - Crypto options chain with mark price, IV, and OI
- [**📊 Federal Reserve H.15 Rates Scraper**](https://apify.com/parseforge/federalreserve-h15-rates-scraper) - Daily U.S. interest rates and yield curve
- [**📈 Indexmundi Scraper**](https://apify.com/parseforge/indexmundi-scraper) - Global demographic and economic indicators
- [**🔋 UK Carbon Intensity Scraper**](https://apify.com/parseforge/carbon-intensity-uk-scraper) - National Grid live and forecast carbon intensity
- [**📦 NuGet Packages Scraper**](https://apify.com/parseforge/nuget-packages-scraper) - .NET package catalogue and download history

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by alternative.me or any sentiment-data provider. All trademarks mentioned are the property of their respective owners. Only publicly available index readings are collected. Nothing in this dataset constitutes financial advice; always do your own research before trading.

# Actor input Schema

## `limit` (type: `integer`):

How many days of history to pull from the upstream feed, starting today. Use 0 to pull the entire archive (back to 2018-02-01). The free-user output cap (10 items) is applied separately via 'Max Items'.

## `dateFormat` (type: `string`):

Locale used for the upstream date string. Choose 'us' for MM-DD-YYYY, 'cn' for YYYY-MM-DD, 'kr' for YYYY.MM.DD, 'jp' for YYYY/MM/DD, or 'world' (default) for the Unix timestamp.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## Actor input object example

```json
{
  "limit": 30,
  "dateFormat": "",
  "maxItems": 10
}
```

# Actor output Schema

## `overview` (type: `string`):

Overview of scraped data

## `fullData` (type: `string`):

Complete dataset

# 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 = {
    "limit": 30,
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/alternative-me-fear-greed-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 = {
    "limit": 30,
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/alternative-me-fear-greed-scraper").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 '{
  "limit": 30,
  "maxItems": 10
}' |
apify call parseforge/alternative-me-fear-greed-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/alternative-me-fear-greed-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Crypto Fear and Greed Index Scraper",
        "description": "Pull the daily Alternative.me Crypto Fear and Greed Index. Returns the 0-100 sentiment score and its classification (Extreme Fear to Extreme Greed) for every day in the requested history window.",
        "version": "0.0",
        "x-build-id": "s88XjfbRf92ZfQNOc"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~alternative-me-fear-greed-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-alternative-me-fear-greed-scraper",
                "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/parseforge~alternative-me-fear-greed-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-alternative-me-fear-greed-scraper",
                "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/parseforge~alternative-me-fear-greed-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-alternative-me-fear-greed-scraper",
                "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": {
                    "limit": {
                        "title": "History days",
                        "minimum": 0,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "How many days of history to pull from the upstream feed, starting today. Use 0 to pull the entire archive (back to 2018-02-01). The free-user output cap (10 items) is applied separately via 'Max Items'.",
                        "default": 30
                    },
                    "dateFormat": {
                        "title": "Date format",
                        "enum": [
                            "",
                            "us",
                            "cn",
                            "kr",
                            "jp"
                        ],
                        "type": "string",
                        "description": "Locale used for the upstream date string. Choose 'us' for MM-DD-YYYY, 'cn' for YYYY-MM-DD, 'kr' for YYYY.MM.DD, 'jp' for YYYY/MM/DD, or 'world' (default) for the Unix timestamp.",
                        "default": ""
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
