Data Sources

Data-sources within the Panjiva API dictate the overall set of shipment data that is within scope when performing a search. Data-sources are available for both the entire set of Panjiva data, and for individual countries and trade directions (import, or export).

Global Data-Source

The global data-source contains all countries and trade directions within the Panjiva platform, which allows for the widest possible search results. Since all individual data-sources are combined, only commonly shared shipment fields are available as selection criteria within the global data source.

tip

The underlying data-sources within the global data-source may still be selected by using the data_source filter.

info

Due to the size of the global data-source, it only contains the last 5 years of shipment results. When searching for older shipment records, it is necessary to use the individual data-sources, if available.

Individual Data-Sources

Some of the underlying data-sources are available directly through the Panjiva API, such as us-imports and us-exports. When using these data-sources directly, shipment attributes that are unique to those shipping records are exposed as selection criteria. Additionally, shipment data for the individual data-sources do not have any date restrictions and are available since Panjiva began collecting data.

Item level Data-Sources

Some data-sources provide records that pertain to each item in a shipment. These may be retrieved individually by appending the -items to the data-source, such as mex-import-items. When using the shipment level data-source (mex-imports), each item record is aggregated to single shipment with all items listed within.

warning

The parameter for individual data-sources use an ISO Country Code prefix which may result in similar keys for different countries. For example, India (IND) and Indonesia (IDN) are specified to the API as ind-imports and idn-imports respectively.

Which Data-Source should be used?

The global data-source is the preferred option when making shipment requests against the API as it has the most comprehensive coverage of the Panjiva dataset. However if shipment records older than 5 years are needed, or if searching against a shipment attribute that is unique to an individual data-source, than using the individual data-sources may be a better approach.

Available Data-Sources

string

Enum: "global" "us-imports" "us-exports" "bol-import-items" "bol-export-items" "bol-imports" "bol-exports" "bra-imports" "bra-exports" "chn-imports" "chn-exports" "chl-imports" "chl-exports" "chl-import-items" "col-imports" "col-exports" "cri-imports" "cri-exports" "cri-import-items" "cri-export-items" "ecu-imports" "ecu-exports" "idn-imports" "idn-exports" "ind-imports" "ind-exports" "ind-import-items" "ind-export-items" "lka-imports" "lka-exports" "mex-imports" "mex-exports" "mex-import-items" "mex-export-items" "pak-imports" "pak-exports" "pan-imports" "pan-exports" "per-imports" "per-exports" "phl-imports" "phl-exports" "pry-imports" "pry-exports" "tur-imports" "tur-exports" "tur-import-items" "tur-export-items" "ury-imports" "ury-exports" "ven-imports" "ven-exports" "vnm-imports" "vnm-exports" "russia" "ukraine" "uzbekistan" "kazakhstan" "vietnam-china" "philippines" "ethiopia"

note

Not all data-sources are available to every customer. Please use the data-sources endpoint to determine the available data-sources for your organization, and reach out to your Panjiva Representative if additional data-sources are required.