# Copilot Answers Scraper — Prompts & Citations (`sian.agency/copilot-answers-scraper`) Actor

Retrieve reply text and returned citations. One completed request creates one exportable JSON record with the returned data. Only Copilot answers are included.

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

## Pricing

from $157.14 / 1,000 completed copilot answer records

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Copilot Answers Scraper 💬

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Google Search Scraper](https://img.shields.io/badge/Store-Google%20Search%20Scraper-4285F4)](https://apify.com/sian.agency/google-serp-scraper?fpr=sian) [![Google News Scraper](https://img.shields.io/badge/Store-Google%20News%20Scraper-4285F4)](https://apify.com/sian.agency/google-news-scraper?fpr=sian) [![Bing Search Scraper](https://img.shields.io/badge/Store-Bing%20Search%20Scraper-4285F4)](https://apify.com/sian.agency/bing-search-scraper?fpr=sian)

#### 💬 One request, one complete record

##### Export the returned information and check the actual result.

### 🔎 What is the Copilot Answers Scraper — and when should you use it?

The **Copilot Answers Scraper** turns reply text and returned citations into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

**Use it when you need:** one Copilot answer and its returned references for your own review.

**Use something else when:** you need organic search results rather than an assistant answer. Use [Google Search Scraper](https://apify.com/sian.agency/google-serp-scraper?fpr=sian) for organic search results rather than an assistant answer. Only Copilot answers are included. No engine selector, conversations, generation settings or guaranteed web search. Answers may be inaccurate and citations may not support every statement.

### 🤖 Use with AI agents

Already connected to the [Apify MCP server](https://mcp.apify.com)? Just ask for this Actor by name: sian.agency/copilot-answers-scraper

**Agentic payments:** Availability of [x402](https://www.x402.org/) and [Skyfire](https://www.skyfire.xyz/) depends on this Actor's current Store eligibility. Check the published listing for supported payment methods. One completed response record is charged. Failed retrievals have no result-event charge; a separate run-start fee applies.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
I want Copilot research using the Apify Actor `sian.agency/copilot-answers-scraper`.

Use it when I need: one Copilot answer and its returned references for your own review.

Don't use it when: you need organic search results rather than an assistant answer — use google-serp-scraper instead.

How to call it: set operation to answer and provide prompt. Read the full completed record.

Start with this input:
{
  "operation": "answer",
  "prompt": "What is the capital of France? Reply in one sentence."
}

Ask me which question I want to ask Copilot, then run the Actor and summarise the results as a table.
```

**Things you can ask your agent for:**

- *Retrieve reply text and returned citations and save JSON.*
- *Run Copilot Answers Scraper and summarize the returned information.*
- *Save a completed Copilot observation for comparison.*

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at [apify.com/sian.agency/copilot-answers-scraper.md](https://apify.com/sian.agency/copilot-answers-scraper.md).

### 📋 Overview

Copilot Answers Scraper saves one prompt and its returned Copilot reply in an Apify dataset. Keep the full citations array when you want to inspect the references yourself. A completed answer is one record.

Only Copilot is included. Replies may be inaccurate, citations can be absent, and the actor does not guarantee a web search or provide a conversation interface.

***

### ✨ Features

- 💬 **Complete record**: One successful request creates one exportable observation.
- 💬 **Answer and references**: Keep the returned answer text and full citation list. Citations are not a guarantee of accuracy.
- 💬 **Focused scope**: Only Copilot answers are included.
- 💬 **JSON export**: Preserve nested fields and arrays without flattening away information.
- 💬 **Run report**: Review results, billing and retry advice in the Output tab.
- 💬 **Input validation**: Unsupported fields and invalid inputs stop before retrieval.
- 💬 **Scheduled observations**: Use Apify scheduling to build your own saved history.

***

### 🎬 Quick Start

Choose answer, supply the prompt and run the actor. Open the dataset when the request finishes. The Console example is a prefill; API callers supply their own work input.

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~copilot-answers-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' -d '{"operation": "answer", "prompt": "What is the capital of France? Reply in one sentence."}'
```

### 🚀 Getting Started

#### Step 1: Enter the subject

Provide a specific prompt to retrieve.

#### Step 2: Run the actor

Review the live price and start one request.

#### Step 3: Inspect the result

Download JSON to preserve the complete nested record. Check status and any source values before using the data.

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|---|---|---|---|
| operation | select | No | answer |
| prompt | string | Yes at runtime | Subject of this request; no API default |

```json
{
  "operation": "answer",
  "prompt": "What is the capital of France? Reply in one sentence."
}
```

Only Copilot answers are included. No engine selector, conversations, generation settings or guaranteed web search. Answers may be inaccurate and citations may not support every statement.

***

### 📤 Output

| Field | Type | Description |
|---|---|---|
| prompt | string | Prompt |
| replyText | string | Answer |
| citations | array | Citations |
| citationCount | integer | Citations |
| conversationId | string | Conversation ID |
| complete | boolean | Whether retrieval completed |
| \_fetchedAt | string | Observation time |
| processedAt | string | UTC ISO observation timestamp |
| scrapingDate | string | Same UTC ISO timestamp as processedAt |
| status | string | success or error |

```json
{
  "status": "success",
  "complete": true,
  "prompt": "What is the capital of France? Reply in one sentence.",
  "replyText": "The capital of France is Paris.\nDirect answer: Paris is the political, cultural, and economic center of France and has served as the nation’s capital for most of its modern history.\nKey facts\nParis functions as the seat of the French government, including the Élysée Palace (the president’s residence) and the National Assembly.\nIt is also France’s largest city, known for major landmarks such as the Eiffel Tower, Louvre Museum, and Notre‑Dame Cathedral.\nThe city lies in the Île‑de‑France region in northern France and is a major global hub for finance, diplomacy, and culture.\nAdditional context\nParis has been the capital since the 10th century, with only brief interruptions.\nIt remains one of the most visited cities in the world and a central node in European politics and transportation.\nIf you’d like, I can also provide a brief history of how Paris became the capital or compare it with other major French cities.",
  "citations": [
    {
      "title": "Paris - Wikipedia",
      "url": "https://en.wikipedia.org/wiki/Paris",
      "publisher": "en.wikipedia.org",
      "icon_url": "blob:https://www.bing.com/bb579513-98a1-4b2d-a0d8-9fb7c844d51f"
    },
    {
      "title": "What is the capital city of France and why is it famous?",
      "url": "https://www.britannica.com/question/What-is-the-capital-city-of-France-and-why-is-it-famous",
      "publisher": "britannica.com",
      "icon_url": "blob:https://www.bing.com/fc37d8d1-8a15-46f6-b30c-0147354fe358"
    },
    {
      "title": "What is the Capital of France? - Mappr",
      "url": "https://www.mappr.co/capital-cities/france/",
      "publisher": "mappr.co",
      "icon_url": "blob:https://www.bing.com/f950cf15-2a4a-45eb-9a35-de47e3d00ef0"
    },
    {
      "title": "What is the capital of France? Overview of Paris - iroamly.com",
      "url": "https://www.iroamly.com/france-travel/what-is-the-capital-of-france.html",
      "publisher": "iroamly.com",
      "icon_url": "blob:https://www.bing.com/2f0c7bb7-4ed6-49e7-acf0-82dd8a197809"
    },
    {
      "title": "What is the state and capital of France? - StudyCountry.com",
      "url": "https://www.studycountry.com/wiki/what-is-the-state-and-capital-of-france",
      "publisher": "studycountry.com",
      "icon_url": "blob:https://www.bing.com/55c11626-db4e-4fa2-b829-451b364451ed"
    },
    {
      "title": "What is the Capital of France? - WorldAtlas",
      "url": "https://www.worldatlas.com/articles/what-is-the-capital-of-france.html",
      "publisher": "worldatlas.com",
      "icon_url": "blob:https://www.bing.com/690e4ded-75e1-4d6a-8941-7d4f66422c98"
    },
    {
      "title": "Paris — France | World Capitals",
      "url": "https://world-capitals.org/en/capitals-capital_france/",
      "publisher": "world-capitals.org",
      "icon_url": "blob:https://www.bing.com/8ab2bb7c-dcd7-4a22-8a17-b48694df56e4"
    },
    {
      "title": "What is the capital of France? - howengineeringworks.com",
      "url": "https://www.howengineeringworks.com/questions/what-is-the-capital-of-france/",
      "publisher": "howengineeringworks.com",
      "icon_url": "blob:https://www.bing.com/fccc8aea-e7a3-4eb1-8efb-0fb21759cb90"
    },
    {
      "title": "What is the Capital of France? Paris – Countryaah.com",
      "url": "https://countryaah.com/france-faqs/",
      "publisher": "countryaah.com",
      "icon_url": "blob:https://www.bing.com/10a75506-a3f6-4501-a118-1bc96dcd2d59"
    },
    {
      "title": "Capital of France: Paris — Capitalle",
      "url": "https://capitalle.app/capitals/france",
      "publisher": "capitalle.app",
      "icon_url": "blob:https://www.bing.com/83bb15ba-7cc4-4f48-8388-f1c3eb3ccb94"
    }
  ],
  "citationCount": 10,
  "conversationId": null
}
```

The example shows a recorded response. Optional values can be absent, and results can change between runs.

***

### 💼 Use Cases & Examples

#### 1. AI researchers

Ask a defined question and retain the complete reply with its returned references. Compare your saved answers across scheduled runs, while remembering that this actor does not expose a model version or generation controls.

#### 2. Brand analysts

Submit a question that matters to your category and inspect whether the answer mentions a brand. This is one answer observation; it does not calculate visibility scores, market share or a representative ranking.

#### 3. Content editors

Use a prompt to draft an outline or gather starting points, then review the returned answer before incorporating it into a publication. Keep the prompt beside the response so another editor can see what was asked.

#### 4. Fact checkers

Open the URLs in citations and check whether they support the specific claims you plan to use. An answer can have no citations, and the presence of citations does not establish accuracy.

#### 5. Data teams

Export prompt, replyText and the full citations array as JSON for your own analysis. Keep the optional conversation identifier as returned metadata; the actor does not accept it to continue a conversation.

#### 6. Automation teams

Send one prompt from an Apify schedule, Make, Zapier or N8N workflow and route the completed answer to review or storage. A retrieval failure has no completed-answer charge; check the run reason before starting another request.

***

### 🔗 Integration Examples

#### JavaScript

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('sian.agency/copilot-answers-scraper').call({"operation": "answer", "prompt": "What is the capital of France? Reply in one sentence."});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')
run = client.actor('sian.agency/copilot-answers-scraper').call(run_input={'operation': 'answer', 'prompt': 'What is the capital of France? Reply in one sentence.'})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~copilot-answers-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' -d '{"operation": "answer", "prompt": "What is the capital of France? Reply in one sentence."}'
```

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

1. Start from a schedule or webhook.
2. Run the actor with the intended prompt.
3. Check the record's status and content.
4. Save the result or pass it to your next workflow step.

***

### 📊 Performance & Pricing

One completed response record is charged once. Failed retrievals have no result-event charge. A separate platform run-start fee applies, including invalid or stopped runs.

Service-error text is a retrieval failure and has no answer-event charge. A useful answer can still be wrong; verify claims and citations before acting on it.

Paid Apify plans receive tier discounts. Free-plan users can test one record per run in the Console or MCP; direct API access requires a paying plan. [Check the live price](https://apify.com/sian.agency/copilot-answers-scraper?fpr=sian) before starting.

***

### ❓ Frequently Asked Questions

**Q: What is charged?**

One completed request record. Failed retrievals have no result-event charge. The separate platform run-start fee applies.

**Q: What is supported?**

Only Copilot answers are included. No engine selector, conversations, generation settings or guaranteed web search. Answers may be inaccurate and citations may not support every statement.

**Q: Can I use the actor through the API?**

Yes, using a paying Apify plan. Free-plan users can test from the Console or MCP.

**Q: Does an empty API input run the example?**

No. The work input has a Console prefill and no API default.

**Q: Which export keeps full detail?**

JSON preserves nested data. CSV and Excel encode nested structures as text.

***

### 🐛 Troubleshooting

**Request did not complete**

- Check the input, then retry later. A failed retrieval has no result-event charge.

**Request stopped before retrieval**

- Check your maximum charge, available credits and free-run allowance.

**A returned field is missing**

- Optional fields depend on the response. Do not infer a value that was not returned.

**Data differs between runs**

- Keep the observation time and compare the actual returned records. Results may change.

***

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

Use public information for a lawful purpose and respect applicable rights and source terms. Public availability does not itself grant a redistribution license. This actor does not grant permission to reuse third-party content.

Results may contain personal data. Establish an appropriate legal basis under GDPR or other applicable rules before processing it. Read [Apify's overview of web scraping legality](https://blog.apify.com/is-web-scraping-legal/) and obtain advice for your use case when needed.

Copilot names belong to their respective owners. SIÁN Agency is independent and is not affiliated with or endorsed by those owners.

***

### 🤝 Support

Open an [actor issue](https://apify.com/sian.agency/copilot-answers-scraper/issues) with the run link and input. Send questions to <apify@sian-agency.online>.

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

# Changelog

This Actor's version history is a separate document: https://apify.com/sian.agency/copilot-answers-scraper/changelog.md

# Actor input Schema

## `operation` (type: `string`):

One documented request per run. A complete response is billed once. Failed retrievals have no result-event charge; the platform run-start fee still applies.

## `prompt` (type: `string`):

Provide the subject of this request. The Console example is prefilled; API calls must supply their own value. Only Copilot answers are included. No engine selector, conversations, generation settings or guaranteed web search. Answers may be inaccurate and citations may not support every statement.

## Actor input object example

```json
{
  "operation": "answer",
  "prompt": "What is the capital of France? Reply in one sentence."
}
```

# Actor output Schema

## `copilotCompletedRecords` (type: `string`):

One completed record with reply text and returned citations. Only Copilot answers are included. No engine selector, conversations, generation settings or guaranteed web search. Answers may be inaccurate and citations may not support every statement.

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

HTML summary showing successful and failed results with key 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 = {
    "operation": "answer",
    "prompt": "What is the capital of France? Reply in one sentence."
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/copilot-answers-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 = {
    "operation": "answer",
    "prompt": "What is the capital of France? Reply in one sentence.",
}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/copilot-answers-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 '{
  "operation": "answer",
  "prompt": "What is the capital of France? Reply in one sentence."
}' |
apify call sian.agency/copilot-answers-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sian.agency/copilot-answers-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/I2gUwfiQid9buQxpd/builds/h7CUrKuT9y5OOfcXT/openapi.json
