Get details of a Campaign

Use the Get Campaign Details API to retrieve details of the SEM campaign with the specified Campaign ID. The Campaign's unique Campaign ID is required to get the campaign details.

Throttling

This API endpoint is throttled—if you submit too many feeds too quickly, you might hit Walmart’s rate limits and receive HTTP 429 responses. To learn more about throttling, refer to the Marketplace throttling documentation.

Endpoint

GET /v3/advertising/sem/campaigns/{campaignId}

Sample request

curl --location 'https://marketplace.walmartapis.com/v3/advertising/sem/campaigns/123456789' \
--header 'WM_SVC.NAME: Search Engine Marketing' \
--header 'WM_QOS.CORRELATION_ID: 01fc147d-b17e-4447-a443-5146a01776b3' \
--header 'WM_SEC.ACCESS_TOKEN: **********'

import requests url = 'https://marketplace.walmartapis.com/v3/advertising/sem/campaigns/123456789' headers = { 'WM_SVC.NAME': 'Search Engine Marketing', 'WM_QOS.CORRELATION_ID': '01fc147d-b17e-4447-a443-5146a01776b3', 'WM_SEC.ACCESS_TOKEN': '**********'
} response = requests.get(url, headers=headers) print(response.status_code)
print(response.text)

Modify your code

  1. Replace 123456789 in the URL with the actual campaign ID you want to use.
  2. Use your unique WM_QOS.CORRELATION_ID for each request.
  3. Use your unique WM_SEC.ACCESS_TOKEN obtained from the Token API.

Sample response

{ "campaignId": "123456789", "name": "New Year Campaign", "startDate": "2025-01-01", "endDate": "2025-01-31", "totalBudget": 1000, "targetRoas": 3, "status": "RUNNING", "createdDate": "2024-11-20"
}

Result

You'll get a status of the specified campaign.