curl --request GET \
--url https://api.interchange.io/api/v2/storefront/seller-analytics \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/storefront/seller-analytics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/storefront/seller-analytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"generatedAt": "2023-11-07T05:31:56Z",
"window": {
"requestedRunLimit": 4503599627370496,
"runCount": 4503599627370495,
"firstRunAt": "2023-11-07T05:31:56Z",
"lastRunAt": "2023-11-07T05:31:56Z"
},
"summary": {
"totalRuns": 4503599627370495,
"okRuns": 4503599627370495,
"skippedRuns": 4503599627370495,
"errorRuns": 4503599627370495,
"briefRuns": 4503599627370495,
"refineRuns": 4503599627370495,
"wholesaleRuns": 4503599627370495,
"totalShownProducts": 4503599627370495,
"averageShownProducts": 1,
"priceObjectionCount": 4503599627370495,
"packagingAskCount": 4503599627370495,
"requestAskCount": 4503599627370495,
"productAskCount": 4503599627370495,
"proposalAskCount": 4503599627370495,
"appliedRefinements": 4503599627370495,
"partialRefinements": 4503599627370495,
"unableRefinements": 4503599627370495
},
"outcomes": {
"attributedRunCount": 4503599627370495,
"eventCount": 4503599627370495,
"submittedCount": 4503599627370495,
"forwardedCount": 4503599627370495,
"forwardFailedCount": 4503599627370495,
"rejectedCount": 4503599627370495,
"deliveryReportedCount": 4503599627370495,
"bookedMediaBuyCount": 4503599627370495,
"bookedBudget": 1,
"deliveredImpressions": 4503599627370495,
"deliveredSpend": 1,
"deliveredCurrency": "<string>"
},
"historicalPerformance": {
"runCount": 4503599627370495,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"askRunCount": 4503599627370495,
"askToBookConversionRate": 1,
"priceObjectionConversionRate": 1,
"packagingAskConversionRate": 1,
"averageBookedBudget": 1,
"averageProductsPerRun": 1,
"averageProductsPerBookedRun": 1,
"averageProductsPerUnbookedRun": 1,
"deliveryRate": 1,
"repeatBuyerCount": 4503599627370495
},
"seasonality": [
{
"period": "<string>",
"runCount": 4503599627370495,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"askRunCount": 4503599627370495,
"askToBookConversionRate": 1,
"priceObjectionCount": 4503599627370495,
"packagingAskCount": 4503599627370495,
"bookedBudget": 1,
"averageBookedBudget": 1,
"averageShownProducts": 1
}
],
"buyers": [
{
"operatorDomain": "<string>",
"brandDomain": "<string>",
"country": "<string>",
"firstRunAt": "2023-11-07T05:31:56Z",
"lastRunAt": "2023-11-07T05:31:56Z",
"runCount": 4503599627370495,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"askRunCount": 4503599627370495,
"askToBookConversionRate": 1,
"attributedRunCount": 4503599627370495,
"eventCount": 4503599627370495,
"totalShownProducts": 4503599627370495,
"averageShownProducts": 1,
"priceObjectionCount": 4503599627370495,
"packagingAskCount": 4503599627370495,
"requestAskCount": 4503599627370495,
"productAskCount": 4503599627370495,
"proposalAskCount": 4503599627370495,
"bookedMediaBuyCount": 4503599627370495,
"bookedBudget": 1,
"averageBookedBudget": 1,
"deliveredImpressions": 4503599627370495,
"deliveredSpend": 1,
"deliveredCurrency": "<string>"
}
],
"postureConversion": {
"byPosture": [
{
"runCount": 4503599627370496,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"bookedBudget": 1
}
],
"adherence": {
"comparableRunCount": 4503599627370495,
"followedCount": 4503599627370495,
"followedWinRate": 1,
"divergedWinRate": 1
}
},
"learnedDefault": {
"reason": "<string>",
"checkedAt": "2023-11-07T05:31:56Z"
},
"strategySignals": [
{
"id": "<string>",
"label": "<string>",
"detail": "<string>",
"evidence": [
{
"label": "<string>",
"value": "<string>"
}
]
}
],
"sellerRecommendations": [
{
"id": "<string>",
"title": "<string>",
"detail": "<string>",
"action": "<string>",
"buyer": {
"operatorDomain": "<string>",
"brandDomain": "<string>",
"country": "<string>"
},
"evidence": [
{
"label": "<string>",
"value": "<string>"
}
]
}
],
"runs": [
{
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"buyingMode": "<string>",
"resultCode": "<string>",
"buyer": {
"operatorDomain": "<string>",
"brandDomain": "<string>",
"country": "<string>"
},
"shownProductCount": 4503599627370495,
"minSellPrice": 123,
"maxSellPrice": 123,
"requestAskCount": 4503599627370495,
"productAskCount": 4503599627370495,
"proposalAskCount": 4503599627370495,
"hadPriceObjection": true,
"hadPackagingAsk": true,
"refinementStatusCounts": {
"applied": 4503599627370495,
"partial": 4503599627370495,
"unable": 4503599627370495
},
"outcome": {
"eventCount": 4503599627370495,
"latestType": "<string>",
"latestStatus": "<string>",
"mediaBuyId": "<string>",
"submittedCount": 4503599627370495,
"forwardedCount": 4503599627370495,
"forwardFailedCount": 4503599627370495,
"rejectedCount": 4503599627370495,
"deliveryReportedCount": 4503599627370495,
"bookedMediaBuyCount": 4503599627370495,
"bookedBudget": 1,
"deliveredImpressions": 4503599627370495,
"deliveredSpend": 1,
"deliveredCurrency": "<string>"
}
}
],
"topProducts": [
{
"productId": "<string>",
"name": "<string>",
"impressions": 4503599627370495
}
],
"notes": [
"<string>"
]
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Get the seller-analytics posture-conversion rollup
Conversion rolled up by the negotiation posture the agent used over recent intelligence runs: per-posture run count, booked count, win rate, and booked budget, plus a recommendation-adherence summary (how often the selected posture matched the history-derived recommendation and whether following it converted better). Read ?limit= to set the window size (default 100). Runs where no composition ran are excluded from the denominators.
curl --request GET \
--url https://api.interchange.io/api/v2/storefront/seller-analytics \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/storefront/seller-analytics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/storefront/seller-analytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"generatedAt": "2023-11-07T05:31:56Z",
"window": {
"requestedRunLimit": 4503599627370496,
"runCount": 4503599627370495,
"firstRunAt": "2023-11-07T05:31:56Z",
"lastRunAt": "2023-11-07T05:31:56Z"
},
"summary": {
"totalRuns": 4503599627370495,
"okRuns": 4503599627370495,
"skippedRuns": 4503599627370495,
"errorRuns": 4503599627370495,
"briefRuns": 4503599627370495,
"refineRuns": 4503599627370495,
"wholesaleRuns": 4503599627370495,
"totalShownProducts": 4503599627370495,
"averageShownProducts": 1,
"priceObjectionCount": 4503599627370495,
"packagingAskCount": 4503599627370495,
"requestAskCount": 4503599627370495,
"productAskCount": 4503599627370495,
"proposalAskCount": 4503599627370495,
"appliedRefinements": 4503599627370495,
"partialRefinements": 4503599627370495,
"unableRefinements": 4503599627370495
},
"outcomes": {
"attributedRunCount": 4503599627370495,
"eventCount": 4503599627370495,
"submittedCount": 4503599627370495,
"forwardedCount": 4503599627370495,
"forwardFailedCount": 4503599627370495,
"rejectedCount": 4503599627370495,
"deliveryReportedCount": 4503599627370495,
"bookedMediaBuyCount": 4503599627370495,
"bookedBudget": 1,
"deliveredImpressions": 4503599627370495,
"deliveredSpend": 1,
"deliveredCurrency": "<string>"
},
"historicalPerformance": {
"runCount": 4503599627370495,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"askRunCount": 4503599627370495,
"askToBookConversionRate": 1,
"priceObjectionConversionRate": 1,
"packagingAskConversionRate": 1,
"averageBookedBudget": 1,
"averageProductsPerRun": 1,
"averageProductsPerBookedRun": 1,
"averageProductsPerUnbookedRun": 1,
"deliveryRate": 1,
"repeatBuyerCount": 4503599627370495
},
"seasonality": [
{
"period": "<string>",
"runCount": 4503599627370495,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"askRunCount": 4503599627370495,
"askToBookConversionRate": 1,
"priceObjectionCount": 4503599627370495,
"packagingAskCount": 4503599627370495,
"bookedBudget": 1,
"averageBookedBudget": 1,
"averageShownProducts": 1
}
],
"buyers": [
{
"operatorDomain": "<string>",
"brandDomain": "<string>",
"country": "<string>",
"firstRunAt": "2023-11-07T05:31:56Z",
"lastRunAt": "2023-11-07T05:31:56Z",
"runCount": 4503599627370495,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"askRunCount": 4503599627370495,
"askToBookConversionRate": 1,
"attributedRunCount": 4503599627370495,
"eventCount": 4503599627370495,
"totalShownProducts": 4503599627370495,
"averageShownProducts": 1,
"priceObjectionCount": 4503599627370495,
"packagingAskCount": 4503599627370495,
"requestAskCount": 4503599627370495,
"productAskCount": 4503599627370495,
"proposalAskCount": 4503599627370495,
"bookedMediaBuyCount": 4503599627370495,
"bookedBudget": 1,
"averageBookedBudget": 1,
"deliveredImpressions": 4503599627370495,
"deliveredSpend": 1,
"deliveredCurrency": "<string>"
}
],
"postureConversion": {
"byPosture": [
{
"runCount": 4503599627370496,
"bookedRunCount": 4503599627370495,
"winRate": 1,
"bookedBudget": 1
}
],
"adherence": {
"comparableRunCount": 4503599627370495,
"followedCount": 4503599627370495,
"followedWinRate": 1,
"divergedWinRate": 1
}
},
"learnedDefault": {
"reason": "<string>",
"checkedAt": "2023-11-07T05:31:56Z"
},
"strategySignals": [
{
"id": "<string>",
"label": "<string>",
"detail": "<string>",
"evidence": [
{
"label": "<string>",
"value": "<string>"
}
]
}
],
"sellerRecommendations": [
{
"id": "<string>",
"title": "<string>",
"detail": "<string>",
"action": "<string>",
"buyer": {
"operatorDomain": "<string>",
"brandDomain": "<string>",
"country": "<string>"
},
"evidence": [
{
"label": "<string>",
"value": "<string>"
}
]
}
],
"runs": [
{
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"buyingMode": "<string>",
"resultCode": "<string>",
"buyer": {
"operatorDomain": "<string>",
"brandDomain": "<string>",
"country": "<string>"
},
"shownProductCount": 4503599627370495,
"minSellPrice": 123,
"maxSellPrice": 123,
"requestAskCount": 4503599627370495,
"productAskCount": 4503599627370495,
"proposalAskCount": 4503599627370495,
"hadPriceObjection": true,
"hadPackagingAsk": true,
"refinementStatusCounts": {
"applied": 4503599627370495,
"partial": 4503599627370495,
"unable": 4503599627370495
},
"outcome": {
"eventCount": 4503599627370495,
"latestType": "<string>",
"latestStatus": "<string>",
"mediaBuyId": "<string>",
"submittedCount": 4503599627370495,
"forwardedCount": 4503599627370495,
"forwardFailedCount": 4503599627370495,
"rejectedCount": 4503599627370495,
"deliveryReportedCount": 4503599627370495,
"bookedMediaBuyCount": 4503599627370495,
"bookedBudget": 1,
"deliveredImpressions": 4503599627370495,
"deliveredSpend": 1,
"deliveredCurrency": "<string>"
}
}
],
"topProducts": [
{
"productId": "<string>",
"name": "<string>",
"impressions": 4503599627370495
}
],
"notes": [
"<string>"
]
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Query Parameters
How many of the most recent intelligence runs to aggregate over.
1 <= x <= 200100
Response
Get the seller-analytics posture-conversion rollup
Seller-facing analytics rollup over a window of recent intelligence runs: summary KPIs, commercial outcomes, posture conversion with recommendation-adherence, recommendations, and recent runs.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes