{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Location Posts Scraper",
    "description": "Get public Instagram posts geotagged at any place, or its local creators, by place name, location ID or URL: caption, owner, likes, date, media. $0.0025 per post ($0.0018 on top plans), running cost extra. No login. Empty rows never charged.",
    "version": "0.1",
    "x-build-id": "5D0sjh7Z3QT1PTbDT"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~instagram-location-posts-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-instagram-location-posts-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/khadinakbar~instagram-location-posts-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-instagram-location-posts-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/khadinakbar~instagram-location-posts-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-instagram-location-posts-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": {
          "locationUrls": {
            "title": "📍 Instagram location URLs",
            "maxItems": 50,
            "type": "array",
            "description": "Instagram place page URLs, one per line. Example: https://www.instagram.com/explore/locations/212988663/times-square-new-york-city/",
            "items": {
              "type": "string"
            }
          },
          "locationIds": {
            "title": "🧭 Instagram location IDs",
            "maxItems": 50,
            "type": "array",
            "description": "Numeric Instagram location IDs (the geotag ID), for example 213819997 (Vancouver). The number in a location URL is its ID.",
            "items": {
              "type": "string"
            }
          },
          "locationQueries": {
            "title": "🔎 Place names",
            "maxItems": 50,
            "type": "array",
            "description": "Place names to look up, for example \"Eiffel Tower\" or \"Blue Bottle Coffee Tokyo\". Each name is matched to Instagram places first. A more specific name gives a better match.",
            "items": {
              "type": "string"
            }
          },
          "placesPerQuery": {
            "title": "Places per name",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "How many matching Instagram places to read for each place name (1 to 5). Big landmarks often have several places with the same name.",
            "default": 1
          },
          "outputMode": {
            "title": "👥 What to return",
            "enum": [
              "posts",
              "creators"
            ],
            "type": "string",
            "description": "\"Posts\" = one row per post. \"Local creators\" = one row per account that posts at the place, most active first, with posts, likes, best post and hashtags. Creator rows are built from the posts read at the place and are charged at the same price per row.",
            "default": "posts"
          },
          "creatorsPerPlace": {
            "title": "Creators per place",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Local creators mode only: how many accounts to return for each place (1 to 100). The Actor reads about 6 posts per creator wanted (60 to 300) to find them; you pay only for creator rows saved.",
            "default": 20
          },
          "feed": {
            "title": "🗂️ Which posts",
            "enum": [
              "recent",
              "top"
            ],
            "type": "string",
            "description": "\"recent\" = newest posts first. \"top\" = Instagram's top posts for the place. For a city, top posts can include venues inside that city; every row says its exact place.",
            "default": "recent"
          },
          "maxPostsPerTarget": {
            "title": "💯 Max posts per place",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Posts mode: maximum posts to save for each place (1 to 500). You pay only for posts saved. Ignored in Local creators mode.",
            "default": 50
          },
          "onlyPostsNewerThan": {
            "title": "📅 Only posts newer than",
            "type": "string",
            "description": "Skip posts older than this. A date like 2026-01-31, or a period like \"7 days\", \"2 weeks\", \"3 months\"."
          },
          "onlyPostsOlderThan": {
            "title": "📅 Only posts older than",
            "type": "string",
            "description": "Skip posts newer than this. Same format as above. Use both dates for a date window."
          },
          "postTypes": {
            "title": "🎞️ Post types",
            "type": "array",
            "description": "Keep only these post types. Leave empty for all types.",
            "items": {
              "type": "string",
              "enum": [
                "image",
                "video",
                "reel",
                "carousel"
              ],
              "enumTitles": [
                "Photo",
                "Video",
                "Reel",
                "Carousel (several photos or videos)"
              ]
            }
          },
          "minLikes": {
            "title": "❤️ Minimum likes",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Keep only posts with at least this many likes. 0 = no limit. Posts that hide their like count are skipped when this is above 0.",
            "default": 0
          },
          "minComments": {
            "title": "💬 Minimum comments",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Keep only posts with at least this many comments. 0 = no limit.",
            "default": 0
          },
          "verifiedOwnersOnly": {
            "title": "✅ Verified accounts only",
            "type": "boolean",
            "description": "Keep only posts by accounts with a verified badge.",
            "default": false
          },
          "includePlaceDetails": {
            "title": "🏷️ Add place details",
            "type": "boolean",
            "description": "Add the place's category, map position, address, phone and total post count to every row. No extra charge.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}