Microconversions Endpoint

The Microconversions endpoint provides analytics for microconversion events—smaller actions users take before completing a main conversion (e.g., add‑to‑cart, newsletter signup).

---

Endpoint Details

• URL: https://app.sealmetrics.com/api/report/microconversions
• Method: GET
• Authentication: Bearer Token required

---

Request Parameters

Headers

Header	Value	Required
Authorization	Bearer {your_access_token}	Yes
Accept	application/json	Yes
Connection	keep-alive	Recommended
Accept-Encoding	gzip, deflate, br	Recommended

---

Query Parameters

Parameter	Type	Required	Description
account_id	string	Yes	Your account identifier
date_range	string	Yes	Date range (YYYYMMDD,YYYYMMDD or predefined values like this_month)
skip	int	No	Pagination offset (default: 0)
limit	int	No	Max results (default: 100, max: 100)
country	string	No	ISO 3166‑1 alpha‑2 country code filter

---

Example Requests

cURL

curl --location 'https://app.sealmetrics.com/api/report/microconversions?account_id=000000000000000000001234&date_range=this_month&skip=0&limit=100' --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImp0aSI...' --header 'Accept: application/json' --header 'Connection: keep-alive' --header 'Accept-Encoding: gzip, deflate, br'

---

Python

import requests

url = "https://app.sealmetrics.com/api/report/microconversions"

querystring = {
    "account_id": "000000000000000000001234",
    "date_range": "this_month",
    "skip": "0",
    "limit": "100"
}

headers = {
    "Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImp0aSI...",
    "Accept": "application/json",
    "Connection": "keep-alive",
    "Accept-Encoding": "gzip, deflate, br"
}

response = requests.get(url, headers=headers, params=querystring)
print(response.text)

---

JavaScript

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImp0aSI...");
myHeaders.append("Accept", "application/json");
myHeaders.append("Connection", "keep-alive");
myHeaders.append("Accept-Encoding", "gzip, deflate, br");

fetch("https://app.sealmetrics.com/api/report/microconversions?account_id=000000000000000000001234&date_range=this_month&skip=0&limit=100", {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
})
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

---

Response Example (200 OK)

{
  "status": "ok",
  "data": [
    {
      "_id": "67eaca8cadeb4e04b13d7df4",
      "date": "2025-03-31",
      "utm_term": "http://www.bergnaum.info/sit-tempora-ad-omnis-aut-voluptatem-aut",
      "utm_matchtype": null,
      "utm_campaign": "seo-yahoo",
      "utm_source": "seo",
      "utm_medium": "organic",
      "label": "add-to-cart"
    },
    {
      "_id": "67eaca7fba8c162635776cb1",
      "date": "2025-03-31",
      "utm_term": "https://www.keebler.com/aut-aut-aut-voluptatem-aut-aut-aut-aut",
      "utm_matchtype": null,
      "utm_campaign": "newsletter",
      "utm_source": "newsletter",
      "utm_medium": "email",
      "label": "newsletter-signup"
    }
  ]
}

---

Response Parameters

Field	Type	Description
_id	string	Unique microconversion ID
date	string	Date (YYYY-MM-DD)
utm_medium	string	Medium source (email, organic, etc.)
utm_source	string	Traffic source
utm_campaign	string	Campaign name
utm_term	string	Term or URL
utm_matchtype	string	Match type (nullable)
label	string	Microconversion type

---

Error Responses

401 Unauthorized

{
  "status": "error",
  "message": "Unauthenticated"
}

400 Bad Request

{
  "status": "error",
  "message": "Missing required parameter: account_id"
}

---

Notes

• Microconversions measure pre-conversion engagement.
• The label field identifies the microconversion type.
• Filtering by UTMs helps analyze funnel performance.
• Use pagination for large datasets.