Get a US importer's suppliers and shipments
Get a US importer's sea shipments by company name: its suppliers, products by HS code, monthly volumes, ports, carriers and latest bills of lading.
Headers
Get your API keyAPI key (`sfk_...`)
The importer: a brand, e.g. `Nike`, a name as it appears on shipping documents, e.g. `Nike Usa`, or the `company.id` of an earlier answer, e.g. `nike-usa`. Endings such as Inc, LLC and USA are ignored when matching.
min 2 chars · max 200 chars
Endpoint-specific response payload.
`not_found` when no US importer's filed name matches.
one of: found, not_found
How the importer was chosen: its id, an exact name, a name starting with yours, or the largest importer among the matches.
one of: id_match, name_match, partial_match, largest_match, null
Importers whose filed names matched, largest first.
The importer's id; send it as `company`.
min 1 chars
Name as filed on the manifests.
min 1 chars
ISO 3166-1 alpha-2 country of the address.
Sea shipments on record.
Latest shipment, `YYYY-MM-DD`.
True for the importer this answer is about.
The importer.
The importer's id, e.g. `nike-usa`.
min 1 chars
Name as filed, e.g. `Nike Usa`.
min 1 chars
State or region, e.g. `Oregon`.
ISO 3166-1 alpha-2 country of the address, e.g. `US`.
Other names the importer files under.
Other addresses it files from.
Sea shipments on record.
Sea shipments in the last 12 months.
First shipment on record, `YYYY-MM-DD`.
Latest shipment, `YYYY-MM-DD`.
When the records were last updated, `YYYY-MM-DD`.
Estimated freight spend over all shipments, US dollars.
Share of shipments the freight estimate covers, percent.
Average twenty-foot container units per shipment, last 12 months.
Average twenty-foot container units a month, last 12 months.
Shipments as full container loads.
Shipments as less-than-container loads.
Month, `YYYY-MM`.
min 7 chars
≥ 0
Total weight in kilograms.
Twenty-foot container units.
Its largest suppliers, most shipments first.
The supplier's id.
Supplier name; null where the manifest names none.
ISO 3166-1 alpha-2 country of the supplier's address.
ISO 3166-1 alpha-2 country the goods shipped from.
Shipments from this supplier to the importer.
Of those, in the last 12 months.
Total weight shipped, kilograms.
Twenty-foot container units shipped.
Leading HS codes of what it ships, e.g. `6404.11`.
What it ships to the importer, by HS chapter.
2-digit HS chapter; null for the rest.
≥ 0
Share of its shipments.
Words from its shipments' descriptions, as recorded.
The supplier's largest US customers.
True when it has more suppliers than the 50 listed.
What it imports, by HS chapter, most shipments first.
HS code: chapter, heading or subheading.
min 1 chars
≥ 0
4-digit headings in the chapter, each with its subheadings.
HS code: chapter, heading or subheading.
min 1 chars
≥ 0
HS code: chapter, heading or subheading.
min 1 chars
≥ 0
Shipments by the country the goods came from.
Origin country name.
min 1 chars
≥ 0
Port pairs its goods travel between, most shipments first.
≥ 0
Ocean carriers it ships with.
Carrier SCAC code.
≥ 0
Latest shipments, newest first.
Arrival date, `YYYY-MM-DD`.
Bill of lading number.
Kind of bill.
one of: house, master, regular, null
Shipper; null when not named.
ISO 3166-1 alpha-2 country the goods came from.
Goods as described.
Unit of `quantity`, e.g. `CTN`.
Ocean route, e.g. `Asia, Transpacific`.
Cost, insurance and freight value declared on the manifest, when declared.
All its shipments on record; `recentShipments` lists only the latest 50.
Recent shipments with a declared value, newest first.
Arrival date, `YYYY-MM-DD`.
Bill of lading number.
Kind of bill.
one of: house, master, regular, null
Shipper; null when not named.
ISO 3166-1 alpha-2 country the goods came from.
Goods as described.
Unit of `quantity`, e.g. `CTN`.
Ocean route, e.g. `Asia, Transpacific`.
Cost, insurance and freight value declared on the manifest, when declared.
Where the data comes from and how to credit it when you reuse it.
Who publishes the data, e.g. `Eurostat`.
min 1 chars
The publisher's dataset code, when it has one.
The dataset's title.
When the publisher last updated the data, ISO 8601.
Where the data can be viewed.
The terms the data is published under.
min 1 chars
Credit line the licence asks for when you reuse or publish the data.
min 1 chars
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/economy/imports?company=Nike" \
-H "x-api-key: YOUR_API_KEY"Responses
The importer's record, or not_found.
Government contracts
Search US federal contract awards by recipient, keyword, NAICS, PSC and state: amount, agency, dates, codes and places, up to 100 a page with a cursor.
Listing
Get an Etsy listing by id or URL, with its price and sale price, pictures, category, materials, shop, rating, newest reviews and shipping origin.