{ "openapi": "3.0.1", "info": { "title": "HEIC to JPG Converter: Convert HEIC/HEIF to JPG & PNG", "description": "Convert HEIC and HEIF photos from URLs to JPG, PNG or WebP in bulk. Fixes rotation, converts iPhone HDR and Display P3 to sRGB, strips GPS by default, optional resize. Pay per image, signed download links.", "version": "0.1", "x-build-id": "wsKFrrivLkdxJ9yDd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data-done-right~heic-to-jpg-converter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data-done-right-heic-to-jpg-converter", "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/data-done-right~heic-to-jpg-converter/runs": { "post": { "operationId": "runs-sync-data-done-right-heic-to-jpg-converter", "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/data-done-right~heic-to-jpg-converter/run-sync": { "post": { "operationId": "run-sync-data-done-right-heic-to-jpg-converter", "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": { "urls": { "title": "HEIC / HEIF image URLs", "type": "array", "description": "Direct links to the HEIC or HEIF photos to convert, one per line. Example: https://example.com/photos/IMG_0001.HEIC. Dropbox and Google Drive share links are turned into direct downloads. Only URLs you have the right to download; links to private networks are blocked.", "items": { "type": "string" } }, "datasetId": { "title": "Or a dataset with image URLs", "type": "string", "description": "Optional. Pick an Apify dataset (for example the output of a scraper) whose items contain HEIC image URLs. They are added to the URLs above. Example: the dataset of a previous run." }, "datasetField": { "title": "Dataset field with the URL", "type": "string", "description": "Name of the dataset field that holds the image URL. A dotted path such as media.imageUrl works, and a field holding a list of URLs is fine. Example: url.", "default": "url" }, "outputFormat": { "title": "Output format", "enum": [ "jpg", "png", "webp" ], "type": "string", "description": "The format to convert to. JPG is the default. Example: jpg.", "default": "jpg" }, "quality": { "title": "Quality (1-100)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Quality for JPG and WebP (ignored for PNG). 90 is visually lossless for most photos; 75 gives much smaller files. Example: 85.", "default": 90 }, "maxWidth": { "title": "Max width (px)", "minimum": 0, "maximum": 30000, "type": "integer", "description": "Shrink images wider than this, keeping the aspect ratio. Never enlarges. 0 = keep the original size. Example: 1920.", "default": 0 }, "maxHeight": { "title": "Max height (px)", "minimum": 0, "maximum": 30000, "type": "integer", "description": "Shrink images taller than this, keeping the aspect ratio. Never enlarges. 0 = keep the original size. Example: 1080.", "default": 0 }, "backgroundColor": { "title": "Background for transparent images", "type": "string", "description": "JPG has no transparency. Transparent areas are filled with this colour when the output is JPG. Example: #ffffff.", "default": "#ffffff" }, "keepMetadata": { "title": "Keep EXIF metadata", "type": "boolean", "description": "Off (default): all metadata is removed, including GPS location, camera and date, which protects privacy. On: EXIF is copied to the output, including GPS if the photo has it. Rotation is always applied to the pixels either way.", "default": false }, "allImages": { "title": "Convert every image in the file", "type": "boolean", "description": "Off (default): only the primary image of the HEIC file is converted. On: burst or multi-image HEIC files produce one output per image (up to 50 per file), named name-1, name-2 and so on. Each output counts as one converted image.", "default": false }, "maxFiles": { "title": "Max URLs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Most URLs processed in this run. URLs beyond this are not fetched and not charged. Example: 100.", "default": 100 }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 0.1, "maximum": 100, "type": "number", "description": "Files larger than this are skipped, checked from the headers and again while downloading. 1 MB = 1,000,000 bytes. Example: 50.", "default": 50 }, "concurrency": { "title": "Parallel downloads", "minimum": 1, "maximum": 16, "type": "integer", "description": "How many images are fetched and converted at the same time. Example: 4.", "default": 4 }, "timeoutSecs": { "title": "Download timeout (seconds)", "minimum": 5, "maximum": 600, "type": "integer", "description": "Give up on one download after this many seconds. Example: 60.", "default": 60 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Only needed when the image host blocks data-centre IPs. Leave empty for a direct connection." } } }, "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 } } } } } } } } } }