# Pangolinfo AI Overview & Keyword Trends (`pangolinfo/pangolinfo-apify-actors-2`) Actor

Track Google AI Overview citations, run multi-turn AI Mode research, and compare Keyword Trends with structured Pangolinfo data for AEO, SEO, product demand, and competitor monitoring.

- **URL**: https://apify.com/pangolinfo/pangolinfo-apify-actors-2.md
- **Developed by:** [Charon Jiang](https://apify.com/pangolinfo) (community)
- **Categories:** AI, SEO tools, E-commerce
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

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

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Pangolinfo AI Overview & Keyword Trends

Collect structured Google AI Overview, AI Mode, citation source, and Keyword Trends data with the official Pangolinfo API. This Actor is built for AEO monitoring, AI-search visibility research, keyword demand validation, content research, and competitor intelligence.

### Supported operations

- **Google AI Overview:** run a localized Google query and return organic results, AI-generated summaries, and cited sources when present.
- **Google AI Mode:** submit one to five sequential prompts for conversational market or product research.
- **Keyword Trends:** compare up to five keywords across a selected country and time range, including timeline, geographic, and related-query signals.

### Quick start

1. Create or copy an API key from the [Pangolinfo Console](https://tool.pangolinfo.com/).
2. Select an operation and enter only the fields relevant to that operation.
3. Start the Actor and read the default Dataset as JSON, CSV, Excel, or through the Apify API.

The API key is an encrypted Apify secret. It is sent only in the HTTPS `Authorization` header to `scrapeapi.pangolinfo.com` and is never written to logs, Dataset results, or source code.

### Product and documentation

- [AI Overview SERP API](https://www.pangolinfo.com/ai-overview-serp-api/) — product overview, use cases, and access.
- [AI Overview API documentation](https://docs.pangolinfo.com/en-api-reference/aiModeSerpApi/aiModeSerpAPI) — single-query AI Overview and citations.
- [AI Mode API documentation](https://docs.pangolinfo.com/en-api-reference/aiModeSerpApi/aiModeAPI) — multi-turn generative search.
- [Keyword Trends API documentation](https://docs.pangolinfo.com/en-api-reference/trendsApi/keywordTrendsAPI) — keyword comparison fields and response data.
- [AI SERP Skill](https://www.pangolinfo.com/ai-serp-skill/) — agent-friendly search intelligence workflows.
- [Amazon Data MCP](https://www.pangolinfo.com/amazon-data-mcp/) — MCP-native access for AI agents.

### Practical workflows

#### AI Overview brand and citation monitoring

Run the same commercial query on a schedule, then store each Dataset result in a database or spreadsheet. Compare cited domains, brand mentions, answer structure, and result URLs over time. Apify can forward results to n8n, Make, Zapier, webhooks, Google Drive, or your data warehouse.

#### Multi-turn product research

Use AI Mode with a first prompt that defines the market and one or two follow-ups that request comparisons, buying criteria, or source evidence. Keeping the sequence under five turns controls latency and makes the output easier to audit.

#### Demand validation before launch

Compare a product concept, its common synonym, and a competing category in Keyword Trends. Use regional distribution, historical direction, and breakout related queries as supporting evidence rather than treating a single normalized score as absolute search volume.

### Output

Every run stores one structured envelope containing the operation, localization, query or prompts, task metadata, complete Pangolinfo response, and official product/documentation links. Screenshot URLs are returned only when screenshot capture is enabled and supported by the operation.

### Responsible use

- Keep AI Mode prompts and Trends keyword lists bounded to five items.
- AI-generated summaries and cited sources can change by location and time; validate critical conclusions against the underlying sources.
- Google Trends values are normalized indicators, not absolute search-volume estimates.
- Do not use this Actor to collect personal data or violate applicable platform terms, laws, or Pangolinfo policies.

### License

MIT

# Actor input Schema

## `apiKey` (type: `string`):

Bearer API key from the Pangolinfo Console. Apify stores this field encrypted.

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

Select AI Overview, conversational AI Mode, or historical Keyword Trends.

## `query` (type: `string`):

Required for AI Overview, for example: best noise cancelling headphones.

## `prompts` (type: `array`):

One to five sequential prompts for AI Mode. Each item is a conversation turn.

## `keywords` (type: `array`):

One to five keywords for Keyword Trends. Keep the list focused for readable comparisons.

## `countryCode` (type: `string`):

Two-letter country code used for localized search and trends data.

## `languageCode` (type: `string`):

Language and locale code used for Google results.

## `timeRange` (type: `string`):

Applied only to Keyword Trends.

## `screenshot` (type: `boolean`):

Optional for AI Overview and AI Mode. Screenshots may increase storage and processing time.

## `timeoutSeconds` (type: `integer`):

Maximum time for one Pangolinfo request. AI search can take longer than standard HTTP requests.

## Actor input object example

```json
{
  "operation": "aiOverview",
  "query": "best noise cancelling headphones",
  "prompts": [
    "best noise cancelling headphones",
    "compare the leading options for long flights"
  ],
  "keywords": [
    "noise cancelling headphones",
    "wireless earbuds"
  ],
  "countryCode": "US",
  "languageCode": "en-US",
  "timeRange": "today 12-m",
  "screenshot": false,
  "timeoutSeconds": 180
}
```

# Actor output Schema

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

Dataset items returned by the selected Pangolinfo search intelligence operation.

# 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("pangolinfo/pangolinfo-apify-actors-2").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("pangolinfo/pangolinfo-apify-actors-2").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 '{}' |
apify call pangolinfo/pangolinfo-apify-actors-2 --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pangolinfo/pangolinfo-apify-actors-2"
        }
    }
}

```

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/lw77QKKAXDbHk0VI6/builds/Y910hb4BacitmWWc0/openapi.json