Marketing API

ebay · Commerce

Commerce No Auth Free & Open ecommerce

The Marketing API offers two platforms that sellers can use to promote and advertise their products: Promoted Listings is an eBay ad service that lets sellers set up ad campaigns for the products they want to promote. eBay displays the ads in search results and in other marketing modules as SPONSORED listings. If an item in a Promoted Listings campaign sells, the seller is assessed a Promoted Listings fee, which is a seller-specified percentage applie

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET getCampaigns

This method retrieves the details for all of the seller's defined campaigns. Request parameters can be used to retrieve a specific campaign, such as the campaign's name, the start and end date, the status, and the funding model (Cost Per Sale (CPS) or Cost Per Click (CPC). You can filter the resu

https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_campaign?limit=10&offset=0&campaign_name=example&end_date_range=example&campaign_status=example&funding_strategy=example&start_date_range=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_campaign?limit=10&offset=0&campaign_name=example&end_date_range=example&campaign_status=example&funding_strategy=example&start_date_range=example"

import requests
params = {
    "limit": "10",
    "offset": "0",
    "campaign_name": "example",
    "end_date_range": "example",
    "campaign_status": "example",
    "funding_strategy": "example",
    "start_date_range": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_campaign",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_campaign');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('campaign_name', 'example');
url.searchParams.set('end_date_range', 'example');
url.searchParams.set('campaign_status', 'example');
url.searchParams.set('funding_strategy', 'example');
url.searchParams.set('start_date_range', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_campaign")
	q := baseURL.Query()
	q.Set("limit", "10")
	q.Set("offset", "0")
	q.Set("campaign_name", "example")
	q.Set("end_date_range", "example")
	q.Set("campaign_status", "example")
	q.Set("funding_strategy", "example")
	q.Set("start_date_range", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_campaign")
uri.query = URI.encode_www_form({
  "limit" => "10",
  "offset" => "0",
  "campaign_name" => "example",
  "end_date_range" => "example",
  "campaign_status" => "example",
  "funding_strategy" => "example",
  "start_date_range" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_campaign?" . http_build_query([
    "limit" => "10",
    "offset" => "0",
    "campaign_name" => "example",
    "end_date_range" => "example",
    "campaign_status" => "example",
    "funding_strategy" => "example",
    "start_date_range" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET getReportTasks

This method returns information on all the existing report tasks related to a seller. Use the report_task_statuses query parameter to control which reports to return. You can paginate the result set by specifying a limit , which dictates how many report tasks to return on each page o

https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_report_task?limit=10&offset=0&report_task_statuses=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_report_task?limit=10&offset=0&report_task_statuses=example"

import requests
params = {
    "limit": "10",
    "offset": "0",
    "report_task_statuses": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_report_task",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_report_task');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('report_task_statuses', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_report_task")
	q := baseURL.Query()
	q.Set("limit", "10")
	q.Set("offset", "0")
	q.Set("report_task_statuses", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_report_task")
uri.query = URI.encode_www_form({
  "limit" => "10",
  "offset" => "0",
  "report_task_statuses" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/ad_report_task?" . http_build_query([
    "limit" => "10",
    "offset" => "0",
    "report_task_statuses" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET getNegativeKeywords

Note: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.ht

https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/negative_keyword?limit=10&offset=0&ad_group_ids=example&campaign_ids=example&negative_keyword_status=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/negative_keyword?limit=10&offset=0&ad_group_ids=example&campaign_ids=example&negative_keyword_status=example"

import requests
params = {
    "limit": "10",
    "offset": "0",
    "ad_group_ids": "example",
    "campaign_ids": "example",
    "negative_keyword_status": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/negative_keyword",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/negative_keyword');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('ad_group_ids', 'example');
url.searchParams.set('campaign_ids', 'example');
url.searchParams.set('negative_keyword_status', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/negative_keyword")
	q := baseURL.Query()
	q.Set("limit", "10")
	q.Set("offset", "0")
	q.Set("ad_group_ids", "example")
	q.Set("campaign_ids", "example")
	q.Set("negative_keyword_status", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/negative_keyword")
uri.query = URI.encode_www_form({
  "limit" => "10",
  "offset" => "0",
  "ad_group_ids" => "example",
  "campaign_ids" => "example",
  "negative_keyword_status" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/sell-marketing/v1.14.0/negative_keyword?" . http_build_query([
    "limit" => "10",
    "offset" => "0",
    "ad_group_ids" => "example",
    "campaign_ids" => "example",
    "negative_keyword_status" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Marketing API?

Marketing API is a Commerce API. Developers commonly use commerce APIs for:

syncing product catalogues and inventory levels
building price comparison and deal-finder tools
processing orders and tracking shipments
managing customer wishlists and reviews
automating abandoned-cart and promotional emails

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Marketing API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗