{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Location Scraper",
    "description": "Scrape posts and reels by geotag at any Instagram location — a venue, a city spot or a stadium — with views, likes, comments, caption and author, plus the free place card: category, address, phone, website, hours and post count. Top or most recent, date filter. From $0.46 per 1,000. No login.",
    "version": "1.0",
    "x-build-id": "evR7IqHVIj8ARXTgF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/instagram-data-api~instagram-location-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-instagram-data-api-instagram-location-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-location-scraper/runs": {
      "post": {
        "operationId": "runs-sync-instagram-data-api-instagram-location-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-location-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-instagram-data-api-instagram-location-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": {
          "places": {
            "title": "Place links or IDs",
            "type": "array",
            "description": "One per line: <code>https://www.instagram.com/explore/locations/250883946/times-square/</code> or just the ID. Find places by name with our Instagram Search Scraper (Search for: Places).",
            "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"
            ],
            "type": "string",
            "description": "Top — Instagram's popular posts at the place. Most recent — newest first, so the date filter stops exactly at your date.",
            "default": "top"
          },
          "maxPostsPerPlace": {
            "title": "Max posts per place",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many posts to return per place.",
            "default": 50
          },
          "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."
          },
          "datasetId": {
            "title": "Or: dataset from another run",
            "type": "string",
            "description": "Pick the dataset of an earlier run (or paste its ID). We take place links from <code>placeUrl</code> / <code>url</code> — for example, places found by our Instagram Search Scraper."
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}