↑ ↓ to move ↵ to open
eBay API reference

eBay Additional Item Recommendations

ebay.item.deferred_promotions

Get the extra recommendation rows on an item page, with their listing links.

At a glance

Endpoint ID
ebay.item.deferred_promotions
Price
3 credits per call; failed calls are free
Runs for up to
180 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
ebay__item__deferred_promotions
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "ebay.item.deferred_promotions",  "input": {    "item_id": "283987164379"  }}'

Input

FieldTypeRequiredWhat it doesExample
item_id string yes Item identifier. 283987164379
placements array<string> no

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "modules": [    {      "placement_id": "101875",      "item_urls": [        "https://www.ebay.com/itm/256684557194",        "https://www.ebay.com/itm/286119892331"      ]    },    {      "placement_id": "101506",      "item_urls": [        "https://www.ebay.com/itm/267670495453",        "https://www.ebay.com/itm/256687932768"      ]    }  ],  "placements": [    "101110",    "101111"  ]}

Fields

FieldTypeWhat it isExample
modules[].item_urls array Links to the recommended listings. https://www.ebay.com/itm/256684557194, https://www.ebay.com/itm…
modules[].placement_id string eBay's ID for the promotion slot. 101875
modules array The recommendation blocks shown with the item. 3 records
placements array The promotion slots on the page. 101110, 101111, 101112

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other eBay endpoints

Something missing or unclear? Ask the team that builds the eBay endpoints.