Integrate Trade Data Into Your Stack.

Trade data, programmatically.

The ShipScout API exposes the same data layer that powers our web platform. Build internal trade dashboards, enrich your own SaaS product with shipment context, fire alerts when a competitor lands a new buyer, or pipe customs records into your data warehouse. Source data is drawn from customs authorities, port records, public business registers (MCA, Companies House, SEC EDGAR), and LinkedIn public profiles, the same sources the UI uses.

Endpoints

Sample request

Find recent US imports of HS code 7308 (steel structures) from Indian suppliers, last 90 days, 25 results:

curl -X GET "https://api.shipscout.ai/v1/shipments/search" \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  --data-urlencode "hs_code=7308" \
  --data-urlencode "destination_country=US" \
  --data-urlencode "origin_country=IN" \
  --data-urlencode "date_from=2026-01-27" \
  --data-urlencode "date_to=2026-04-27" \
  --data-urlencode "limit=25"

Sample response

{
  "data": [
    {
      "shipment_id": "ssh_01HZK8N4P2X9Q7M3R5T8V2",
      "bill_of_lading": "MAEU240419-7732",
      "date": "2026-04-19",
      "hs_code": "73089090",
      "product_description": "Prefabricated steel building structures",
      "origin": {
        "country": "IN",
        "port": "INNSA",
        "supplier": {
          "id": "co_4f8a7e21",
          "name": "REDACTED STEEL EXPORTS PVT LTD",
          "city": "Mumbai"
        }
      },
      "destination": {
        "country": "US",
        "port": "USLAX",
        "buyer": {
          "id": "co_8b1c4d09",
          "name": "REDACTED INDUSTRIAL HOLDINGS LLC",
          "city": "Long Beach, CA"
        }
      },
      "value_usd": 184320,
      "weight_kg": 28140,
      "containers": [{ "type": "40HC", "count": 2 }]
    }
  ],
  "pagination": {
    "next_cursor": "eyJzaWQiOiJzc2hfMDFIWks4...",
    "has_more": true
  },
  "rate_limit": {
    "limit_per_min": 600,
    "remaining": 597,
    "reset_at": "2026-04-27T11:42:00Z"
  }
}

Authentication and rate limits

• OAuth2 client-credentials flow: POST /oauth/token with your client ID + secret, receive a 1-hour access token.
• Rate limit Business tier: 600 requests/minute, 100,000 requests/day. Enterprise tier is custom.
• Response headers include X-RateLimit-Remaining and X-RateLimit-Reset on every call.
• Idempotency keys supported on webhook-subscription endpoints.
• IP allowlisting available on Enterprise.

How it works (3 steps)

1. Subscribe to Business tier. API access is included from the Business plan up. Starter and Pro plans use the web UI only.
2. Generate credentials. Inside your dashboard under Settings → API, create a client. Copy the client ID + secret. Optional: lock to specific IPs.
3. Hit the endpoints. POST to /oauth/token, get a Bearer token, call any v1 endpoint. Sample SDKs in Python and Node.js are coming; any HTTP client works in the meantime.

Use cases

• SaaS enrichment. A logistics-SaaS startup pipes /v1/companies/{id} calls into their onboarding flow to pre-populate a customer's trade history when they sign up.
• Internal dashboards. A multinational sources team queries /v1/countries/aggregates nightly to track origin-country diversification across 14 commodity baskets.
• Automated alerts. A trader sets a webhook on a competitor's company_id, and gets a Slack ping within 30 minutes of any new shipment leaving the competitor's loading port.
• Data-warehouse sync. A consultancy syncs the shipments/search endpoint into Snowflake for client reports.

API access starts at the Business tier. Starter pricing from ₹9,917/month; API access tier upwards. See pricing or request API keys. Detailed reference docs at /features/crm-ai and the developer portal (link in your dashboard once provisioned).