AMALYZE Falcon API

advertising.spa.asins.data (POST)

Endpoint

Endpoint advertising.spa.asins.data returns statistiks on other ASINs purchased than the promoted ones.

Method

POST advertising.spa.asins.data

Example call

curl https://falcon.amalyze.com/<VERSION>/advertising.spa.asins.data \
-X POST \
-H "X-Falcon-Token: <YOUR-TOKEN-HERE>" \
-d '
{
	"filters":{
		"start":"2018-05-05",
		"end":"2018-07-10",
		"campaignId": "135555555111111"
	},
	"metrics": [
		"clicks",
		"impressions",
		"clickThroughRate",
		"salesSameSKU30D",
		"salesAllSKU30D",
		"salesPerUnitAllSKU30D"
	],
	"pagination":{
		"page":1,
		"size":10

	},"sorting":[
		{
			"direction":"desc",
			"column": "salesOtherSKU30D"
		}
	]

}
'

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

curl https://falcon.amalyze.com/<VERSION>/advertising.spa.asins.data \

-X POST \

-H "X-Falcon-Token: <YOUR-TOKEN-HERE>" \

-d '

{

"filters":{

"start":"2018-05-05",

"end":"2018-07-10",

"campaignId": "135555555111111"

},

"metrics": [

"clicks",

"impressions",

"clickThroughRate",

"salesSameSKU30D",

"salesAllSKU30D",

"salesPerUnitAllSKU30D"

],

"pagination":{

"page":1,

"size":10

},"sorting":[

{

"direction":"desc",

"column": "salesOtherSKU30D"

}

]

}

'

JSON Payload

{
	"filters":{
		"start":"2018-05-05",
		"end":"2018-07-10",
		"campaignId": "122233344455566"
	},
	"metrics": [
		"clicks",
		"impressions",
		"clickThroughRate",
		"salesSameSKU30D",
		"salesAllSKU30D",
		"salesPerUnitAllSKU30D"
	],
	"pagination":{
		"page":1,
		"size":10

	},"sorting":[
		{
			"direction":"desc",
			"column": "salesOtherSKU30D"
		}
	]

}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

{

"filters":{

"start":"2018-05-05",

"end":"2018-07-10",

"campaignId": "122233344455566"

},

"metrics": [

"clicks",

"impressions",

"clickThroughRate",

"salesSameSKU30D",

"salesAllSKU30D",

"salesPerUnitAllSKU30D"

],

"pagination":{

"page":1,

"size":10

},"sorting":[

{

"direction":"desc",

"column": "salesOtherSKU30D"

}

]

}

Property	Type	Description	Further information
`pagination`	object	The object containing the pagination information	pagination object definition
`filters`	object	The object containing the filter information
`filters.start`	date	String containing the start date	mandatory
`filters.end`	date	String containing the end date	mandatory
`filters.adgroup`	string	Filters for adgroup dimension	optional. Usage and valid filter for adgroup dimension
`filters.advertiser`	string	Filters for advertiser dimension	optional. Usage and valid filter for advertiser dimension
`filters.campaign`	string	Filters for campaign dimension	optional. Usage and valid filter for campaign dimension
`filters.marketplace`	string	Filters for marketplace dimension	optional. Usage and valid filter for marketplace dimension
`filters.promotedASIN`	string	Filter for the promoted ASIN	optional
`filters.purchasedASIN`	string	Filter for the purchased ASIN	optional
`filters.metrics`	string	Filter for metrics	optional. `salesOtherSKU1D` `salesOtherSKU7D` `salesOtherSKU14D` `salesOtherSKU30D` `unitsOtherSKU1D` `unitsOtherSKU7D` `unitsOtherSKU14D` `unitsOtherSKU30D` `salesPerUnitOtherSKU1D` `salesPerUnitOtherSKU7D` `salesPerUnitOtherSKU14D` `salesPerUnitOtherSKU30D`
`metrics`	array	Array containing the metrics to be returned	optional. `salesOtherSKU1D` `salesOtherSKU7D` `salesOtherSKU14D` `salesOtherSKU30D` `unitsOtherSKU1D` `unitsOtherSKU7D` `unitsOtherSKU14D` `unitsOtherSKU30D` `salesPerUnitOtherSKU1D` `salesPerUnitOtherSKU7D` `salesPerUnitOtherSKU14D` `salesPerUnitOtherSKU30D`
`sorting`	array	Array containing the sorting information
`sorting.column`	string	The column to sort	`advertiserId` `marketplaceId` `campaignId` `adgroupId` `keywordId`: sort by keyword’s id `keyword`: sort by keyword `keywordMatchType`sort by keyword’s match type `keywordState`sort by keyword state `searchterm` `salesOtherSKU1D` `salesOtherSKU7D` `salesOtherSKU14D` `salesOtherSKU30D` `unitsOtherSKU1D` `unitsOtherSKU7D` `unitsOtherSKU14D` `unitsOtherSKU30D` `salesPerUnitOtherSKU1D` `salesPerUnitOtherSKU7D` `salesPerUnitOtherSKU14D` `salesPerUnitOtherSKU30D`
`sorting.direction`	string	The direction to sort	valid direction values

JSON Response

{
    "items": [
        {
            "dimensions": {
                "advertiser": {
                    "id": "A3111111111111",
                    "name": "Sample advertise"
                },
                "marketplace": {
                    "id": "A1PA6795UKMFR9",
                    "name": "amazon.de"
                },
                "campaign": {
                    "id": "111111222222333",
                    "name": "Sample campaign",
                    "type": "sponsoredProducts",
                    "targeting": "auto",
                    "bidPlus": false,
                    "dailyBudget": 200,
                    "start": "2018-03-12T00:00:00+00:00",
                    "end": null,
                    "state": "enabled",
                    "amalyzeManaged": false,
                    "amalyzeTargeting": null,
                    "amalyzeOptimization": null
                },
                "adgroup": {
                    "id": "11111122222233",
                    "name": "Sample adgroup",
                    "state": "enabled",
                    "defaultBid": 0.33
                },
                "keyword": {
                    "id": "111111222222333",
                    "keyword": "(_targeting_auto_)",
                    "matchtType": "broad",
                    "state": "enabled",
                    "bid": null
                },
                "promotedASIN": {
                    "asin": "B000000000"
                },
                "purchasedASIN": {
                    "asin": "B111111111"
                }
            },
            "metrics": {
                "clicks": 0,
                "impressions": 0,
                "clickThroughRate": null,
                "salesSameSKU30D": 0,
                "salesAllSKU30D": 0,
                "salesPerUnitAllSKU30D": null
            }
        }
    ],
    "pagination": {
        "filtered": 617
    },
    "request": {
        "id": "d8222b50-5576-4357-a194-05223ac902b1",
        "took": 0.8276,
        "costs": 0,
        "remaining": 100000,
        "method": "advertising.spa.asins.data",
        "success": true,
        "error": {
            "code": null,
            "message": null,
            "hint": null
        }
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

{

"items": [

{

"dimensions": {

"advertiser": {

"id": "A3111111111111",

"name": "Sample advertise"

},

"marketplace": {

"id": "A1PA6795UKMFR9",

"name": "amazon.de"

},

"campaign": {

"id": "111111222222333",

"name": "Sample campaign",

"type": "sponsoredProducts",

"targeting": "auto",

"bidPlus": false,

"dailyBudget": 200,

"start": "2018-03-12T00:00:00+00:00",

"end": null,

"state": "enabled",

"amalyzeManaged": false,

"amalyzeTargeting": null,

"amalyzeOptimization": null

},

"adgroup": {

"id": "11111122222233",

"name": "Sample adgroup",

"state": "enabled",

"defaultBid": 0.33

},

"keyword": {

"id": "111111222222333",

"keyword": "(_targeting_auto_)",

"matchtType": "broad",

"state": "enabled",

"bid": null

},

"promotedASIN": {

"asin": "B000000000"

},

"purchasedASIN": {

"asin": "B111111111"

}

},

"metrics": {

"clicks": 0,

"impressions": 0,

"clickThroughRate": null,

"salesSameSKU30D": 0,

"salesAllSKU30D": 0,

"salesPerUnitAllSKU30D": null

}

],

"pagination": {

"filtered": 617

},

"request": {

"id": "d8222b50-5576-4357-a194-05223ac902b1",

"took": 0.8276,

"costs": 0,

"remaining": 100000,

"method": "advertising.spa.asins.data",

"success": true,

"error": {

"code": null,

"message": null,

"hint": null

}

Property	Type	Description
`items`	array	Array containing the merchant / vendor items
`metrics`	object	Object containing the requested metrics
`dimensions`	object	Object containing the dimensions
`dimensions.advertiser`	object	Object containing the advertiser dimension object advertiser definition
`dimensions.marketplace`	object	Object containing the marketplace dimension object marketplace definition
`dimensions.campaign`	object	Object containing the campaign dimension object campaign definition
`dimensions.adgroup`	object	Object containing the adgroup dimension object adgroup definition
`dimensions.keyword`	object	Object containing the keyword dimension object keyword definition
`dimension.promotedASIN`	object	Object containing the promoted ASIN dimension object
`dimension.promotedASIN.asin`	string	String containing the ASIN of the promoted ASIN
`dimension.purchasedASIN`	object	Object containing the purchased ASIN dimension object
`dimension.purchasdASIN.asin`	string	String containing the ASIN of the purchased ASIN
`request`	object	The request information object (see request information object definition for more information)