Sevkiyatlar

Tekil sevkiyat kayıtlarını arama ve sayma endpoint'leri.

Tüm istekler X-API-KEY ve X-SIGNATURE header'ları gerektirir. Bkz. Kimlik Doğrulama.

POST /api/v1/shipment/search

Belirtilen filtre kriterlerine uyan sevkiyat kayıtlarını arar.

Request Body

Alan	Tip	Zorunlu	Kısıtlar	Açıklama
size	integer	Evet	min: 10, max: 10000	Dönecek sevkiyat kaydı sayısı
account_name	string	Hayır	—	İstek için hesap bağlamı
importer_countries	array[string]	Hayır	max 10 öğe	İthalatçı ülkeye göre filtreleyen ISO ülke kodları
exporter_countries	array[string]	Hayır	max 10 öğe	İhracatçı ülkeye göre filtreleyen ISO ülke kodları
hs_codes	array[string]	Hayır	max 10 öğe; yalnızca rakam	Filtrelenecek HS kodları
start_date	string	Hayır	format: `yyyy-MM-dd`	Sevkiyat tarih aralığı başlangıcı
end_date	string	Hayır	format: `yyyy-MM-dd`	Sevkiyat tarih aralığı bitişi
firm_filter	array[integer]	Hayır	—	Firma tipi kodları
search_type	string	Hayır	`"importer"` veya `"exporter"`	Aranacak ticaret yönü
product_detail	string	Hayır	min 3 karakter	Ürün açıklaması anahtar kelimesi
exporter_firm	string	Hayır	min 3 karakter	İhracatçı firma adı anahtar kelimesi
importer_firm	string	Hayır	min 3 karakter	İthalatçı firma adı anahtar kelimesi
brand_name	string	Hayır	min 3 karakter	Marka adı anahtar kelimesi
arrival_port	string	Hayır	min 3 karakter	Varış limanı anahtar kelimesi
departure_port	string	Hayır	min 3 karakter	Çıkış limanı anahtar kelimesi

Response

Alan	Tip	Açıklama
total	integer	Sorguya uyan toplam sevkiyat kaydı sayısı
shipments	array[Shipment]	Sevkiyat kayıtları listesi

Örnek

JavaScriptcURLJavaPython

import crypto from 'crypto'

const payload = JSON.stringify({
  size: 100,
  search_type: 'importer',
  importer_countries: ['US'],
  hs_codes: ['847130'],
  start_date: '2024-06-01',
  end_date: '2024-06-30'
})

const signature = crypto
  .createHmac('sha256', 'api-secretiniz')
  .update(payload)
  .digest('base64')

const res = await fetch('https://apiv2.tradeatlas.com/api/v1/shipment/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'api-keyiniz',
    'X-SIGNATURE': signature
  },
  body: payload
})
const data = await res.json()

bash

PAYLOAD='{"size":100,"search_type":"importer","importer_countries":["US"],"hs_codes":["847130"],"start_date":"2024-06-01","end_date":"2024-06-30"}'

SIGNATURE=$(echo -n "$PAYLOAD" | openssl dgst -sha256 -hmac "api-secretiniz" -binary | base64)

curl -X POST https://apiv2.tradeatlas.com/api/v1/shipment/search \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: api-keyiniz" \
  -H "X-SIGNATURE: $SIGNATURE" \
  -d "$PAYLOAD"

java

String payload = "{\"size\":100,\"search_type\":\"importer\",\"importer_countries\":[\"US\"],\"hs_codes\":[\"847130\"],\"start_date\":\"2024-06-01\",\"end_date\":\"2024-06-30\"}";

Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec("api-secretiniz".getBytes(StandardCharsets.UTF_8), "HmacSHA256"));
String signature = Base64.getEncoder()
    .encodeToString(mac.doFinal(payload.getBytes(StandardCharsets.UTF_8)));

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://apiv2.tradeatlas.com/api/v1/shipment/search"))
    .header("Content-Type", "application/json")
    .header("X-API-KEY", "api-keyiniz")
    .header("X-SIGNATURE", signature)
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

python

import hmac, hashlib, base64, requests

payload = '{"size":100,"search_type":"importer","importer_countries":["US"],"hs_codes":["847130"],"start_date":"2024-06-01","end_date":"2024-06-30"}'

signature = base64.b64encode(
    hmac.new("api-secretiniz".encode(), payload.encode(), hashlib.sha256).digest()
).decode()

response = requests.post(
    "https://apiv2.tradeatlas.com/api/v1/shipment/search",
    headers={
        "Content-Type": "application/json",
        "X-API-KEY": "api-keyiniz",
        "X-SIGNATURE": signature,
    },
    data=payload,
)
data = response.json()

Yanıt

json

{
    "total": 5008,
    "shipments": [
        {
            "importerName": "THE MARKETING GROUP BRANDS INC",
            "importerTaxId": "2024063707114",
            "importerAddress": "3824 Cedar Springs Road, Suite 1030, Dallas Tx 75219 United States",
            "importerCountry": "United States",
            "importerCityState": "Us - Texas",
            "importerEmail": ".",
            "importerFacebook": ".",
            "importerFax": ".",
            "importerInstagram": ".",
            "importerLinkedin": ".",
            "importerTel": ".",
            "importerTwitter": ".",
            "importerWeb": ".",
            "importerCleanUrl": "the-marketing-group-brands-inc",
            "importerUrlCode": "765f4cd6b4f47a12",
            "importerCompanyTypeCode": "0",
            "importerCountryCode": "US",
            "importerTaCode": "us53159774",
            "exporterName": "FOSHAN JUNHUA LIGHTING & ELECTRICAL",
            "exporterTaxId": ".",
            "exporterAddress": "Fuan Industry District,Leliu Town,S, Hunde,,Fo Shan,Cn",
            "exporterCountry": "China",
            "exporterCityState": "China",
            "exporterEmail": ".",
            "exporterFacebook": ".",
            "exporterFax": ".",
            "exporterInstagram": ".",
            "exporterLinkedin": ".",
            "exporterTel": ".",
            "exporterTwitter": ".",
            "exporterWeb": ".",
            "exporterCleanUrl": "foshan-junhua-lighting-electrical",
            "exporterUrlCode": "2aca2efaae0de5fb",
            "exporterCompanyTypeCode": "0",
            "exporterCountryCode": "CN",
            "exporterTaCode": "cn06641255",
            "arrivalDate": "2024-06-30",
            "billOfLadingNo": "MEDUZV609116",
            "conditionNewUsed": "",
            "containerCount": "0.0",
            "countryOfOrigin": "CN",
            "fobValue": "0.00",
            "fobCurrency": "",
            "usdFob": "0.00",
            "cifValue": "0.00",
            "cifCurrency": "",
            "usdCif": "0.00",
            "unitPrice": "0.00",
            "fiCurrency": "",
            "freightAmount": "0.0",
            "grossWeight": "0.00",
            "grossWeightUnit": "",
            "netWeight": "5235.00",
            "netWeightUnit": "Kilogram",
            "quantity": "1700.00",
            "quantityUnit": "Carton",
            "packageAmount": "0.00",
            "packagesUnit": "",
            "hsCode": "8471309000",
            "hsCodeDescription": "",
            "hsCodeKeyword": "847130",
            "insuranceAmount": "0.0",
            "manufacturingCompany": "",
            "brandName": "",
            "incoterms": "",
            "paymentType": "",
            "regime": "Import",
            "transportType": "Vessel, containerized",
            "notifyParty": "SPECIALTY CARGO TRANSPORT LLC",
            "notifyAddress": "2134 VALLEY SAND STREET _ LAS VEGAS NV 89135 UNITED STATES _",
            "portOfArrival": "5501, DALLAS-FORT WORTH, TX",
            "portOfDeparture": "57078, CN, YANTIAN",
            "itemNo": "0.0",
            "declarationNumber": "000001",
            "importerDataType": "",
            "exporterDataType": "",
            "dataType": "",
            "transportCompany": "MEDU",
            "vesselName": "MSC ROSA M",
            "productDetails": "KAMBIRA 2PK SOLAR LAMP POST AND PLANTER-BK MA, DISON SOLAR LAMP POST AND PLANTER-KD VERSION, PO# 240064 SHIPPER DECLARED THAT THIS SHIPMEN, T CONTAINS NO SOLID WOOD PACKING MATERIALS | J&J GLOBAL,LLC P.O. NUMBER: DIMENSIONS: NW: G, W: MADE IN CHINA CTN NO., SAME",
            "statisticalValueUsd": "0.0",
            "totalTeus": "2.0",
            "updatedAt": "1745934576.540106311",
            "createdAt": "1745934576.540106311",
            "addedGroup": "yeni_veri_P7_US_2024_FULL_00_06-2025-04-24.zip",
            "hashId": "1WBX10TiVGs+gdLTSpXNvQ==",
            "month": "6",
            "year": "2024"
        }
    ]
}

POST /api/v1/shipment/count

Belirli bir firmaya ait sevkiyat kayıtlarını sayar. firm alanı zorunludur.