{ "openapi": "3.0.1", "info": { "title": "Instagram Trending Audio", "description": "Ranks Reel audio by how many sampled public profiles are using it. Instagram's in-app trending flag is not available logged out. Price is unset until publish.", "version": "0.1", "x-build-id": "vYXntS6FWNpKY5VxC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/adaptable_wheelhouse~instagram-trending-audio/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-adaptable_wheelhouse-instagram-trending-audio", "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/adaptable_wheelhouse~instagram-trending-audio/runs": { "post": { "operationId": "runs-sync-adaptable_wheelhouse-instagram-trending-audio", "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/adaptable_wheelhouse~instagram-trending-audio/run-sync": { "post": { "operationId": "run-sync-adaptable_wheelhouse-instagram-trending-audio", "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": { "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (US, GB, IN, CA, AU, DE, BR, NG...). Instagram marks different sounds as trending in each country, so each country is read from an IP there: US through Apify datacenter IPs, other countries through Apify residential IPs in the country.", "default": [ "US" ], "items": { "type": "string" } }, "maxSounds": { "title": "Maximum sounds per country", "minimum": 1, "maximum": 500, "type": "integer", "description": "The top N sounds per country, used by the most creators first.", "default": 50 }, "soundType": { "title": "Sound type", "enum": [ "all", "songs", "original" ], "type": "string", "description": "Songs are released tracks from Instagram's music library; original audio is recorded by creators (voiceovers, memes, remixes).", "default": "all" }, "trendingOnly": { "title": "Only sounds Instagram marks as trending", "type": "boolean", "description": "Keep only sounds with Instagram's trending arrow in that country. Turn off to also get popular sounds of the sample that are not flagged (isTrending column).", "default": true }, "minCreators": { "title": "Minimum creators using the sound", "minimum": 1, "maximum": 100, "type": "integer", "description": "Only sounds used by at least this many different creators of the sample. Empty or 1 = every sound." }, "topReels": { "title": "Top Reels per sound", "minimum": 0, "maximum": 10, "type": "integer", "description": "The most played Reels that use each sound (link, plays, likes, creator). 0 = none.", "default": 3 }, "sampleCreators": { "title": "Creators to sample", "minimum": 30, "maximum": 600, "type": "integer", "description": "How many creators' latest Reels are read to rank the sounds. More creators = more sounds and a steadier ranking. Today's shared list is reused when it was built from at least 80% of this number.", "default": 150 }, "forceFresh": { "title": "Build a fresh list", "type": "boolean", "description": "Ignore today's saved list for the country and sample again.", "default": false }, "onlyNew": { "title": "Only new sounds", "type": "boolean", "description": "For scheduled runs. The first run returns the list and remembers it; later runs return only sounds that were not returned before under the same monitor name.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name of the memory used by isNew, previousPosition and Only new sounds. Use a different name for each scheduled task.", "default": "default" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 16, "type": "integer", "description": "How many Instagram requests run at the same time.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "US requests go through Apify datacenter proxies, other countries through Apify residential IPs in the country. Without residential access, other countries are read from the Apify server and get that location's trending flags.", "default": { "useApifyProxy": true } }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Log every refused request (for troubleshooting).", "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 }, "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 } } } } } } } } } }