[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Snapchat Spotlight video details](https://spiral.ai/integrations/gemini-cli/snapchat-spotlight-video-details)

# How to Use Snapchat Spotlight video details in Gemini CLI

Fetch a public Snapchat Spotlight video's description, creator, engagement counts, thumbnail, and video URL. Use it to review a specific post, compare selected videos, or measure changes across saved checks.

|  |  |
| --- | --- |
| Model | Snapchat Spotlight video details |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Snapchat Spotlight video details in Gemini CLI

- Use Snapchat Spotlight video details for https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ and add its returned engagement counts to our campaign report.
- Use Snapchat Spotlight video details for https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ and save its duration and dimensions in our video comparison table.
- Use Snapchat Spotlight video details for https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ and compare its counts with the last observation in our database.
- Use Snapchat Spotlight video details for https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ to populate our reference page with its description and creator attribution.
- Use Snapchat Spotlight video details for https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ and add calculated shares per 1,000 views to our report.

## How to set up Snapchat Spotlight video details in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Snapchat Spotlight video details**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/snapchat-spotlight",
    "input": {
      "url": "https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Snapchat Spotlight video details on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Snapchat Spotlight video details tools and prices

- [Snapchat · Spotlight by Link](https://spiral.ai/tools/scrapecreators/scrapecreators/snapchat-spotlight) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with Snapchat Spotlight video details in Gemini CLI?

Build a campaign report from selected public Spotlight videos. A coding agent can add post metrics and video measurements to your project and calculate changes from saved observations.

### Campaign post reporting

Turn selected public campaign posts into a report of views, shares, and comments.

### Creator content review

Review a public creator's selected videos using descriptions, thumbnails, and engagement counts.

### Post performance monitoring

Compare repeated checks of approved campaign posts to calculate changes between observations.

### Video format comparison

Compare duration and dimensions across selected Spotlights when planning a public content campaign.

### Editorial reference collection

Build a reference list with post descriptions, creator attribution, and source links for an editorial review.

### Sharing performance comparison

Calculate shares per 1,000 views across selected posts to identify videos worth a closer creative review.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Snapchat Spotlight video details in other agents

- [Amp](https://spiral.ai/integrations/amp/snapchat-spotlight-video-details)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/snapchat-spotlight-video-details)
- [Claude](https://spiral.ai/integrations/claude-desktop/snapchat-spotlight-video-details)
- [Claude Code](https://spiral.ai/integrations/claude-code/snapchat-spotlight-video-details)
- [Cline](https://spiral.ai/integrations/cline/snapchat-spotlight-video-details)
- [Codex](https://spiral.ai/integrations/codex/snapchat-spotlight-video-details)
- [Cursor](https://spiral.ai/integrations/cursor/snapchat-spotlight-video-details)
- [Devin](https://spiral.ai/integrations/devin/snapchat-spotlight-video-details)
- [dots](https://spiral.ai/integrations/dots/snapchat-spotlight-video-details)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/snapchat-spotlight-video-details)
- [Gemini](https://spiral.ai/integrations/gemini/snapchat-spotlight-video-details)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/snapchat-spotlight-video-details)
- [goose](https://spiral.ai/integrations/goose/snapchat-spotlight-video-details)
- [Grok](https://spiral.ai/integrations/grok/snapchat-spotlight-video-details)
- [Grok Build](https://spiral.ai/integrations/grok-build/snapchat-spotlight-video-details)
- [Hermes](https://spiral.ai/integrations/hermes/snapchat-spotlight-video-details)
- [Instinct](https://spiral.ai/integrations/instinct/snapchat-spotlight-video-details)
- [Manus](https://spiral.ai/integrations/manus/snapchat-spotlight-video-details)
- [Muse](https://spiral.ai/integrations/muse/snapchat-spotlight-video-details)
- [Muse Code](https://spiral.ai/integrations/muse-code/snapchat-spotlight-video-details)
- [n8n](https://spiral.ai/integrations/n8n/snapchat-spotlight-video-details)
- [Notion](https://spiral.ai/integrations/notion/snapchat-spotlight-video-details)
- [OpenClaw](https://spiral.ai/integrations/openclaw/snapchat-spotlight-video-details)
- [opencode](https://spiral.ai/integrations/opencode/snapchat-spotlight-video-details)
- [Perplexity](https://spiral.ai/integrations/perplexity/snapchat-spotlight-video-details)
- [Raycast](https://spiral.ai/integrations/raycast/snapchat-spotlight-video-details)
- [VS Code](https://spiral.ai/integrations/vscode/snapchat-spotlight-video-details)
- [Windsurf](https://spiral.ai/integrations/windsurf/snapchat-spotlight-video-details)
- [Zapier](https://spiral.ai/integrations/zapier/snapchat-spotlight-video-details)

## More Gemini CLI guides

- [Snapchat Spotlight comments](https://spiral.ai/integrations/gemini-cli/snapchat-spotlight-comments)
- [Snapchat public profile](https://spiral.ai/integrations/gemini-cli/snapchat-public-profile)
- [ScrapeCreators linked social profiles](https://spiral.ai/integrations/gemini-cli/scrapecreators-linked-social-profiles)
- [SoundCloud Artist Tracks ScrapeCreators](https://spiral.ai/integrations/gemini-cli/soundcloud-artist-tracks-scrapecreators)
- [ScrapeCreators creator age and gender estimates](https://spiral.ai/integrations/gemini-cli/scrapecreators-creator-age-and-gender-estimates)
- [SoundCloud Track](https://spiral.ai/integrations/gemini-cli/soundcloud-track)

## Questions about Snapchat Spotlight video details in Gemini CLI

**Can Gemini CLI use Snapchat Spotlight video details?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Snapchat Spotlight video details like any built-in tool.

**How much does Snapchat Spotlight video details cost in Gemini CLI?**

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need a ScrapeCreators account to use Snapchat Spotlight video details in Gemini CLI?**

No. Spiral runs Snapchat Spotlight video details on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Snapchat Spotlight video details in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Snapchat Spotlight video details runs?**

Snapchat Spotlight video details runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Does this cover every Spotlight post?**

Coverage is limited to public video data. Snapchat's My Profile makes saved Stories and Spotlight posts visible only to friends, so those posts fall outside public coverage.

**Does a Spotlight view count mean unique people?**

No. Snapchat defines Spotlight views as the number of times viewers started watching; unique viewers are a separate metric.

**Are these counts the same as full creator analytics?**

No. Additional Creator Insights require the creator to enable sharing with brands. Snapchat's own insights also offer average view time and average view rate at 7, 28, or 90-day ranges.

**Is a newly submitted Spotlight immediately distributed?**

Snapchat says a Spotlight submission must be reviewed before distribution. Submission alone does not establish that a post has reached the public feed.

**Does clearing a creator's Public Profile remove their Spotlights?**

No. Snapchat says Spotlight and Snap Map posts survive clearing a Public Profile and must be deleted separately.

