{
"openapi": "3.0.1",
"info": {
"title": "Instagram Post to Article",
"description": "Transforms Instagram carousel posts into longform blog articles using multimodal LLMs. Extracts slide images, interprets visual and textual content, and synthesizes a coherent longform article.",
"version": "0.0",
"x-build-id": "wqDhOf813HDMrWIOq"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/hikayatlabs~instagram-post-to-article/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-hikayatlabs-instagram-post-to-article",
"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/hikayatlabs~instagram-post-to-article/runs": {
"post": {
"operationId": "runs-sync-hikayatlabs-instagram-post-to-article",
"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/hikayatlabs~instagram-post-to-article/run-sync": {
"post": {
"operationId": "run-sync-hikayatlabs-instagram-post-to-article",
"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": {
"postUrls": {
"title": "Instagram Post URLs",
"type": "array",
"description": "One or more Instagram post URLs to process. Each URL can optionally override the global style and output settings.",
"items": {
"type": "object",
"properties": {
"url": {
"title": "Post URL",
"type": "string",
"description": "Instagram post URL (e.g. https://www.instagram.com/p/ABC123/)."
}
},
"required": [
"url"
]
}
},
"sourceDataset": {
"title": "Source Dataset",
"type": "string",
"description": "Select an existing dataset to process instead of scraping URLs. The dataset items must be raw output from an Instagram scraper Actor."
},
"synthesisTemplate": {
"title": "Synthesis Template",
"enum": [
"article",
"article_short",
"article_long",
"newsletter",
"newsletter_short",
"social_thread",
"none"
],
"type": "string",
"description": "Choose a preset style for the output. The template sets the base instructions sent to the LLM. Per-URL overrides take precedence.",
"default": "article"
},
"synthesisGuide": {
"title": "Synthesis Guide",
"type": "string",
"description": "Optional instructions for the LLM on tone, focus, and style (e.g. 'Write in a neutral journalistic tone, focus on factual content, avoid promotional language'). These are appended to the template instructions."
},
"includeExtracted": {
"title": "Include Raw Extraction Output",
"type": "boolean",
"description": "If enabled, the output for each URL will include an extracted field containing the raw extraction output from the OCR and image processing stage.",
"default": false
},
"includeInterpretation": {
"title": "Include Semantic Interpretation",
"type": "boolean",
"description": "If enabled, the output for each URL will include an interpretation field containing the OCR results per image and the semantic blueprint used to generate the article.",
"default": false
},
"strictBudget": {
"title": "Strict Budget",
"type": "boolean",
"description": "When enabled, the actor will abort entirely if the budget is insufficient to process all items, instead of processing a subset. When disabled (default), items that don't fit within budget are silently dropped.",
"default": true
},
"strictImages": {
"title": "Strict Images",
"type": "boolean",
"description": "When enabled, the actor will abort entirely if any post has one or more images that failed to download. When disabled (default), posts with partial image failures are processed with the remaining images. Failed post URLs are written to the key-value store as IMAGE_FAILURES regardless of this setting.",
"default": false
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}