{
"openapi": "3.0.1",
"info": {
"title": "eBay Cross-Market Price Finder - Buy Abroad, Net Margin (API)",
"description": "Compare what a product costs on one eBay marketplace (with shipping to you) against what it sells for on another, and get the net margin after eBay fees, currency conversion and import costs. Official eBay Browse API, no scraping. Schedule it for only new opportunities.",
"version": "0.1",
"x-build-id": "B8R7ULj7UllcVzDaX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/bruco3~ebay-cross-market-finder/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-bruco3-ebay-cross-market-finder",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/bruco3~ebay-cross-market-finder/runs": {
"post": {
"operationId": "runs-sync-bruco3-ebay-cross-market-finder",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/bruco3~ebay-cross-market-finder/run-sync": {
"post": {
"operationId": "run-sync-bruco3-ebay-cross-market-finder",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"queries"
],
"properties": {
"queries": {
"title": "Products to search",
"type": "array",
"description": "One search per line, as you would type it on eBay: brand + model works best (Bosch GSR 12V-35, Garmin Fenix 7 Sapphire, Lego 75192).",
"items": {
"type": "string"
}
},
"sourceMarketplace": {
"title": "Buy on (source marketplace)",
"enum": [
"EBAY_DE",
"EBAY_IT",
"EBAY_FR",
"EBAY_ES",
"EBAY_NL",
"EBAY_AT",
"EBAY_BE",
"EBAY_IE",
"EBAY_PL",
"EBAY_GB",
"EBAY_US",
"EBAY_CA",
"EBAY_AU",
"EBAY_CH"
],
"type": "string",
"description": "Where to look for cheap listings. Prices include shipping to the destination country.",
"default": "EBAY_DE"
},
"destinationMarketplace": {
"title": "Sell on (destination marketplace)",
"enum": [
"EBAY_IT",
"EBAY_DE",
"EBAY_FR",
"EBAY_ES",
"EBAY_NL",
"EBAY_AT",
"EBAY_BE",
"EBAY_IE",
"EBAY_PL",
"EBAY_GB",
"EBAY_US",
"EBAY_CA",
"EBAY_AU",
"EBAY_CH"
],
"type": "string",
"description": "Where the product would be resold; current asking prices there set the reference.",
"default": "EBAY_IT"
},
"condition": {
"title": "Condition",
"enum": [
"NEW",
"USED",
"ANY"
],
"type": "string",
"description": "Compare like with like: new listings against new, used against used.",
"default": "NEW"
},
"minNetMargin": {
"title": "Minimum net margin (destination currency)",
"type": "integer",
"description": "Only opportunities whose net result (after fees, shipping, conversion and import costs) is at least this amount.",
"default": 10
},
"minNetMarginPercent": {
"title": "Minimum net margin (%)",
"type": "integer",
"description": "Net result as a percentage of the total buying cost.",
"default": 15
},
"minComparables": {
"title": "Minimum comparable listings on the destination",
"minimum": 1,
"type": "integer",
"description": "How many similar listings must exist on the destination marketplace before the reference price counts as real. With 3+ the median is used; exact product-code (EPID) matches bypass this rule.",
"default": 3
},
"minPrice": {
"title": "Minimum source price",
"minimum": 0,
"type": "integer",
"description": "In the source marketplace's currency. Skips accessories and fragments."
},
"maxPrice": {
"title": "Maximum source price",
"minimum": 0,
"type": "integer",
"description": "In the source marketplace's currency."
},
"sellerType": {
"title": "You sell as",
"enum": [
"private",
"business"
],
"type": "string",
"description": "Sets the eBay selling fees assumed on the destination: private sellers pay no final value fee on the European sites, business sellers about 12.9%; US/CA/AU charge everyone. Every row states the assumption.",
"default": "private"
},
"feePercent": {
"title": "Override: selling fee %",
"minimum": 0,
"maximum": 50,
"type": "integer",
"description": "Leave empty to use the table for your marketplace and seller type."
},
"importCostPercent": {
"title": "Override: import costs %",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Applied to the landed buying price when the item crosses the EU border (e.g. UK or US seller, EU buyer). Empty = automatic: 25% across the EU border, 0% inside."
},
"onlyNew": {
"title": "Only opportunities new since the last run",
"type": "boolean",
"description": "Remembers delivered source listings in a named key-value store. Turn on and schedule the Actor to be told only about listings you have not seen.",
"default": false
},
"stateStoreName": {
"title": "Memory store name",
"type": "string",
"description": "Named key-value store used by 'only new'.",
"default": "ebay-cross-market-state"
},
"titleSimilarity": {
"title": "Title similarity threshold",
"type": "string",
"description": "0.2-0.9. Lower finds more comparables (riskier), higher is stricter. Model numbers must always agree; accessories are always excluded.",
"default": "0.45"
},
"sourcePages": {
"title": "Source pages (200 listings each)",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "More pages = more candidates and more eBay API calls.",
"default": 1
},
"destinationPages": {
"title": "Destination pages (200 listings each)",
"minimum": 1,
"maximum": 3,
"type": "integer",
"description": "More pages = better reference prices for popular products.",
"default": 1
},
"maxResults": {
"title": "Maximum opportunities per run",
"minimum": 0,
"type": "integer",
"description": "0 = no limit.",
"default": 0
},
"maxApiCalls": {
"title": "Maximum eBay API calls per run",
"minimum": 4,
"maximum": 400,
"type": "integer",
"description": "Each search page is one call. The Actor shares eBay's daily quota among all its users; heavy users should provide their own keys below.",
"default": 60
},
"ebayAppId": {
"title": "Your eBay App ID (optional)",
"type": "string",
"description": "Bring your own eBay developer keys (free at developer.ebay.com) to use your own 5,000 calls/day quota instead of the shared one."
},
"ebayCertId": {
"title": "Your eBay Cert ID (optional)",
"type": "string",
"description": "The client secret matching the App ID above. Stored encrypted."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}