{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Scraper - Posts, Reels, Profiles & Followers",
    "description": "Scrape public Instagram in 14 modes: profile posts, Reels and tagged posts, profiles with bio and business contacts, comments and replies, followers, following, post likers, hashtag, location and audio feeds, search, stories and highlights. Flat JSON, no login or cookies needed.",
    "version": "0.1",
    "x-build-id": "KtUHZYNX1TIoa43oT"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clover_folktale~instagram-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clover_folktale-instagram-scraper",
        "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/clover_folktale~instagram-scraper/runs": {
      "post": {
        "operationId": "runs-sync-clover_folktale-instagram-scraper",
        "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/clover_folktale~instagram-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-clover_folktale-instagram-scraper",
        "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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "userPosts",
              "profiles",
              "userReels",
              "comments",
              "hashtagPosts",
              "postDetails",
              "search",
              "followers",
              "taggedPosts",
              "locationPosts",
              "stories",
              "similarAccounts",
              "postLikers",
              "audioPosts",
              "explore",
              "userReposts",
              "locationInfo"
            ],
            "type": "string",
            "description": "What to scrape. Each mode reads the list field named in its title below.",
            "default": "userPosts"
          },
          "usernames": {
            "title": "Usernames (modes: userPosts, profiles, userReels, userReposts, followers, taggedPosts, stories, similarAccounts)",
            "type": "array",
            "description": "Profiles as nasa, @nasa or a link (https://www.instagram.com/nasa/). Falls back to \"nasa\" when empty.",
            "items": {
              "type": "string"
            }
          },
          "postUrls": {
            "title": "Posts (modes: comments, postDetails, postLikers)",
            "type": "array",
            "description": "Post or Reel links (https://www.instagram.com/p/DeTUk4sDSp-/) or shortcodes. Falls back to a sample post when empty.",
            "items": {
              "type": "string"
            }
          },
          "hashtags": {
            "title": "Hashtags (mode: hashtagPosts)",
            "type": "array",
            "description": "Hashtags as nasa, #nasa or a link (https://www.instagram.com/explore/tags/nasa/). Falls back to \"nasa\" when empty.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords (mode: search)",
            "type": "array",
            "description": "Search keywords; each keyword is a separate search. With search type nearby, each entry is a coordinate pair such as 29.7604,-95.3698 (latitude,longitude). Falls back to \"travel\" (a sample point for nearby) when empty.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations (modes: locationPosts, locationInfo)",
            "type": "array",
            "description": "Location IDs (115963528414384) or links such as https://www.instagram.com/explore/locations/115963528414384/houston-texas/. Find IDs with search type locations or nearby. Falls back to a sample location when empty.",
            "items": {
              "type": "string"
            }
          },
          "audios": {
            "title": "Audios (mode: audioPosts)",
            "type": "array",
            "description": "Audio page IDs (18294184831034406) or links such as https://www.instagram.com/reels/audio/18294184831034406/. Falls back to a sample audio when empty.",
            "items": {
              "type": "string"
            }
          },
          "sections": {
            "title": "Explore categories (mode: explore)",
            "type": "array",
            "description": "Explore category names such as Photography or Video Games, or numeric category IDs such as 917256014984692. Names are matched without regard to case against Instagram's current category list, which changes over time. Each category returns about 10 to 13 posts. Falls back to a sample category when empty.",
            "items": {
              "type": "string"
            }
          },
          "followType": {
            "title": "List (mode: followers)",
            "enum": [
              "followers",
              "following"
            ],
            "type": "string",
            "description": "Whether to list the accounts that follow the profile or the accounts it follows.",
            "default": "followers"
          },
          "searchType": {
            "title": "Search for (mode: search)",
            "enum": [
              "users",
              "posts",
              "reels",
              "hashtags",
              "locations",
              "audio",
              "nearby"
            ],
            "type": "string",
            "description": "What the keyword searches: accounts, posts, Reels, hashtags, locations, audios, or places near a latitude,longitude pair (nearby).",
            "default": "users"
          },
          "storyType": {
            "title": "Stories (mode: stories)",
            "enum": [
              "stories",
              "highlights",
              "highlightStories"
            ],
            "type": "string",
            "description": "Current stories, the list of highlight reels, or the stories inside each highlight reel (reels with a single story are skipped).",
            "default": "stories"
          },
          "hashtagFeed": {
            "title": "Feed (mode: hashtagPosts)",
            "enum": [
              "top",
              "recent",
              "reels"
            ],
            "type": "string",
            "description": "Top posts, latest posts or Reels only.",
            "default": "top"
          },
          "commentSort": {
            "title": "Sort (mode: comments)",
            "enum": [
              "recent",
              "popular"
            ],
            "type": "string",
            "description": "Newest or most popular comments first.",
            "default": "recent"
          },
          "includeReplies": {
            "title": "Include replies (mode: comments)",
            "type": "boolean",
            "description": "Also fetch the replies of comments that have two or more. Replies count toward maxResults.",
            "default": false
          },
          "maxResults": {
            "title": "Max results per input",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum items for each username, post, hashtag, location, audio, explore category or keyword (up to 5000). Ignored by modes profiles, postDetails and locationInfo, which return one record per input. You are charged $0.0023 per item ($0.0032 per post in postDetails, $0.0007 per account in followers, postLikers and similarAccounts), plus three $0.00005 start fees per run and one more for each further input (not in profiles, postDetails and locationInfo).",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}