Company Growth Report API

Compare trade partners across two time periods and classify them as new, lost or retained. Use `min_count` to filter out low-frequency partners.

ENDPOINTS

POST /api/v1/company/companyGrowth

Request parameters

com_role

integer

Company role in trade. 1 = buyer, 2 = supplier.

Required: Yes
Example: 2

com_id

string

Company ID.

Required: Yes
Example: 7d1a1465baae3ba2b2e51e1ae529285d

pre_date

array<integer>

Baseline comparison period. Two-element array [YYYYMMDD, YYYYMMDD].

Required: Yes
Example: [20230101, 20230630]

date

array<integer>

Current period. Two-element array [YYYYMMDD, YYYYMMDD].

Required: Yes
Example: [20230701, 20231231]

min_count

integer

Minimum transaction count threshold. Partners with fewer transactions are excluded.

Required: No
Example: 10

Request Example

{
    "com_role": 2,
    "com_id": "7d1a1465baae3ba2b2e51e1ae529285d",
    "pre_date": [
        20230101,
        20230630
    ],
    "date": [
        20230701,
        20231231
    ],
    "min_count": 10
}

curl https://api.tradedata.io/api/v1/company/companyGrowth \
  -H "Authorization: Bearer yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{"com_role": 2, "com_id": "7d1a1465baae3ba2b2e51e1ae529285d", "pre_date": [20230101, 20230630], "date": [20230701, 20231231], "min_count": 10}'

import requests

response = requests.post(
    "https://api.tradedata.io/api/v1/company/companyGrowth",
    headers={
        "Authorization": "Bearer yourTokenHere",
        "Content-Type": "application/json",
    },
    json={
        "com_role": 2,
        "com_id": "7d1a1465baae3ba2b2e51e1ae529285d",
        "pre_date": [
            20230101,
            20230630,
        ],
        "date": [
            20230701,
            20231231,
        ],
        "min_count": 10,
    },
)
print(response.json())

const response = await fetch("https://api.tradedata.io/api/v1/company/companyGrowth", {
  method: "POST",
  headers: {
    "Authorization": "Bearer yourTokenHere",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "com_role": 2,
    "com_id": "7d1a1465baae3ba2b2e51e1ae529285d",
    "pre_date": [
      20230101,
      20230630
    ],
    "date": [
      20230701,
      20231231
    ],
    "min_count": 10
  }),
});
const data = await response.json();

<?php
$ch = curl_init("https://api.tradedata.io/api/v1/company/companyGrowth");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer yourTokenHere",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "com_role" => 2,
        "com_id" => "7d1a1465baae3ba2b2e51e1ae529285d",
        "pre_date" => [
            20230101,
            20230630
        ],
        "date" => [
            20230701,
            20231231
        ],
        "min_count" => 10
    ]),
]);
echo curl_exec($ch);

Response parameters

data.new_partner

array

Partners that appeared in the current period but not the baseline.

data.new_partner.id

string

Partner company ID.

Example: e37485ad9baa3c42bec805ff389ce8a3

data.new_partner.val

string

Partner company name.

Example: DACHSER TRANSPORT & LOGISTICS

data.new_partner.amount

string

Trade amount (USD).

Example: 2.07722E+8

data.new_partner.count

string

Number of transactions.

Example: 54

data.new_partner.weight

string

Janeght (kg).

Example: 615240.0

data.new_partner.first_date

string

First transaction date in current period.

Example: 2023-07-27T00:00:00Z

data.lost_partner

array

Partners present in the baseline but absent in the current period.

data.lost_partner.id

string

Partner company ID.

Example: e7a11789e5ca3107b1e22ebfe25a336a

data.lost_partner.val

string

Partner company name.

Example: CLEMENGER INTERNATIONAL

data.lost_partner.amount

string

Trade amount (USD) in baseline period.

Example: 0.0

data.lost_partner.count

string

Number of transactions.

Example: 23

data.lost_partner.weight

string

Janeght (kg).

Example: 360387.0

data.lost_partner.last_date

string

Last transaction date in baseline period.

Example: 2023-04-26T00:00:00Z

data.retains

array

Partners active in both periods. Each entry contains previous (baseline stats) and recent (current stats).

data.retains.previous

object

Partner stats in the baseline period.

data.retains.recent

object

Partner stats in the current period.

Response Example

{
    "code": 200,
    "success": true,
    "data": {
        "new_partner": [
            {
                "id": "e37485ad9baa3c42bec805ff389ce8a3",
                "val": "DACHSER TRANSPORT & LOGISTICS",
                "amount": "2.07722E+8",
                "count": "54",
                "weight": "615240.0",
                "first_date": "2023-07-27T00:00:00Z"
            }
        ],
        "lost_partner": [
            {
                "id": "e7a11789e5ca3107b1e22ebfe25a336a",
                "val": "CLEMENGER INTERNATIONAL",
                "amount": "0.0",
                "count": "23",
                "weight": "360387.0",
                "last_date": "2023-04-26T00:00:00Z"
            }
        ],
        "retains": [
            {
                "previous": {
                    "id": "dfcea28daff639d3aca07190d801195f",
                    "val": "DACHSER USA AIR & SEA LOGISTICS INC",
                    "amount": "0.0",
                    "count": "1233",
                    "weight": "23754041.537963867"
                },
                "recent": {
                    "id": "dfcea28daff639d3aca07190d801195f",
                    "val": "DACHSER USA AIR & SEA LOGISTICS INC",
                    "amount": "0.0",
                    "count": "1106",
                    "weight": "18245013.002807617"
                }
            }
        ]
    },
    "msg": "OK",
    "total": 0,
    "pageSize": 0,
    "current": 0,
    "sumResult": null
}

Company Trade Partner Analysis API

Retrieve a ranked list of trade partners (buyers or suppliers) for a company in a given date range.

Company Filter List API

Retrieve available filter options (ports, countries, datasources) for a company's trade records. Use the same query parameters as companyDetail for consistent results, and call it once per query rather than on every page change.