Docs menu

eBay API endpoint

eBay Item API

Use Crawlora's eBay Item API to extract supported public eBay data as structured JSON. This page includes request parameters, cURL examples, response schema, error behavior, credit cost, and a Playground link for testing before integration.

GETapiKey2 credits/requesteBayebay.itemResponseDoc/ebay/item/{item_id}

Endpoint facts

Method: GET
API path: /ebay/item/{item_id}
Auth: apiKey
Credits: 2 credits/request
Platform: eBay
Response schema: #/definitions/ebay.itemResponseDoc

Overview

Returns normalized details for a public eBay item listing. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and AI-agent workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.

eBay platform page Try eBay Item API in Playground Crawlora API pricing eBay API documentation

Request parameters

Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.

Parameter	Type	Required	Default	Description	Example
item_id (path)	string	Yes		eBay item ID
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/ebay/item/%3Citem_id%3E" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 2 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

Proxy strategy: managed automatically where needed
Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
Browser cluster: supported dynamic workloads can be routed through distributed browser instances
Retry behavior: automatic retry/fallback may be used depending on endpoint type
Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
Billing: credits are charged only for successful 2xx responses
Observability: responses include request context where available

Catalog quality warnings

missing example for required path param: item_id

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

Status	Common failure case
400	Invalid input or missing required parameter
429	Plan or endpoint rate limit exceeded
500	Internal execution error
502	Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "item_id": "196435705622",
    "title": "1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE",
    "link": "https://www.ebay.com/itm/196435705622",
    "images": [
      "https://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l1600.jpg"
    ],
    "price": 49.95,
    "price_text": "US $49.95",
    "condition": "Pre-Owned",
    "availability": "In Stock",
    "sale_status": "Available",
    "shipping": "+$4.95 shipping",
    "location": "Canada",
    "seller_name": "soonerfan1949",
    "seller_link": "https://www.ebay.com/usr/soonerfan1949",
    "seller_store_name": "POLOBLADE COLLECTIBLES",
    "seller_member_since": "Mar 1998",
    "seller_feedback_score": 2067,
    "seller_positive_feedback": 100,
    "rating": 4.8,
    "rating_count": 12,
    "item_specifics": {
      "Card Number": "311",
      "Manufacturer": "Topps"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/ebay.itemResponseDoc

Field	Type	Required	Example	Description
code	integer	No		Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	ebay.Item	No
data.availability	string	No	In Stock
data.condition	string	No	Pre-Owned
data.description	string	No
data.images	array	No
data.item_feedback_count	integer	No	80
data.item_id	string	No	196435705622
data.item_specifics	object	No
data.link	string	No	https://www.ebay.com/itm/196435705622
data.location	string	No	Canada
data.price	number	No	49.95
data.price_text	string	No	US $49.95
data.rating	number	No	4.8
data.rating_count	integer	No	12
data.sale_status	string	No	Available
data.seller_categories	array	No
data.seller_description	string	No
data.seller_detailed_ratings	object	No
data.seller_feedback_score	integer	No	2067
data.seller_followers	integer	No	13000
data.seller_items_sold	integer	No	814000
data.seller_link	string	No	https://www.ebay.com/usr/soonerfan1949
data.seller_logo_url	string	No	https://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l140.jpg
data.seller_member_since	string	No	Mar 1998
data.seller_name	string	No	soonerfan1949
data.seller_positive_feedback	number	No	100
data.seller_store_name	string	No	POLOBLADE COLLECTIBLES
data.seller_total_feedback_count	integer	No	291075
data.shipping	string	No	+$4.95 shipping
data.title	string	No	1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/ebay/item/%3Citem_id%3E" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

More eBay endpoint docs eBay scraper API platform page Crawlora API pricing Try eBay Item API in Playground Search eBay listings API documentation eBay Seller API documentation eBay Seller About API documentation eBay Seller Feedback API documentation eBay Seller Shop API documentation

Open in Playground Back to group

Overview

Parameter

Type

Required

Default

Description

Example

item_id (path)

string

Yes

eBay item ID

x-api-key (header)

string

Yes

API key required

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost

2 credits/request

Charged response

Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

Proxy strategy: managed automatically where needed

Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution

Browser cluster: supported dynamic workloads can be routed through distributed browser instances

Retry behavior: automatic retry/fallback may be used depending on endpoint type

Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used

Billing: credits are charged only for successful 2xx responses

Observability: responses include request context where available

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

Status	Common failure case
400	Invalid input or missing required parameter
429	Plan or endpoint rate limit exceeded
500	Internal execution error
502	Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Status

Description

Schema

400

Bad Request

#/definitions/app.Response

404

Not Found

#/definitions/app.Response

429

Too Many Requests

#/definitions/app.Response

500

Internal Server Error

#/definitions/app.Response

503

Service Unavailable

#/definitions/app.Response

{ "code": 200, "msg": "OK", "data": { "item_id": "196435705622", "title": "1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE", "link": "https://www.ebay.com/itm/196435705622", "images": [ "https://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l1600.jpg" ], "price": 49.95, "price_text": "US $49.95", "condition": "Pre-Owned", "availability": "In Stock", "sale_status": "Available", "shipping": "+$4.95 shipping", "location": "Canada", "seller_name": "soonerfan1949", "seller_link": "https://www.ebay.com/usr/soonerfan1949", "seller_store_name": "POLOBLADE COLLECTIBLES", "seller_member_since": "Mar 1998", "seller_feedback_score": 2067, "seller_positive_feedback": 100, "rating": 4.8, "rating_count": 12, "item_specifics": { "Card Number": "311", "Manufacturer": "Topps" } } }

Field

Type

Required

Enum

Bounds

Example

Description

code

integer

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

data

ebay.Item

data.availability

string

In Stock

data.condition

string

Pre-Owned

data.description

string

data.images

array

data.item_feedback_count

integer

data.item_id

string

196435705622

data.item_specifics

object

data.link

string

https://www.ebay.com/itm/196435705622

data.location

string

Canada

data.price

number

49.95

data.price_text

string

US $49.95

data.rating

number

4.8

data.rating_count

integer

data.sale_status

string

Available

data.seller_categories

array

data.seller_description

string

data.seller_detailed_ratings

object

data.seller_feedback_score

integer

2067

data.seller_followers

integer

13000

data.seller_items_sold

integer

814000

data.seller_link

string

https://www.ebay.com/usr/soonerfan1949

data.seller_logo_url

string

https://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l140.jpg

data.seller_member_since

string

Mar 1998

data.seller_name

string

soonerfan1949

data.seller_positive_feedback

number

100

data.seller_store_name

string

POLOBLADE COLLECTIBLES

data.seller_total_feedback_count

integer

291075

data.shipping

string

+$4.95 shipping

data.title

string

1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE

msg

unknown

Msg is the message that describes the result of the request @example "Request successful"

eBay Item API

Endpoint facts

Overview

Request parameters

cURL example

Authentication

Billing

Infrastructure behavior

Catalog quality warnings

Error behavior

Failure responses

Example JSON response

Code examples

Responsible public web data workflows

Related

eBay Item API

Endpoint facts

Overview

Request parameters

cURL example

Authentication

Billing

Infrastructure behavior

Catalog quality warnings

Error behavior

Failure responses

Example JSON response

Code examples

Responsible public web data workflows

Related