Warning

This site is no longer being maintained. Visit the eDocs documentation portal for updated information.

Visit eDocs
Dismiss message

Events

Created by Pedro Ondiviela · last update June 8, 2020

About this Endpoint

Process received tagging events to get user behaviours.

POST https://api.empathybroker.com/contextsearch/v2/events/

Query Parameters Not needed

Body

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

[
  {
    "site_id": "site_id",
    "event_type": "query",
    "metadata": {
        "equalize_id": "equalize_id", // the equalizer identifier applied during the search the request
        "timestamp": 123123123123, // timestamp (in epoch milliseconds) when the event was originated
        "host_referrer": "", // HTTP Referer
        "user_agent": "", // HTTP User-Agent,
        "ip": "127.0.0.1",
        "geo_ip": {
            "country": "ES",
            "city": "Madrid",
            "latitude": 40.417,
            "longitude": -3.703,
        }
    },
    "fields": {
        // global fields
        "user": "user_id_hash",
        "session": "session_id_hash",
        "front": "default",
        "q": "blue dress",
        "page": 1,

        // click/add2cart/wishlist fields
        "title": "Product Title",
        "product_id": "12345678",
        "url": "http://empathybroker.com/",
        "type": 1,
        "position": 1
    },
    "filters": {
        "lang": "en",
        "scope": "mobile",
        "store": "1234",
        "catalog": "5678"
    },
    "extra_fields": {
        "origin": "default",
        "user_type": "recurrent",
        "spellcheck": "false",
        "filtered": "false",
        "contextualize": "true",

        // click/add2cart/wishlist fields
        "boosted": "default",
        "boostedId": "1234"
    },
    "schema_version": "v2"   
  }
]

Responses

Responses examples for successful and failing calls to the endpoint.

200 401 403

Successful information retrieve

Type: application/json

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

{
  "status": "ok",
  "entity": {
    "errors": [
      {
        "position": 3,
        "status": "errors"
      }
    ],
    "ignored": [
      {
        "position": 0,
        "status": "ignored"
      }
    ],
    "processed": [
      {
        "position": 1,
        "status": "ok"
      },
      {
        "position": 2,
        "status": "ok"
      }
    ]
  }
}