[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [eBay listing details](https://spiral.ai/integrations/instinct/ebay-listing-details)

# How to Use eBay listing details in Instinct

Returns current item data for one eBay listing. Use it to inspect a known offer before checking its shipping terms or individual size and color choices.

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

## Prompts to try with eBay listing details in Instinct

- Every weekday, use eBay listing details for https://www.ebay.com/itm/167814076520 and report changes in the returned offer information since the previous check.
- Every Monday at 9am: use eBay listing details to look this up and give me the result as a table.
- Pull the latest numbers from eBay listing details and tell me what changed since last week.
- Check eBay listing details and summarize what you find in three bullet points.
- Pull the newest data from eBay listing details and give me the result as a table.

## How to set up eBay listing details in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

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

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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 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": "alexandria",
    "model": "ebay-com/listings/item",
    "input": {
      "url": "<url>"
    }
  }'
```

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

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

## eBay listing details tools and prices

- [eBay listings · Item](https://spiral.ai/tools/alexandria/ebay-com/listings/item) (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 details in Instinct?

Receive a recurring brief about selected eBay offers or product search wording. Scheduled checks can surface changes in listing information, delivery terms, product-choice availability, or suggested 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.

### Compare delivery and return terms

Compare supplied offers for the same product using their listing information, shipping services, estimated delivery, and return policies. Keep the destination context visible when assessing delivery estimates.

## Overview

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

## eBay listing details in other agents

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

## More Instinct guides

- [bol.com product search](https://spiral.ai/integrations/instinct/bol-com-product-search)
- [eBay listing options](https://spiral.ai/integrations/instinct/ebay-listing-options)
- [bol.com product details](https://spiral.ai/integrations/instinct/bol-com-product-details)
- [eBay listing shipping](https://spiral.ai/integrations/instinct/ebay-listing-shipping)
- [bid.cars vehicle makes and models](https://spiral.ai/integrations/instinct/bid-cars-vehicle-makes-and-models)
- [eBay search suggestions](https://spiral.ai/integrations/instinct/ebay-search-suggestions)

## Questions about eBay listing details in Instinct

**Can Instinct use eBay listing details?**

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

**How much does eBay listing details cost in Instinct?**

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

**Do I need an Alexandria account to use eBay listing details in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs eBay listing details on its own Alexandria account.

**How long does it take to set up eBay listing details in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while eBay listing details runs?**

eBay listing details runs in the background. Instinct 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.

