{ "openapi": "3.0.1", "info": { "title": "Nowlun Shipment Tracking – Container Status, Routes & Rates", "description": "Nowlun shipment tracking: track shipments by booking or BL number, search shipping options by route and date, and look up cargo rates and ports. One Actor for Nowlun container tracking, search and rates. Export to CSV, JSON, Excel or API.", "version": "1.0", "x-build-id": "3s89PVBnpkW5PAxdy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maged120~nowlun-track-shipment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maged120-nowlun-track-shipment", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/maged120~nowlun-track-shipment/runs": { "post": { "operationId": "runs-sync-maged120-nowlun-track-shipment", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/maged120~nowlun-track-shipment/run-sync": { "post": { "operationId": "run-sync-maged120-nowlun-track-shipment", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "track", "search", "rates" ], "type": "string", "description": "Leave empty to pick automatically: a booking number means track, a date or containers means search, otherwise rates." }, "booking_number": { "title": "Booking Number", "type": "string", "description": "The booking or BL number to track" }, "selector": { "title": "Selector", "enum": [ "booking", "bl" ], "type": "string", "description": "Must be 'booking' or 'bl'" }, "shipping_line": { "title": "Shipping Line", "type": "string", "description": "Optional shipping line name (auto-detected if not provided)" }, "origin_port": { "title": "Origin Port", "type": "string", "description": "The origin port (e.g., 'Sokhna-Port'). Use Nowlun Selectors actor to get valid ports. Optional if origin_area is provided." }, "origin_area": { "title": "Origin Area", "type": "string", "description": "The origin area (e.g., 'Cairo'). Use Nowlun Selectors actor to get valid areas. Optional if origin_port is provided." }, "destination_port": { "title": "Destination Port", "type": "string", "description": "The destination port (e.g., 'Jebel Ali'). Use Nowlun Selectors actor to get valid ports. Optional if destination_area is provided." }, "destination_area": { "title": "Destination Area", "type": "string", "description": "The destination area (e.g., 'Dubai'). Use Nowlun Selectors actor to get valid areas. Optional if destination_port is provided." }, "date": { "title": "Departure Date", "pattern": "^\\d{2}/\\d{2}/\\d{4}$", "type": "string", "description": "The departure date in DD/MM/YYYY format (e.g., '29/04/2025')." }, "containers": { "title": "Containers", "type": "string", "description": "JSON array of container types and quantities (e.g., '[\"40 Dry Standard:1\"]'). Use Nowlun Selectors actor to get valid container types." }, "query": { "title": "Search Query (rates)", "type": "string", "description": "Query to filter locations, containers, shipping lines, or bulk commodities (e.g., 'Busan' or 'Dry'). Case-insensitive. Optional." }, "email": { "title": "Nowlun Email", "type": "string", "description": "Your Nowlun account email" }, "password": { "title": "Nowlun Password", "type": "string", "description": "Your Nowlun account password" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }