List all available API endpoints in the OSMOS Marketing API registry with their methods and paths.

Get the OSMOS Marketing API service definition including base URL, authentication requirements, and campaign hierarchy.

Get the full OpenAPI-derived definition for a specific endpoint by id (request/response schemas, params, examples).

Create a new Sponsored Products Advertising (SPA) campaign. Creates a new SPA campaign with specified budget settings, bidding strategy, and campaign type. Supports AVERAGE_DAILY_BUDGET (default) and LIFETIME_BUDGET types.

List all SPA campaigns for an advertiser with pagination and optional status filter. Returns a paginated list of campaigns. Supports filtering by status (ACTIVE, PAUSED). Offset and limit are required for pagination.

Retrieve a specific SPA campaign by its ID. Returns the campaign details including budget settings, bidding strategy, dates, and status.

Update an existing SPA campaign. All fields are optional — send only the fields you want to change. To change the campaign's bidding strategy, send bidding_strategy.type. Switches are only allowed within the same bid-mode family — CPC family: MANUAL_CPC, MAX_PERFORMANCE_CPC, ROAS; CPM family: MANUAL

Create or update the product set for a campaign. Creates or updates the product set for a campaign. When products are selected within product sets, each product will function as an individual product ad. Supports AUTO mode (backend auto-selects products) and MANUAL mode (explicit product list).

Retrieve the product set for a campaign. Returns the product set configured for a campaign. Response is either a MANUAL product set (with explicit product list) or an AUTO product set.

Create or update positive keyword settings for a campaign. Creates or updates positive keyword settings for a campaign. Each keyword entry is either a create (no id) or an update (id required; keyword and match_type forbidden). To update a keyword, first fetch keywords via GET to obtain the keyword

Retrieve the positive keyword settings for a campaign. Returns the list of positive keywords for a campaign. Use this endpoint to fetch keyword ids before updating keyword bids or status.

Create or update negative keyword settings for a campaign. Creates or updates negative keyword settings for a campaign. Each keyword entry is either a create (no id) or an update (id and status required; keyword, match_type, and bid_value forbidden). BROAD match type is not allowed for negative keyw

Retrieve the negative keyword settings for a campaign. Returns the list of negative keywords for a campaign. Use this endpoint to fetch negative keyword ids before updating their status.

Create or update category bids for a campaign. Creates or updates the category bid settings for a campaign. When mode=MANUAL, the category_bids array is required. When mode=AUTO, the category_bids array is forbidden.

Retrieve the category bids for a campaign. Returns the list of category bids for a campaign, including spend, revenue, ROI, current bid value, and allowed/recommended bid ranges.

Save the networks a Sponsored Products campaign targets. Saves the networks a Sponsored Products campaign targets. Each call replaces the previously saved set; include every network the campaign should target. A campaign_id that does not exist for the advertiser returns 404 with code RESOURCE_NOT_FO

Get the networks a Sponsored Products campaign targets. Returns the networks a Sponsored Products campaign targets. A network is a retailer serving surface, such as a country-specific site or a storefront of the same retailer. A campaign with no saved network settings returns an empty networks array

Get forecast for a campaign. Returns the forecast for a campaign based on its current or overridden budget. Forecasting is not supported for LIFETIME_BUDGET campaigns.