AMALYZE Falcon API

notifications.products (PUT)

Endpoint

Endpoint notifications.products sets for individual user notifications for product changes

Endpoint

PUT notifications.products

Example call

curl https://falcon.amalyze.com/<VERSION>/notifications.products \
-H "X-Falcon-Token: <YOUR-TOKEN-HERE>" \
-X PUT \
-d '
{
	"asins": [
		{
			"asin": "B00OCZAE5K",
			"marketplace": "A1PA6795UKMFR9"
		},
		{
			"asin": "B07FX3N1WG",
			"marketplace": "A1PA6795UKMFR9"
		}		
	],
	"notifications": [
		{
			"user": "01234-456789-0123-56789",
			"type": "content.bulletpoints"
		},
		{
			"user": "01234-456789-0123-56789",
			"type": "buybox.price"
		}		
	]
}'

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

curl https://falcon.amalyze.com/<VERSION>/notifications.products \

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

-X PUT \

-d '

{

"asins": [

{

"asin": "B00OCZAE5K",

"marketplace": "A1PA6795UKMFR9"

},

{

"asin": "B07FX3N1WG",

"marketplace": "A1PA6795UKMFR9"

}

],

"notifications": [

{

"user": "01234-456789-0123-56789",

"type": "content.bulletpoints"

},

{

"user": "01234-456789-0123-56789",

"type": "buybox.price"

}

]

}'

JSON Payload

{
	"asins": [
		{
			"asin": "B00OCZAE5K",
			"marketplace": "A1PA6795UKMFR9"
		},
		{
			"asin": "B07FX3N1WG",
			"marketplace": "A1PA6795UKMFR9"
		}		
	],
	"notifications": [
		{
			"user": "01234-456789-0123-56789",
			"type": "content.bulletpoints"
		},
		{
			"user": "01234-456789-0123-56789",
			"type": "buybox.price"
		}		
	]
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

{

"asins": [

{

"asin": "B00OCZAE5K",

"marketplace": "A1PA6795UKMFR9"

},

{

"asin": "B07FX3N1WG",

"marketplace": "A1PA6795UKMFR9"

}

],

"notifications": [

{

"user": "01234-456789-0123-56789",

"type": "content.bulletpoints"

},

{

"user": "01234-456789-0123-56789",

"type": "buybox.price"

}

]

}

Property	Type	Description	Further information
`asins`	array	Array containing the asin object
`asins.asin`	string	String containing the ASIN
`asins.marketplace`	string	String containing the marketplace id	valid marketplaces ids
`notifications`	array	Array containing the notification object
`notifications.user`	string	String containing the id of the user, who shall be notified
`notifications.type`	string	String containing the type of notification	`content.category` `content.image` `content.title` `content.bulletpoints` `content.parent` `buybox.price` `buybox.unitPrice` `buybox.merchant` `offers.merchants` `reviews.reviews` `reviews.rating` `badge.bestseller`

JSON Response

{
    "request": {
        "id": "09b861f0-8825-4152-aa3e-c4375c6d4dba",
        "took": 7.3381,
        "costs": 0,
        "remaining": 100000,
        "method": "notifications.products",
        "success": true,
        "error": {
            "code": null,
            "message": null,
            "hint": null
        },
        "cache": {
            "cached": false,
            "id": null
        }
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

{

"request": {

"id": "09b861f0-8825-4152-aa3e-c4375c6d4dba",

"took": 7.3381,

"costs": 0,

"remaining": 100000,

"method": "notifications.products",

"success": true,

"error": {

"code": null,

"message": null,

"hint": null

},

"cache": {

"cached": false,

"id": null

}

Property	Type	Description
`request`	object	The request information object (see request information object definition for more information)

Updates / Changes

Version	Description
0.6.0	added `content.parent` as possible option to `notifications.type`
	added `buybox.unitPrice` as possible option to `notifications.type`
0.2.4	added `offers.merchants` as possible option to `notifications.type`
0.2.4	added `buybox.price` as possible option to `notificattions.type`
0.2.4	removed `buybox.price.abs` from `notifications.type`
0.2.4	removed `buybox.price.perc` from `notifications.type`
0.2.4	removed `notifications.range`
0.2.3	created