{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Search Scraper",
    "description": "Search Instagram by keyword: reels with views, likes and comments; accounts with optional profile cards (followers, business email, phone); hashtags with post counts; places with addresses. Many keywords per run, follower filter, no duplicates. Reels from $0.38 per 1,000. No login.",
    "version": "1.0",
    "x-build-id": "zM5ZRJVbiE63OXtqF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/instagram-data-api~instagram-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-instagram-data-api-instagram-search-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-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-instagram-data-api-instagram-search-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-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-instagram-data-api-instagram-search-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": {
          "queries": {
            "title": "Keywords",
            "type": "array",
            "description": "One per line: a word, a phrase or a <code>#hashtag</code>.",
            "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."
          },
          "searchType": {
            "title": "Search for",
            "enum": [
              "reel",
              "user",
              "hashtag",
              "place"
            ],
            "type": "string",
            "description": "What to search for: reels, accounts, hashtags or places.",
            "default": "reel"
          },
          "maxResultsPerQuery": {
            "title": "Max results per keyword",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many results to return per keyword.",
            "default": 50
          },
          "newerThan": {
            "title": "Only reels 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. Reel search is ordered by relevance and holds few recent reels: a window of a few days usually returns nothing (a free row says how old the newest reel found is) — use weeks or months."
          },
          "olderThan": {
            "title": "Only reels 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 (reels)",
            "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."
          },
          "addProfileCards": {
            "title": "Add profile cards (accounts)",
            "type": "boolean",
            "description": "Followers, bio, category, business email and phone for each account found. Charged as “Account card” instead of “Found account”.",
            "default": false
          },
          "minFollowers": {
            "title": "Min followers (accounts)",
            "minimum": 0,
            "type": "integer",
            "description": "Turns profile cards on. Accounts outside the range cost much less."
          },
          "maxFollowers": {
            "title": "Max followers (accounts)",
            "minimum": 0,
            "type": "integer",
            "description": "Only accounts with at most this many followers."
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}