Automate eBay Marketing
HumDay reads eBay Marketing’s own published API description and derives 69 operations from it. Describe the outcome you want in plain words — you get a program that is written, proven on real data, and run for you.
What eBay Marketing is
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
API host: api.ebay.com{basepath}
What HumDay can do in eBay Marketing
44 documented operations change something in eBay Marketing.
- POSTThis method creates an item price markdown promotion (know simply as a "markdown promotion") where a discount amount is applied directly to the items included the promotion.
/item_price_markdown - POSTThis method creates a Promoted Listings ad campaign.
/ad_campaign - POSTThis method creates an item promotion, where the buyer receives a discount when they meet the buying criteria that's set for the promotion.
/item_promotion - DELETEThis method deletes the campaign specified by the campaignid query parameter.
/ad_campaign/{campaign_id} - PUTThis method updates the specified item price markdown promotion with the new configuration that you supply in the payload of the request.
/item_price_markdown/{promotion_id} - POSTThis method adds a listing to an existing Promoted Listings campaign using a listingId value generated by the Trading API or Inventory API, or using a value generated by an ad gro…
/ad_campaign/{campaign_id}/ad - POSTThis method adds multiple listings to an existing Promoted Listings campaign using listingId values generated by the Trading API or Inventory API, or using values generated by an…
/ad_campaign/{campaign_id}/bulk_create_ads_by_listing_id - POSTThis method adds a listing that is managed with the Inventory API to an existing Promoted Listings campaign.
/ad_campaign/{campaign_id}/create_ads_by_inventory_reference - POSTThis method adds multiple listings that are managed with the Inventory API to an existing Promoted Listings campaign.
/ad_campaign/{campaign_id}/bulk_create_ads_by_inventory_reference - PUTThis method updates the specified threshold promotion with the new configuration that you supply in the request.
/item_promotion/{promotion_id} - DELETEThis call deletes the report task specified by the reporttaskid path parameter.
/ad_report_task/{report_task_id} - DELETEThis method deletes the item price markdown promotion specified by the promotionid path parameter.
/item_price_markdown/{promotion_id} - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/negative_keyword - POSTThis method ends an active ( RUNNING ) or paused campaign.
/ad_campaign/{campaign_id}/end - POSTThis method clones (makes a copy of) the specified campaign's campaign criterion.
/ad_campaign/{campaign_id}/clone - POSTThis method pauses an active (RUNNING) campaign.
/ad_campaign/{campaign_id}/pause - POSTThis method resumes a paused campaign, as long as its end date is in the future.
/ad_campaign/{campaign_id}/resume - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/bulk_create_negative_keyword - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/bulk_update_negative_keyword - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/update_campaign_budget - POSTThis method updates the ad rate strategy for an existing Promoted Listings Standard (PLS) rules-based ad campaign that uses the Cost Per Sale (CPS) funding model.
/ad_campaign/{campaign_id}/update_ad_rate_strategy - POSTThis method can be used to change the name of a campaign, as well as modify the start or end dates.
/ad_campaign/{campaign_id}/update_campaign_identification - DELETEThis method deletes the threshold promotion specified by the promotionid path parameter.
/item_promotion/{promotion_id} - DELETEThis method removes the specified ad from the specified campaign.
/ad_campaign/{campaign_id}/ad/{ad_id} - PUTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/negative_keyword/{negative_keyword_id} - POSTThis method pauses a currently-active (RUNNING) threshold promotion and changes the state of the promotion from RUNNING to PAUSED.
/promotion/{promotion_id}/pause - POSTThis method restarts a threshold promotion that was previously paused and changes the state of the promotion from PAUSED to RUNNING.
/promotion/{promotion_id}/resume - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/keyword - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/ad_group - POSTThis method updates the bid percentage (also known as the "ad rate") for the specified ad in the specified campaign.
/ad_campaign/{campaign_id}/ad/{ad_id}/update_bid - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/bulk_create_keyword - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/bulk_update_keyword - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/bulk_update_ads_status - POSTThis method works with listing IDs created with either the Trading API or the Inventory API.
/ad_campaign/{campaign_id}/bulk_delete_ads_by_listing_id - POSTThis method works with listings created with either the Trading API or the Inventory API.
/ad_campaign/{campaign_id}/bulk_update_ads_bid_by_listing_id - POSTThis method works with listings that are managed with the Inventory API.
/ad_campaign/{campaign_id}/delete_ads_by_inventory_reference - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/bulk_update_ads_status_by_listing_id - POSTThis method works with listings created with the Inventory API.
/ad_campaign/{campaign_id}/bulk_delete_ads_by_inventory_reference - POSTThis method works with listings created with either the Trading API or the Inventory API.
/ad_campaign/{campaign_id}/bulk_update_ads_bid_by_inventory_reference - PUTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/keyword/{keyword_id} - PUTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/ad_group/{ad_group_id} - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/ad_group/{ad_group_id}/suggest_bids - POSTNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/ad_group/{ad_group_id}/suggest_keywords - POSTNote: Using multiple funding models in one report is deprecated.
/ad_report_task
What HumDay can read from eBay Marketing
These are the operations a schedule or a trigger can watch.
- GETThis method retrieves the details of a single campaign, as specified with the campaignname query parameter.
/ad_campaign/get_campaign_by_name - GETThis method retrieves the details of a single campaign, as specified with the campaignid query parameter.
/ad_campaign/{campaign_id} - GETThis method returns a list of a seller's undeleted promotions.
/promotion - GETThis method retrieves the details for all of the seller's defined campaigns.
/ad_campaign - GETThis method returns information on all the existing report tasks related to a seller.
/ad_report_task - GETThis method retrieves the campaigns containing the listing that is specified using either a listing ID, or an inventory reference ID and inventory reference type pair.
/ad_campaign/find_campaign_by_ad_reference - GETThis call returns the details of a specific Promoted Listings report task, as specified by the reporttaskid path parameter.
/ad_report_task/{report_task_id} - GETThis method returns the complete details of the item price markdown promotion that's indicated by the promotionid path parameter.
/item_price_markdown/{promotion_id} - GETNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/negative_keyword - GETThis method generates a report that lists the seller's running, paused, and ended promotions for the specified eBay marketplace.
/promotion_report - GETThis call retrieves information that details the fields used in each of the Promoted Listings reports.
/ad_report_metadata - GETThis method generates a report that summarizes the seller's promotions for the specified eBay marketplace.
/promotion_summary_report - GETNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/suggest_items - GETThis method retrieves Promoted Listings ads associated with listings that are managed with the Inventory API from the specified campaign.
/ad_campaign/{campaign_id}/get_ads_by_inventory_reference - GETThis call downloads the report as specified by the reportid path parameter.
/ad_report/{report_id} - GETThis method returns the complete details of the threshold promotion specified by the promotionid path parameter.
/item_promotion/{promotion_id} - GETThis method retrieves the specified ad from the specified campaign.
/ad_campaign/{campaign_id}/ad/{ad_id} - GETThis call retrieves metadata that details the fields used by a specific Promoted Listings report type.
/ad_report_metadata/{report_type} - GETNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/negative_keyword/{negative_keyword_id} - GETThis method retrieves Promoted Listings ads that are associated with listings created with either the Trading API or the Inventory API.
/ad_campaign/{campaign_id}/ad - GETNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/keyword - GETNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/ad_group - GETThis method returns the set of listings associated with the promotionid specified in the path parameter.
/promotion/{promotion_id}/get_listing_set - GETNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/keyword/{keyword_id} - GETNote: This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
/ad_campaign/{campaign_id}/ad_group/{ad_group_id}
How automating eBay Marketing works
- Describe the outcome. Say what you want to happen, in your own words. No node graphs, no field mapping.
- Approve the contract. HumDay writes down exactly what it will do, what it will touch, and what it will never do. You approve it before anything is built.
- See it proven. The program runs and shows you the result before it is allowed near your live eBay Marketing account.
- Grant access, then go live. You approve the specific eBay Marketing operations it may use — and only those.
Popular eBay Marketing integrations
Connect eBay Marketing to the tools people pair it with most.
- eBay Marketing and OData for namespace microsoft.graphintegration
- eBay Marketing and Cloudflareintegration
- eBay Marketing and NetBoxintegration
- eBay Marketing and GitHubintegration
- eBay Marketing and Mistintegration
- eBay Marketing and Loket.nlintegration
- eBay Marketing and Atlassian The Jira Cloud platformintegration
- eBay Marketing and Magento B2Bintegration
- eBay Marketing and Stripeintegration
- eBay Marketing and Zuora Reference Billingintegration
- eBay Marketing and bunqintegration
- eBay Marketing and DocuSignintegration
Automate eBay Marketing with these
- eBay Account36 operations
- eBay Analytics2 operations
- eBay Browse11 operations
- eBay Buy Marketing1 operations
- eBay Catalog2 operations
- eBay Charity2 operations
- eBay Compliance3 operations
- eBay Deal4 operations
- eBay Feed23 operations
- eBay Finances7 operations
- eBay Fulfillment15 operations
- eBay Identity1 operations
Categories
Questions about eBay Marketing automation
- Can HumDay connect to eBay Marketing?
- Yes. HumDay reads eBay Marketing's own published API description and derives the operations from it, so there is no hand-built connector to wait for. 69 operations are documented.
- Do I need to write code to automate eBay Marketing?
- No. You describe the outcome you want in plain words. HumDay agrees a contract with you, writes the program, and shows you a test run before anything touches your eBay Marketing account.
- What can HumDay do in eBay Marketing?
- 44 of the 69 documented operations change something in eBay Marketing, and 25 read from it. HumDay only ever uses the specific operations your approved contract needs.
- Is my eBay Marketing account safe?
- Your credentials are stored encrypted and are never shown in chat, code, or logs. Every run is limited to the operations you explicitly approved, and anything that writes to eBay Marketing is held behind that approval.
Where this came from
The operations above are read from a published API description for eBay Marketing at developer.ebay.com/api-docs/master/sell/marketing/openapi/3/sell_marketing_v1_oas3.json. Descriptions are the provider’s own words, not ours. Last published 2023-03-05.