# eBay Scraper (Store Listing)

Scrape store name, store URL, store title, price, condition, number of followers, and sales from eBay by store page URL.

- Template page: [https://www.octoparse.com/template/ebay-scraper-store-listing](https://www.octoparse.com/template/ebay-scraper-store-listing)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages.

## Output

The current workflow extracts 12 fields, including `Condition`, `Feedback_score`, `Followers`, `Image_URL`, `Page`, `Page_URL`, `Price`, `Sales`, `Store_img_URL`, `Store_name`, `Title`, `Title_URL`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Store URLs (up to 10000), Number of pages and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Store URLs (up to 10000)

Required. Enter URL list as parameter Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=10000.

### Number of pages

Optional. Set a pagesize to control paginating. Constraints: minimum=1, maximum=500.

## How to Use

## eBay Scraper (Store Listing)

### Pricing
This template is currently **free** with no per-line usage fee. Octoparse plan or resource limits may still apply.

### Input
- **Store URLs** (Required) – Enter up to 10,000 store URL entries per run.  
- **Number of pages** (Optional) – Set pagination limit. Accepted range: 1 to 500.

### How to Use
1. Open the template and click **Try it!**.  
2. Fill in **Store URLs** and **Number of pages** using the limits above.  
3. Run the task locally in Octoparse.  
4. Export the resulting rows in your preferred format.  

### Tips
- Test one representative URL in **Store URLs** before running a large batch.  
- Keep `Page_URL` in the export to trace every row back to its source.

### Output
The template returns structured records containing store profile data (e.g., `Store_name`, `Followers`, `Feedback_score`, `Sales`, `Store_img_URL`) and product listing data (e.g., `Title`, `Title_URL`, `Price`, `Condition`, `Image_URL`, `Page_URL`, `Page`).

## Notes

If you would like to have your own customized template, please contact support@octoparse.com .

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [eBay Listing Page Scraper (by keyword)](https://www.octoparse.com/template/ebay-product-list-scraper-by-keyword)
- [Google Maps Store Listing Scraper (Japan)](https://www.octoparse.com/template/google-maps-store-listing-scraper)
- [Ekiten Store Listing Scraper](https://www.octoparse.com/template/ekiten-store-listing-scraper)
- [eBay Product Listing Scraper (for Germany)](https://www.octoparse.com/template/ebay-produkt-listing-scraper)
- [eBay Spain Product Listing Scraper (by Keyword)](https://www.octoparse.com/template/ebay-listados-scraper)

## Input Schema

```json
{
  "title": "eBay Scraper (Store Listing) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "store_URLs": {
      "title": "Store URLs (up to 10000)",
      "description": "Enter URL list as parameter ",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": false
      }
    },
    "number_of_pages": {
      "title": "Number of pages",
      "description": "Set a pagesize to control paginating.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "x-octoparse": {
        "apiEnabled": false
      }
    }
  },
  "required": [
    "store_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "store_URLs": [
    "https://www.ebay.de/str/goodshandel"
  ]
}
```

Example 2

```json
{
  "number_of_pages": 1,
  "store_URLs": [
    "https://www.ebay.com/str/worldofbooksusa"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Condition": {
      "type": "string",
      "description": ""
    },
    "Feedback_score": {
      "type": "string",
      "description": ""
    },
    "Followers": {
      "type": "string",
      "description": ""
    },
    "Image_URL": {
      "type": "string",
      "description": ""
    },
    "Page": {
      "type": "string",
      "description": ""
    },
    "Page_URL": {
      "type": "string",
      "description": ""
    },
    "Price": {
      "type": "string",
      "description": ""
    },
    "Sales": {
      "type": "string",
      "description": ""
    },
    "Store_img_URL": {
      "type": "string",
      "description": ""
    },
    "Store_name": {
      "type": "string",
      "description": ""
    },
    "Title": {
      "type": "string",
      "description": ""
    },
    "Title_URL": {
      "type": "string",
      "description": ""
    }
  },
  "title": "eBay Scraper (Store Listing) output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Condition": "",
  "Feedback_score": "",
  "Followers": "",
  "Image_URL": "",
  "Page": "",
  "Page_URL": "https://www.ebay.de/str/goodshandel",
  "Price": "",
  "Sales": "",
  "Store_img_URL": "",
  "Store_name": "",
  "Title": "",
  "Title_URL": ""
}
```

Example 2

```json
{
  "Condition": "",
  "Feedback_score": "",
  "Followers": "",
  "Image_URL": "",
  "Page": "",
  "Page_URL": "https://www.ebay.com/str/worldofbooksusa",
  "Price": "",
  "Sales": "",
  "Store_img_URL": "",
  "Store_name": "",
  "Title": "",
  "Title_URL": ""
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "ebay-scraper-store-listing",
  "taskName": "eBay Scraper (Store Listing)",
  "parameters": "{\"store_URLs\":[\"https://www.ebay.de/str/goodshandel\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"store_URLs\":[\"https://www.ebay.de/str/goodshandel\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "ebay-scraper-store-listing",
        "taskName": "eBay Scraper (Store Listing)",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "ebay-scraper-store-listing",
  "taskName": "eBay Scraper (Store Listing)",
  "parameters": "{\"store_URLs\":[\"https://www.ebay.de/str/goodshandel\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `ebay-scraper-store-listing`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/ebay-scraper-store-listing.json)
- [Manifest](https://www.octoparse.com/templates/ebay-scraper-store-listing-manifest.json)
