Floppydata Floppydata

Посібник зі скрейпінгу на eBay: як витягувати дані з eBay

Kate Semipiadnaya Оновлено 17 листопада 2026 р. 8 хв читання
  • Веб-скрапінг та Парсинг
  • Посібники
Посібник зі скрейпінгу на eBay: як витягувати дані з eBay
Зміст
  1. То що ж таке, власне, скрейпінг на eBay?
  2. Навіщо збирати дані з eBay?
  3. Коли використовувати офіційний API
  4. Чому з eBay так важко збирати дані?
  5. Необхідні умови
  6. Збір даних з eBay за допомогою Floppydata Web Unlocker
  7. Усунення несправностей
  8. Ваш наступний крок

eBay володіє справжньою скарбницею загальнодоступних даних про ціни. Мільйони актуальних оголошень про колекційні предмети, електроніку, запчастини, що більше не випускаються, та багато іншого — все це корисно для відстеження цін, дослідження ринку або аналізу конкуренції. Проблема полягає в тому, щоб надійно отримати доступ до цих даних. Простий скрипт на Python швидко ламається: eBay рендерить сторінки за допомогою JavaScript, змінює розмітку й обмежує автоматизований трафік.

Отже, у цьому посібнику я розповім вам, як правильно збирати дані з eBay за допомогою Web Unlocker від Floppydata і дійсно отримувати результати.

TL;DR

Як скрапити публічні лістинги eBay, не витрачаючи час на зламані селектори

• eBay обмежує автоматизований трафік за допомогою CAPTCHA та лімітів частоти запитів, тож тримайте низьку частоту запитів і працюйте лише з публічними сторінками.

• Простіший шлях — Web Unlocker від Floppydata: він рендерить сторінку, повторює невдалі запити й повертає чистий HTML.

• Далі вам знадобляться лише Python і BeautifulSoup, щоб отримати дані з оголошень для відстеження цін, досліджень та аналізу.

• Більшість доступних в Інтернеті посібників зі скрейпінгу вже не працюють — eBay перейшов з li.s-item на li.s-card, а багато селекторів так і не були оновлені.

• Нові облікові записи на Floppydata отримують п’ять безкоштовних запитів, тож ви можете скористатися цим посібником, не витрачаючи ніяких коштів наперед.

То що ж таке, власне, скрейпінг на eBay?

Чесно кажучи, це досить просто. Ви просто витягуєте загальнодоступні дані про лоти зі сторінок eBay і перетворюєте їх у формат, з яким можна працювати — CSV, JSON-файл чи що завгодно. Замість того, щоб переглядати лоти один за одним, скрейпер збирає всі ці дані одразу.

Перш ніж перейти до самого коду, варто ознайомитися з двома типами сторінок:

  • Сторінки результатів пошуку — огляд з назвою, ціною, станом, інформацією про доставку та посиланням на оголошення.
  • Сторінки з деталями товару, URL-адреси виду /itm/ITEM_ID, де зберігається глибша інформація: повні описи, характеристики товару та варіанти.

У цьому посібнику ми зосередимося на сторінках результатів пошуку, оскільки саме з них починають більшість користувачів.

Навіщо збирати дані з eBay?

Отже, коли ви вже отримаєте ці дані, з ними, чесно кажучи, можна зробити безліч речей. Ось ті, якими я насправді користуюся:

  1. Відстеження цін. Ви зможете одразу побачити, за скільки насправді продаються товари, проаналізувавши тисячі активних та проданих оголошень, причому саме продані товари — це справжня знахідка, адже це ті ціни, які люди насправді заплатили, а не якісь вигадані цифри, які продавець просто вказав, сподіваючись на краще.
  2. Аналіз конкурентів. Ви можете точно бачити, що саме продається, в якому стані товар продається, хто його продає та яку ціну за нього просять, тож замість того, щоб гадати, яку ціну встановити, ви просто знаєте.
  3. Перепродаж та арбітраж. Саме це дозволяє оплачувати рахунки, адже зараз на ринку є об’єкти, виставлені за заниженою ціною, і завдяки цим даним ви можете їх знайти та придбати, перш ніж хтось інший їх навіть помітить.
  4. Дослідження ринку. Перш ніж вкладати реальні гроші у формування асортименту в певній категорії, ви можете проаналізувати статистику і за кілька хвилин з’ясувати, чи існує справжній попит, чи ви просто витратите гроші на товари, які ніколи не продадуться.
  5. Моніторинг продавців. А якщо ви хочете переглянути інформацію про конкретного продавця, дія залишається точно такою самою: просто вкажіть URL-адресу його магазину замість пошукового запиту — і раптом весь його каталог та ціни опиняться прямо перед вами.

Якщо ваша робота хоч якось пов’язана з перепродажем, електронною комерцією чи ціноутворенням, такі дані дозволять вам заощадити неймовірно багато часу та допоможуть набагато швидше приймати обґрунтовані рішення.

Коли використовувати офіційний API

Це хороший варіант і перше, що варто перевірити. Browse API добре справляється із запитами помірного обсягу до активних лістингів у межах правил і лімітів eBay.

Деякі дані там відсутні в тому вигляді, в якому вони відображаються на самій сторінці. У таких випадках скрапте лише публічні сторінки, повільно, і спершу перевірте користувацьку угоду eBay.

Якщо ви ще не знайомі з цією темою, на сайті Floppydata є хороший вступний матеріал про те, як насправді працює веб-розблокувальник.

Чому з eBay так важко збирати дані?

Це не неможливо, але, безперечно, є певні перешкоди. Зокрема, дві проблеми, з якими стикається більшість людей.

Перша — обмеження автоматизованого трафіку. eBay використовує CAPTCHA та обмеження частоти запитів, і за надто великої кількості запитів ви дуже швидко отримуєте помилки 403. Крім того, на початку 2026 року вони посилили ці обмеження, тому підходьте до цього відповідально: використовуйте лише загальнодоступні дані, дотримуйтесь нормальної частоти запитів, не торкайтеся замовлень чи чогось подібного.

Друга проблема — це розмітка, і вона досить підступна. Під час роботи над цим я зрозумів, що eBay вже перейшов з li.s-item на li.s-card, а разом із ним і всі посилання на .s-card__title, .s-card__price та .s-card__subtitle. Більшість онлайн-посібників досі посилаються на стару структуру, тому зараз вони просто не працюють. Ваші селектори рано чи пізно застаріють — так вже влаштований eBay, тому з самого початку вбудовуйте запобіжні перевірки на відсутність полів.

Саме тому я пропускаю все через Web Unlocker від Floppydata: він рендерить сторінку та повторює запити за мене.

Необхідні умови

Три речі:

  • Python 3.10 або новіша версія
  • Обліковий запис Floppydata з ключем API Web Unlocker. Кожен новий обліковий запис надає п’ять безкоштовних запитів, тож ви зможете пройти весь цей посібник, не платячи ні копійки. Ключ знаходиться на панелі управління Web Unlocker.
  • Дві бібліотеки: requests та beautifulsoup4

Налаштування облікового запису та інформація про ключ API

Спочатку встановіть дві бібліотеки:

pip install requests beautifulsoup4

Далі — папка вашого проєкту:

mkdir ebay-scraper
cd ebay-scraper
touch ebay_scraper.py

Збір даних з eBay за допомогою Floppydata Web Unlocker

Він бере на себе всю нудну рутину: резидентські IP, рендеринг сторінок, повторні спроби — і повертає чистий HTML. Оплата здійснюється лише за успішні запити, тож ви не втрачаєте кредити на невдалі спроби.

Я завжди тестую в тестовому середовищі на панелі інструментів (тестове середовище Web Unlocker без кодування), перш ніж щось писати. Вставте URL-адресу для пошуку, натисніть «Scrape» і подивіться, що вийде. Набагато простіше створювати парсер, коли вже знаєте, з чим маєте справу.

Знімок екрана інтерфейсу інструменту для веб-скрейпінгу

Тепер у нас є HTML-код, тож перейдемо до програмування.

Крок 1: Створити запит

import requests
import json
from bs4 import BeautifulSoup

API_URL = "https://api.floppydata.net/v1/webUnlocker"
API_KEY = "YOUR_API_KEY"

SEARCH_URL = "https://www.ebay.com/sch/i.html?_nkw=mechanical+keyboard&_pgn=1"
OUTPUT_FILE = "ebay_listings.json"

Замініть YOUR_API_KEY на ключ зі своєї панелі управління.

Крім того, _pgn=1 — це просто номер сторінки. Якщо вам потрібна друга сторінка, змініть адресу на _pgn=2. Третя сторінка — _pgn=3. Все просто.

Крок 2: Завантажте сторінку за допомогою Web Unlocker

def fetch_html(url):
    response = requests.post(
        API_URL,
        headers={
            "Content-Type": "application/json",
            "X-Api-Key": API_KEY,
        },
        json={
            "url": url,
            "country": "US",
            "city": "New York",
            "difficulty": "medium",
            "expiration": 0,
        },
        timeout=120,
    )

    response.raise_for_status()

    data = response.json()
    html = data.get("html")

    if not html:
        raise ValueError("Unlocker response did not include an 'html' field.")

    return html

Країна та місто гарантують, що запит піде через резидентський IP зі США, а це впливає і на ціни, і на те, які лістинги реально відображаються. Складність medium — правильне налаштування для eBay, оскільки його сторінки потребують повного рендерингу. Термін дії 0 змушує щоразу отримувати свіжу сторінку замість кешованої відповіді. Відрендерений HTML повертається в полі html у JSON, і саме його BeautifulSoup розбирає на наступному кроці. Якщо хочете побачити всі доступні параметри, вони є в довіднику API Web Unlocker.

Крок 3: Витягнути списки

Кожен результат на сторінці пошуку — це li.s-card контейнер. Щоб акуратно витягувати дані з оголошень на eBay, ми пробігаємо циклом по кожній картці та витягуємо потрібні поля, використовуючи запобіжні перевірки, щоб відсутність якогось поля ніколи не призводила до збою у виконанні:

def extract_listings(html):
    soup = BeautifulSoup(html, "html.parser")
    cards = soup.select("li.s-card")
    listings = []

    for card in cards:
        title_el = card.select_one(".s-card__title")
        title = title_el.get_text(" ", strip=True) if title_el else None

        if title:
            # eBay appends this as accessibility text
            title = title.replace("Opens in a new window or tab", "").strip()

        # Skip the placeholder card at the top of search results
        if not title or title == "Shop on eBay":
            continue

        price_el = card.select_one(".s-card__price")
        condition_el = card.select_one(".s-card__subtitle")

        # Shipping info sits inside attribute rows
        shipping = None

        for row in card.select(".s-card__attribute-row"):
            text = row.get_text(" ", strip=True)

            if any(word in text.lower() for word in ("ship", "free", "delivery")):
                shipping = text
                break

        # Grab the first link that points to an item detail page
        url = None

        for a in card.select("a.s-card__link"):
            href = a.get("href")

            if href and "/itm/" in href:
                url = href.split("?")[0]
                break

        listings.append({
            "title": title,
            "price": price_el.get_text(" ", strip=True) if price_el else None,
            "condition": condition_el.get_text(" ", strip=True) if condition_el else None,
            "shipping": shipping,
            "url": url,
        })

    return listings

Дві тонкощі, про які варто знати.

  • eBay завжди розміщує картку-заповнювач «Shop on eBay» у верхній частині результатів пошуку. Якщо ви її не пропустите, перший елемент у масиві результатів виявиться просто непотрібним сміттям.
  • Заголовок також витягує текст «Відкривається в новому вікні або вкладці» як текст доступності з тегу анкора, щоб рядок заміни очистив його до того, як до нього буде додано будь-що.

Крок 4: Збережіть результати

def main():
    print(f"Fetching data from: {SEARCH_URL}")

    html = fetch_html(SEARCH_URL)
    listings = extract_listings(html)

    if not listings:
        raise SystemExit("No listings found. eBay may have changed its markup.")

    with open(OUTPUT_FILE, "w", encoding="utf-8") as file:
        json.dump(listings, file, indent=2)

    print(f"Found {len(listings)} listings")
    print(f"Saved results to {OUTPUT_FILE}")


if __name__ == "__main__":
    main()

Запустіть скрипт:

python ebay_scraper.py

І ви повинні побачити щось на зразок:

[
  {
    "title": "MSI Forge GK600 TKL Wireless Mechanical Keyboard RGB Bluetooth 2.4GHz",
    "price": "$49.99",
    "condition": "Brand New",
    "shipping": "Free shipping",
    "url": "https://www.ebay.com/itm/227344950627"
  }
]

Перелік комп'ютерних клавіатур, що продаються

Ось так працює простий скрепер.

Відтепер, щоб змінити ключове слово, достатньо просто змінити _nkw=mechanical+keyboard в URL-адресі. Якщо вам потрібна інша сторінка, ви можете перейти з _pgn=1 на _pgn=2, _pgn=3 тощо.

Усунення несправностей

Отже, це очевидно: якщо достатньо довго переглядати eBay, то, швидше за все, натрапите на щось із цього:

  • Помилки 403: eBay обмежує ваші запити. Уповільніться та спробуйте пізніше; не намагайтеся обійти блокування.
  • Порожні відповіді: зазвичай це проблема з відображенням. Перевірте ще раз, чи ви зчитуєте дані з поля « html » у відповіді Web Unlocker, а не з необробленого тіла JSON.
  • Відсутні поля: не в кожному оголошенні вказано стан товару або інформацію про доставку. Захисні перевірки на сайті extract_listings вже враховують це.
  • Результатів немає: eBay знову змінив назви CSS-класів. Поверніться до тестового середовища, перегляньте нову розмітку та оновте свої селектори.

Ваш наступний крок

Скажу прямо: eBay — не найскладніший сайт, але через ліміти запитів і те, що розмітка іноді просто змінюється, робота без правильного налаштування лише марнуватиме ваш час. Якщо пропускати трафік через рішення, яке бере на себе рендеринг і повторні спроби, ви одразу переходите до роботи з даними.

Саме в цьому і полягає перевага Web Unlocker від Floppydata. Ротація резидентських проксі, повний рендеринг сторінок, а платите ви лише за успішні відповіді, тож невдалий скрапінг нічого вам не коштує. Додайте до цього кілька рядків коду BeautifulSoup — і, чесно кажучи, все стає досить простим.

З кожним новим обліковим записом надається п’ять безкоштовних скрейпів, тож ви зможете пройти весь цей посібник, не платячи ні копійки.