[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [eBay listing options](https://spiral.ai/integrations/gemini/ebay-listing-options)

# How to Use eBay listing options in Gemini

Returns prices and availability for individual choices within an eBay listing. Use it when the size, color, or configuration you need matters more than the listing's headline offer.

|  |  |
| --- | --- |
| Model | eBay listing options |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with eBay listing options in Gemini

- Use eBay listing options for https://www.ebay.com/itm/221835756563 and compare availability for black shirts in medium and large.
- Use eBay listing options for https://www.ebay.com/itm/182570328469 and show the returned prices and availability for white shirts in large and extra large.
- Use eBay listing options to look this up and give me the result as a table.
- Pull the latest numbers from eBay listing options and tell me what changed since last week.
- Check eBay listing options and summarize what you find in three bullet points.

## How to set up eBay listing options in Gemini

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

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini 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 eBay listing options**: 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": "alexandria",
    "model": "ebay-com/listings/item_variations",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Gemini finds eBay listing options on Spiral, shows the price and runs it.

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

## eBay listing options tools and prices

- [eBay listings · Item variations](https://spiral.ai/tools/alexandria/ebay-com/listings/item_variations) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | An /itm/{id} listing URL on any ebay.* storefront; the numeric id is used |
| item_id |  | — | eBay item number (9-15 digits), e.g. "398411135079" Pattern: ^[0-9]{9,15}$. |

## What can you do with eBay listing options in Gemini?

Turn eBay product research into a buying brief you can read in a conversation. Ask about a known offer, its delivery terms, available product choices, or more specific search phrases.

### Prepare a purchasing shortlist

Review supplied eBay listing links for a product purchase. Combine item checks, delivery terms, and availability for the required configuration, then use suggested search wording to identify gaps for further research.

### Build a product comparison dashboard

Turn a saved shortlist into comparable offers with separate views for listing information, shipping terms, and individual product choices. Add eBay's suggested phrases to help users refine their next search.

### Research an apparel assortment

Inspect selected public listings for Gildan shirts or similar merchandise. Compare available sizes and colors, delivery and return terms, and the search wording eBay proposes for the product.

### Find suitable replacement components

Check a supplied shortlist of replacement-component listings for the required configuration and delivery terms. Use suggested product phrases to prepare more precise follow-up searches when the shortlist lacks a suitable choice.

### Review repeat purchases

Revisit previously selected business-supply listings before ordering again. Check the current offer, required product choice, and shipping and return terms for changes that affect the purchase.

### Check availability for specific choices

Inspect individual size, color, or configuration choices in selected listings. Identify which requested combinations are available without assuming that every choice matches the headline offer.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini guides](https://spiral.ai/integrations/gemini)

## eBay listing options in other agents

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

## More Gemini guides

- [eBay listing details](https://spiral.ai/integrations/gemini/ebay-listing-details)
- [eBay listing shipping](https://spiral.ai/integrations/gemini/ebay-listing-shipping)
- [bol.com product search](https://spiral.ai/integrations/gemini/bol-com-product-search)
- [eBay search suggestions](https://spiral.ai/integrations/gemini/ebay-search-suggestions)
- [bol.com product details](https://spiral.ai/integrations/gemini/bol-com-product-details)
- [mydealz deal details](https://spiral.ai/integrations/gemini/mydealz-deal-details)

## Questions about eBay listing options in Gemini

**Can Gemini use eBay listing options?**

Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run eBay listing options like any built-in tool.

**How much does eBay listing options cost in Gemini?**

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

**Do I need an Alexandria account to use eBay listing options in Gemini?**

No. Spiral runs eBay listing options on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up eBay listing options in Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while eBay listing options runs?**

eBay listing options runs in the background. Gemini starts the run, checks on it and gives you the json when it's ready.

**Does eBay verify every claim in a listing?**

eBay does not guarantee listing accuracy. Its listing policy requires the selected condition to agree with the title, description, and item specifics, so conflicting condition claims deserve a closer check.

**Can eBay listing information change after I check it?**

Yes. For most listings, sellers can edit titles and change photos at any time, so an earlier listing summary can differ from the offer you see later.

**Can public eBay data show exact stock counts?**

Not consistently. eBay lets sellers choose whether buyers can see the exact quantity remaining, so public availability is not always an exact inventory count.

**How many size, color, or configuration choices can one listing contain?**

eBay permits up to 250 choices in one listing. Each choice can have a different quantity and price, so the listing's headline offer may not represent the selection you want.

**Is the delivery date shown on a listing final?**

The estimate can become more precise after you confirm your shipping method and address at checkout. eBay also calculates estimates dynamically using handling time, carrier performance, and the delivery locations.

