Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Social Media

How to Use Creator public email lookup in Gemini CLI

Finds published creator emails across social profiles, linked bio pages, and websites, with source links where available. Use it to research business contacts for sponsorships, interviews, or bookings.

Prompts to try with Creator public email lookup in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use Creator public email lookup for YouTube @mkbhd and save the returned addresses and available source links to a JSON file in this project.

Creator public email lookupGemini CLI
Try asking
  • Use Creator public email lookup for Instagram @kurzgesagt and add the returned scan diagnostics to our contact review fixture.

  • Use Creator public email lookup for YouTube @veritasium and build a table showing each returned email and its available source types.

  • Use Creator public email lookup for YouTube @TED and compare the returned addresses with our existing partnership contacts CSV.

  • Use Creator public email lookup for YouTube @LinusTechTips and add a review state to our contact screen when the scan is partial or limited.

How to set up Creator public email lookup 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Creator public email lookup

    One request; the result comes back by polling or a webhook.

    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/find-creator-emails",
        "input": {
          "handle": "miguelangeles",
          "platform": "instagram"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Creator public email lookup on Spiral, shows the price and runs it.

Creator public email lookup providers and prices

Spiral runs Creator public email lookup through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Creator Tools · Find Creator Emails
scrapecreators/find-creator-emails

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Platforminstagram, tiktok, youtube, x, twitter, or facebook

Source social platform

Cache max age1d, 3d, 7d, 14d, or 30d

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit with no emails; 10 credits with any email (live lookups)). See the Caching page for details.

Every API field of Creator Tools · Find Creator Emails is on its tool page: open its card above.

What can you do with Creator public email lookup in Gemini CLI?

Build a creator contact review table with published emails and available source links. Keep incomplete scans visible alongside the contact records.

Research sponsorship contacts

Find published business email addresses for a shortlist of public creators before preparing partnership proposals.

Prepare interview invitations

Collect published contact addresses for public educators and media creators, with available source links for editorial review.

Research event booking contacts

Review returned addresses for public performers and identify explicitly labeled booking contacts in the available evidence.

Update a creator partnership directory

Compare lookup results with existing business contact records and queue changes for review.

Consolidate repeated contact addresses

Combine results from a creator shortlist and identify shared management or booking addresses without duplicating contact records.

Review incomplete contact research

Use scan diagnostics to separate lookups that returned no addresses from lookups affected by failed pages or limited scanning.

Questions about Creator public email lookup in Gemini CLI

Can Gemini CLI use Creator public email lookup?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Creator public email lookup like any built-in tool.

How much does Creator public email lookup cost in Gemini CLI?

Up to $0.013 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 Creator public email lookup in Gemini CLI?

No. Spiral runs Creator public email lookup on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Creator public email lookup in Gemini CLI?

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

Does Gemini CLI wait while Creator public email lookup runs?

Creator public email lookup runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

Where does ScrapeCreators look for published email addresses?

It checks public profile bios and contact links, recognized link-in-bio pages, and a bounded set of creator-declared website pages. It does not access login-only contacts or private account data.

Are the returned addresses verified working mailboxes?

No mailbox deliverability check is performed. An address may represent management or bookings rather than the creator directly.

Does an empty result mean the creator has no public email?

No. Scanning is bounded, and failed or timed-out optional scans can leave an empty partial result.

Why might an email have no source link?

ScrapeCreators omits internal-only URLs from provenance. An address found exclusively through those sources has an empty sources array.

Does a matching username establish that two accounts belong together?

Matching handles and display names alone are insufficient. The discovery flow checks evidence such as reciprocal profile links or a shared owner-controlled website.

Get started

Start using Creator public email lookup in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options