{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Hashtag Scraper",
    "description": "Scrape reels from any Instagram hashtag with views, likes and comments — from $0.38 per 1,000. The reels Instagram shows for the hashtag, plus its total post count. Minimum-views and date filters, no duplicates. No login.",
    "version": "1.0",
    "x-build-id": "U7xoFXa7hJqjqaQJk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/instagram-data-api~instagram-hashtag-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-instagram-data-api-instagram-hashtag-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/instagram-data-api~instagram-hashtag-scraper/runs": {
      "post": {
        "operationId": "runs-sync-instagram-data-api-instagram-hashtag-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/instagram-data-api~instagram-hashtag-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-instagram-data-api-instagram-hashtag-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",
        "properties": {
          "hashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "One per line, with or without <code>#</code>, in any language, or a hashtag link.",
            "items": {
              "type": "string"
            }
          },
          "inputFile": {
            "title": "Or upload a list (CSV or TXT)",
            "type": "string",
            "description": "A CSV or TXT file: one username or link per line, or a table — we take the column named <code>username</code>, <code>url</code> or <code>link</code> (otherwise every cell). Added to the list above; duplicates are skipped."
          },
          "feed": {
            "title": "Feed",
            "enum": [
              "top",
              "recent",
              "reels"
            ],
            "type": "string",
            "description": "Instagram no longer shows a hashtag's top page or its recent posts. Top and Reels return the reels Instagram's public search gives for the hashtag's word (hashtagInCaption says which carry the hashtag); Top adds the hashtag's post count. Recent returns a free row saying Instagram doesn't list them.",
            "default": "top"
          },
          "maxPostsPerHashtag": {
            "title": "Max posts per hashtag",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many posts to return per hashtag.",
            "default": 50
          },
          "mediaType": {
            "title": "Content type",
            "enum": [
              "all",
              "reels",
              "photos"
            ],
            "type": "string",
            "description": "Everything, only reels, or only photos and carousels.",
            "default": "all"
          },
          "newerThan": {
            "title": "Only items newer than",
            "type": "string",
            "description": "A date (<code>2026-10-01</code>) or a period (<code>7 days</code>, <code>2 weeks</code>). Empty — no date limit. Older pinned items are left out too."
          },
          "olderThan": {
            "title": "Only items older than",
            "type": "string",
            "description": "A date (<code>2026-09-01</code>) or a period (<code>30 days</code>). With “Only items newer than” — a date range. Newer items are skipped and aren't charged."
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "Only reels with at least this many views are returned. Reels below it are not returned and cost 4× less (we still checked them); photos have no views and are skipped for free."
          },
          "officialFieldNames": {
            "title": "Also add Apify-style field names",
            "type": "boolean",
            "description": "Every row also gets <code>likesCount</code>, <code>commentsCount</code>, <code>videoPlayCount</code>, <code>timestamp</code>, <code>displayUrl</code>, <code>followersCount</code>, <code>followsCount</code>, <code>verified</code>… with the same values, and the post type as Video, Image or Sidecar. Sheets, code and n8n flows made for the official scrapers keep working. Our own fields stay. No extra charge.",
            "default": false
          },
          "addSummaryRow": {
            "title": "Add a summary row at the end",
            "type": "boolean",
            "description": "One free row at the end of the results: rows returned, what was charged (events and USD) and why the run stopped — for n8n, Make, Zapier and AI agents that read only the dataset. The same summary is always saved as SUMMARY in the run's key-value store.",
            "default": false
          },
          "includeRaw": {
            "title": "Add the full Instagram data (raw)",
            "type": "boolean",
            "description": "Every row also gets <code>raw</code>: the whole object Instagram returned for it — every field it sends, untouched, for your own parsing or an AI agent. Heavy (about 30 KB a post), so it is added to the first 1,000 rows of a run. No extra charge.",
            "default": false
          },
          "returnWithinSecs": {
            "title": "Return what's ready after (seconds)",
            "minimum": 10,
            "maximum": 3600,
            "type": "integer",
            "description": "Stop after this many seconds and return the results collected so far — you pay only for them. Handy for AI agents with a short tool timeout. Empty — run until everything is collected."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}