# Stack Exchange Scraper — Questions, Answers & Search API (`sian.agency/stack-exchange-scraper`) Actor

Scrape Stack Overflow & the Stack Exchange network into clean structured data — questions, answers, scores, views, tags, authors. Search by keyword, tag, or paste a URL; pull full Q\&A threads by id. JSON/CSV/Excel. No login or API key needed.

- **URL**: https://apify.com/sian.agency/stack-exchange-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** Developer tools, Automation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.30 / 1,000 question extracteds

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

## Stack Exchange Scraper — Questions, Answers & Search Data 🚀

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Store-Bluesky Scraper](https://img.shields.io/badge/Store-Bluesky%20Scraper-1185FE)](https://apify.com/sian.agency/bluesky-scraper?fpr=sian) [![Store-Xiaohongshu Scraper](https://img.shields.io/badge/Store-Xiaohongshu%20Scraper-FF2442)](https://apify.com/sian.agency/xiaohongshu-rednote-scraper?fpr=sian) [![Store-Instagram AI Transcript](https://img.shields.io/badge/Store-Instagram%20AI%20Transcript-E4405F)](https://apify.com/sian.agency/instagram-ai-transcript-extractor?fpr=sian)

#### 🎉 Turn Stack Overflow & the entire Stack Exchange network into a clean, structured Q&A dataset — in seconds
##### Built for developers, data teams, and researchers who need questions, answers, scores, tags, and authors at scale

---

### 📋 Overview

**Need Stack Overflow data without writing a single line of API code?** This actor pulls public questions and answers from Stack Overflow and every Stack Exchange site (Super User, Server Fault, Ask Ubuntu, Math Overflow, Unix, DBA, Security, and 170+ more) into a tidy dataset you can export to JSON, CSV, or Excel.

**Why thousands of professionals choose us:**
- ✅ **Whole network coverage**: one actor, any Stack Exchange site — just set the slug
- ⚡ **Fast & paginated**: pull hundreds of questions per run with rich fields, no rate-limit headaches
- 🎯 **Full Q&A threads**: fetch a question by id and get its complete answer list — scores, accepted flag, authors
- 💰 **Pay-per-result**: only pay for records you keep — transparent, best-in-class pricing
- 💎 **30+ structured fields**: titles, bodies, scores, views, tags, author reputation, timestamps, license
- ✨ **No login, no API key**: paste a tag, a keyword, or a URL and go

---

### ✨ Features

- 🔎 **Keyword Search**: search any site by phrase and collect matching questions
- 🏷️ **Tag & Listing Mode**: pull a tag's questions sorted by votes, activity, hot, week, or month
- 🔗 **Paste-a-URL**: drop a listing, tag, or search URL — the site and filters are read automatically
- 📄 **Full Detail Mode**: fetch specific questions by id (or URL) with their complete answer threads
- 💬 **Answer Extraction**: scores, accepted-answer flag, bodies, and authors for every answer
- ⭐ **Author Insights**: reputation, accept rate, profile link, and avatar for each poster
- 📊 **Field Coverage Score**: every record carries a 0–1 completeness signal
- 📦 **Clean Exports**: JSON, CSV, and Excel straight from the Apify dataset

---

### 🎬 Quick Start

Choose a mode, give it a site (or a URL), and run. Results stream into the dataset as they're scraped. Export when done.

```bash
curl -X POST https://api.apify.com/v2/acts/sian.agency~stack-exchange-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"scrapeMode": "overview", "site": "stackoverflow", "tagged": "python", "sort": "votes"}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Pick a mode

Choose **Overview** (many questions from a site/search) or **Detail** (full Q\&A for specific question ids).

#### Step 2: Set your target

Enter a site slug + tag/keyword, paste a Stack Exchange URL, or list question ids.

#### Step 3: Run & export

Start the actor and download your dataset as JSON, CSV, or Excel.

**That's it! In under a minute, you'll have:**

- A clean table of questions with scores, views, and tags
- Author details for every post
- Optional full answer threads for deep dives

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| scrapeMode | string | No | `overview` (list/search) or `detail` (full Q\&A by id) |
| site | string | No | Stack Exchange site slug (default `stackoverflow`) |
| searchQuery | string | No | Keyword phrase to search (Overview mode) |
| tagged | string | No | Tag filter, e.g. `python` or `python;pandas` |
| sort | string | No | Order: votes, activity, creation, hot, week, month, relevance |
| overviewUrl | string | No | Paste a listing/tag/search URL instead of fields |
| questionId | string | No | A single question id or URL (Detail mode) |
| questionIds | array | No | Bulk question ids/URLs (Detail mode) |
| fetchAnswers | boolean | No | Also fetch each question's answers (Detail mode) |
| maxResults | integer | No | Cap on records per run (FREE: 25, PAID: unlimited) |

**Example — search Stack Overflow:**

```json
{
  "scrapeMode": "overview",
  "site": "stackoverflow",
  "searchQuery": "branch prediction",
  "sort": "votes",
  "maxResults": 100
}
```

**Example — full Q\&A by id:**

```json
{
  "scrapeMode": "detail",
  "site": "stackoverflow",
  "questionIds": ["11227809", "927358"],
  "fetchAnswers": true
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **30+ fields** including:

| Field | Type | Description |
|-------|------|-------------|
| questionTitle | string | The question title |
| body | string | Question body (HTML) |
| score | number | Net votes on the question |
| view\_count | number | Total views |
| answer\_count | number | Number of answers |
| is\_answered | boolean | Whether it has an accepted/upvoted answer |
| tags | array | Tags applied to the question |
| owner\_display\_name | string | Author name |
| owner\_reputation | number | Author reputation |
| answers | array | Full answer list (Detail mode) |
| url | string | Canonical question URL |

**Example:**

```json
{
  "id": 11227809,
  "url": "https://stackoverflow.com/questions/11227809/...",
  "questionTitle": "Why is processing a sorted array faster than an unsorted array?",
  "score": 27536,
  "view_count": 1986979,
  "answer_count": 26,
  "is_answered": true,
  "accepted_answer_id": 11227902,
  "tags": ["java", "c++", "performance", "cpu-architecture"],
  "owner_display_name": "GManNickG",
  "owner_reputation": 507097,
  "answers": [
    { "id": 11227902, "score": 35286, "is_accepted": true, "owner_display_name": "Mysticial" }
  ]
}
```

***

### 💼 Use Cases & Examples

#### 1. Developer Research

**Engineers tracking solutions to a recurring error or library.**

**Input:** A keyword or tag like `kubernetes` on Server Fault
**Output:** Top-voted questions + accepted answers
**Use:** Build an internal knowledge base of vetted fixes.

#### 2. Tag & Topic Monitoring

**DevRel and community teams watching a tag's activity.**

**Input:** `site=stackoverflow, tagged=your-product, sort=creation`
**Output:** Newest questions mentioning the topic
**Use:** Spot unanswered questions and emerging issues early.

#### 3. Dataset Building for LLMs & Research

**Data scientists assembling high-quality Q\&A pairs.**

**Input:** A tag or search across one or many sites
**Output:** Questions + full answer threads with scores
**Use:** Curate training/eval data filtered by votes and acceptance.

#### 4. Competitive & Market Intelligence

**Product teams mining pain points around competitors.**

**Input:** Keyword searches for competitor tools
**Output:** Questions revealing gaps and complaints
**Use:** Inform roadmap and positioning.

#### 5. Content & SEO Research

**Writers finding the highest-demand developer questions.**

**Input:** `sort=votes` or `sort=week` on a tag
**Output:** Questions ranked by engagement
**Use:** Prioritize tutorials and docs that people actually search for.

#### 6. Academic & Trend Analysis

**Researchers studying developer behavior over time.**

**Input:** Creation-sorted listings with timestamps
**Output:** Time-stamped questions, view counts, tags
**Use:** Quantify topic growth and answer dynamics.

***

### 🔗 Integration Examples

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/stack-exchange-scraper').call({
  scrapeMode: 'overview',
  site: 'stackoverflow',
  tagged: 'python',
  sort: 'votes',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/stack-exchange-scraper').call(
    run_input={'scrapeMode': 'detail', 'questionIds': ['11227809'], 'fetchAnswers': True}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~stack-exchange-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode": "overview", "site": "superuser", "searchQuery": "ssh tunnel"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule or webhook
2. **HTTP Request**: Call actor API
3. **Process**: Handle JSON results
4. **Action**: Save, notify, or transform

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **25 records** per run — full feature access, same quality
- No credit card required
- Perfect for testing and small projects

#### PAID Tier (Production Ready)

- **Unlimited** records per run
- Faster processing, no delays
- Pay-per-result: only charged for successful results

💰 **Best price on the market** — transparent pay-per-record pricing with no subscriptions.

🔗 [View current pricing](https://apify.com/sian.agency/stack-exchange-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many records can I process?**
A: FREE tier: 25 per run. PAID tier: unlimited.

**Q: Which Stack Exchange sites are supported?**
A: All of them — set the `site` slug (stackoverflow, superuser, serverfault, askubuntu, mathoverflow, unix, dba, security, and 170+ more).

**Q: Can I get the answers, not just questions?**
A: Yes — use Detail mode with **Fetch Answers** on to get each question's full answer list.

**Q: Does it work with private or deleted content?**
A: No, only publicly accessible questions and answers are supported.

**Q: What output formats are available?**
A: JSON, CSV, Excel — export directly from the Apify dataset.

**Q: Do I need an API key or login?**
A: No. Just paste a tag, keyword, or URL and run.

**Q: Is this legal?**
A: Yes — we only extract publicly available data. See the legal section below.

***

### 🐛 Troubleshooting

**No results returned**

- Check the `site` slug is correct (e.g. `stackoverflow`, not `stack-overflow`)
- Make sure your tag/keyword actually matches questions on that site

**Fewer records than expected**

- FREE tier is capped at 25 per run — upgrade for unlimited
- Increase `maxPages` and `maxResults` for larger pulls

**Detail mode returns nothing for an id**

- Confirm the question id exists on the chosen `site` (ids are site-specific)

***

### ⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

> *Stack Overflow, Stack Exchange, Super User, Server Fault, Ask Ubuntu, and related marks are trademarks of Stack Exchange Inc. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Stack Exchange Inc.*

***

### 🤝 Support

[![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi)

**Join our active support community**

- For issues or questions, open an issue in the actor's repository
- Check [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools
- 📧 <apify@sian-agency.online>

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Actor input Schema

## `scrapeMode` (type: `string`):

**OVERVIEW** = cheap list mode. Pull many questions from a site by tag/sort, search by keyword, or paste a listing/tag/search URL — fast, paginated, rich question records.

**DETAIL** = full mode. Give specific question ids (or question URLs) and get the complete record plus, optionally, each question's full answer list with scores and authors.

## `site` (type: `string`):

Which network site to scrape. Use the API slug, e.g. `stackoverflow`, `superuser`, `serverfault`, `askubuntu`, `mathoverflow`, `unix`, `dba`, `security`. Applies to both modes.

💡 Default is `stackoverflow`.

## `searchQuery` (type: `string`):

**KEYWORD SEARCH:** A phrase to search the chosen site for (uses advanced search). Leave empty to list the site's questions by sort/tag instead.

**Examples:** `branch prediction`, `memory leak`, `async await`

💡 **TIP:** Combine with the Tag and Sort filters below to narrow results.

## `tagged` (type: `string`):

Restrict to questions with this tag (or several, semicolon-joined, e.g. `python;pandas`). Works with both listing and keyword search.

## `sort` (type: `string`):

Order for the question list.

- **Listing** (no query): `activity`, `votes`, `creation`, `hot`, `week`, `month`
- **Search** (with a query): `relevance`, `votes`, `activity`, `creation`

Leave empty for the smart default (`activity` for listings, `relevance` for search).

## `overviewUrl` (type: `string`):

Paste a Stack Exchange URL instead of choosing a site/query — the site and filters are read from it.

**Examples:**

- `https://stackoverflow.com/questions/tagged/python`
- `https://superuser.com/search?q=ssh`

When provided, this overrides the Site / Search Query / Tag fields.

## `questionId` (type: `string`):

**DETAIL MODE:** A question to fetch in full. Accepts a numeric id or a question URL.

**Examples:**

- `11227809`
- `https://stackoverflow.com/questions/11227809/why-is-conditional-processing`

## `questionIds` (type: `array`):

**BULK DETAIL:** A list of question ids or question URLs to fetch in full.

**TIER-BASED LIMITS:**

- **FREE users:** results capped per run
- **PAID users:** unlimited

💡 Click **Bulk edit** to paste one id/URL per line.

## `fetchAnswers` (type: `boolean`):

In **Detail** mode, also fetch each question's full answer list (scores, accepted flag, authors, bodies). One extra request per question.

## `answerSort` (type: `string`):

Order for the fetched answers: `votes` (highest first), `activity`, or `creation`.

## `answerPagesize` (type: `integer`):

How many answers to fetch per question (up to 100) when **Also Fetch Answers** is on.

## `pagesize` (type: `integer`):

How many questions to request per page (up to 100). Higher = fewer requests.

## `maxResults` (type: `integer`):

Hard cap on the total records saved this run. **FREE** runs are capped at 25 regardless of this value; **PAID** runs are unlimited.

## `maxPages` (type: `integer`):

How many pages to fetch in Overview mode (up to 100 questions each). Higher = more results, more cost.

## Actor input object example

```json
{
  "scrapeMode": "overview",
  "site": "stackoverflow",
  "searchQuery": "branch prediction",
  "tagged": "python",
  "sort": "",
  "overviewUrl": "https://stackoverflow.com/questions/tagged/python",
  "questionId": "11227809",
  "fetchAnswers": true,
  "answerSort": "votes",
  "answerPagesize": 100,
  "pagesize": 50,
  "maxResults": 100,
  "maxPages": 3
}
```

# Actor output Schema

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

Questions and answers extracted from Stack Exchange — titles, bodies, scores, views, tags, authors, and full answer threads.

## `scrapingSummary` (type: `string`):

HTML summary showing extracted and failed records with key run metrics.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/stack-exchange-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/stack-exchange-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 '{}' |
apify call sian.agency/stack-exchange-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sian.agency/stack-exchange-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Stack Exchange Scraper — Questions, Answers & Search API",
        "description": "Scrape Stack Overflow & the Stack Exchange network into clean structured data — questions, answers, scores, views, tags, authors. Search by keyword, tag, or paste a URL; pull full Q&A threads by id. JSON/CSV/Excel. No login or API key needed.",
        "version": "1.0",
        "x-build-id": "IJHmLuQsIChRpaw4x"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~stack-exchange-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-stack-exchange-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/sian.agency~stack-exchange-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-stack-exchange-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/sian.agency~stack-exchange-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-stack-exchange-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": {
                    "scrapeMode": {
                        "title": "🧭 Scrape Mode",
                        "enum": [
                            "overview",
                            "detail"
                        ],
                        "type": "string",
                        "description": "**OVERVIEW** = cheap list mode. Pull many questions from a site by tag/sort, search by keyword, or paste a listing/tag/search URL — fast, paginated, rich question records.\n\n**DETAIL** = full mode. Give specific question ids (or question URLs) and get the complete record plus, optionally, each question's full answer list with scores and authors.",
                        "default": "overview"
                    },
                    "site": {
                        "title": "🌐 Stack Exchange Site",
                        "type": "string",
                        "description": "Which network site to scrape. Use the API slug, e.g. `stackoverflow`, `superuser`, `serverfault`, `askubuntu`, `mathoverflow`, `unix`, `dba`, `security`. Applies to both modes.\n\n💡 Default is `stackoverflow`.",
                        "default": "stackoverflow"
                    },
                    "searchQuery": {
                        "title": "🔎 Search Query (Overview mode)",
                        "type": "string",
                        "description": "**KEYWORD SEARCH:** A phrase to search the chosen site for (uses advanced search). Leave empty to list the site's questions by sort/tag instead.\n\n**Examples:** `branch prediction`, `memory leak`, `async await`\n\n💡 **TIP:** Combine with the Tag and Sort filters below to narrow results."
                    },
                    "tagged": {
                        "title": "🏷️ Tag Filter (Overview mode)",
                        "type": "string",
                        "description": "Restrict to questions with this tag (or several, semicolon-joined, e.g. `python;pandas`). Works with both listing and keyword search."
                    },
                    "sort": {
                        "title": "↕️ Sort (Overview mode)",
                        "enum": [
                            "",
                            "activity",
                            "votes",
                            "creation",
                            "hot",
                            "week",
                            "month",
                            "relevance"
                        ],
                        "type": "string",
                        "description": "Order for the question list.\n- **Listing** (no query): `activity`, `votes`, `creation`, `hot`, `week`, `month`\n- **Search** (with a query): `relevance`, `votes`, `activity`, `creation`\n\nLeave empty for the smart default (`activity` for listings, `relevance` for search).",
                        "default": ""
                    },
                    "overviewUrl": {
                        "title": "🔗 Listing / Tag / Search URL (Overview mode, optional)",
                        "type": "string",
                        "description": "Paste a Stack Exchange URL instead of choosing a site/query — the site and filters are read from it.\n\n**Examples:**\n- `https://stackoverflow.com/questions/tagged/python`\n- `https://superuser.com/search?q=ssh`\n\nWhen provided, this overrides the Site / Search Query / Tag fields."
                    },
                    "questionId": {
                        "title": "📄 Single Question (Detail mode)",
                        "type": "string",
                        "description": "**DETAIL MODE:** A question to fetch in full. Accepts a numeric id or a question URL.\n\n**Examples:**\n- `11227809`\n- `https://stackoverflow.com/questions/11227809/why-is-conditional-processing`"
                    },
                    "questionIds": {
                        "title": "🚀 Bulk Questions (Detail mode)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "**BULK DETAIL:** A list of question ids or question URLs to fetch in full.\n\n**TIER-BASED LIMITS:**\n- **FREE users:** results capped per run\n- **PAID users:** unlimited\n\n💡 Click **Bulk edit** to paste one id/URL per line.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "fetchAnswers": {
                        "title": "💬 Also Fetch Each Question's Answers",
                        "type": "boolean",
                        "description": "In **Detail** mode, also fetch each question's full answer list (scores, accepted flag, authors, bodies). One extra request per question.",
                        "default": true
                    },
                    "answerSort": {
                        "title": "↕️ Answer Sort (Detail mode)",
                        "enum": [
                            "votes",
                            "activity",
                            "creation"
                        ],
                        "type": "string",
                        "description": "Order for the fetched answers: `votes` (highest first), `activity`, or `creation`.",
                        "default": "votes"
                    },
                    "answerPagesize": {
                        "title": "🔢 Answers Per Question",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "How many answers to fetch per question (up to 100) when **Also Fetch Answers** is on.",
                        "default": 100
                    },
                    "pagesize": {
                        "title": "📦 Questions Per Page (Overview mode)",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "How many questions to request per page (up to 100). Higher = fewer requests.",
                        "default": 50
                    },
                    "maxResults": {
                        "title": "🔢 Max Records Per Run",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Hard cap on the total records saved this run. **FREE** runs are capped at 25 regardless of this value; **PAID** runs are unlimited.",
                        "default": 100
                    },
                    "maxPages": {
                        "title": "📄 Max Pages (Overview mode)",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "How many pages to fetch in Overview mode (up to 100 questions each). Higher = more results, more cost.",
                        "default": 3
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
