{
  "openapi": "3.0.1",
  "info": {
    "title": "instagram profile scraper pro",
    "description": "Extract clean public Instagram profile data from usernames, profile URLs, or profile IDs. Get followers, bio, links, public contact clues, business signals, and profile status in a ready-to-download dataset.",
    "version": "1.0",
    "x-build-id": "7yt67jAaTsUIy8xnv"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/qaseemiqbal~instagram-profile-scraper-pro/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-qaseemiqbal-instagram-profile-scraper-pro",
        "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/qaseemiqbal~instagram-profile-scraper-pro/runs": {
      "post": {
        "operationId": "runs-sync-qaseemiqbal-instagram-profile-scraper-pro",
        "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/qaseemiqbal~instagram-profile-scraper-pro/run-sync": {
      "post": {
        "operationId": "run-sync-qaseemiqbal-instagram-profile-scraper-pro",
        "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": {
          "profileInputs": {
            "title": "Instagram profiles",
            "type": "array",
            "description": "Usernames, profile URLs, or numeric profile IDs. Examples: `nasa`, `@nasa`, `https://www.instagram.com/nasa/`, `528817151`.",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 300
            },
            "default": [
              "nasa"
            ]
          },
          "inputDatasetId": {
            "title": "Input dataset ID",
            "type": "string",
            "description": "Optional Apify dataset ID to read profile targets from. Leave empty when entering profiles above.",
            "default": ""
          },
          "inputDatasetField": {
            "title": "Input dataset field",
            "type": "string",
            "description": "Field name in the input dataset that contains a username, URL, or profile ID.",
            "default": "username"
          },
          "maxProfiles": {
            "title": "Maximum profiles",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of unique normalized profiles to process.",
            "default": 1000
          },
          "includeAbout": {
            "title": "Include About profile metadata",
            "type": "boolean",
            "description": "Fetch account-history metadata such as joined date, country, verification date, and former username count when publicly available. This can increase runtime and cost.",
            "default": false
          },
          "includeLatestPosts": {
            "title": "Include latest posts",
            "type": "boolean",
            "description": "Include recent public post/reel/carousel preview metadata. Disabled by default to keep runs as cheap as possible.",
            "default": false
          },
          "maxLatestPostsPerProfile": {
            "title": "Maximum latest posts per profile",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Maximum number of latest public posts/reels/carousels to include per profile.",
            "default": 0
          },
          "includeLatestIgtvVideos": {
            "title": "Include latest IGTV/videos",
            "type": "boolean",
            "description": "Include latest public IGTV/video preview metadata where available.",
            "default": false
          },
          "maxLatestIgtvVideosPerProfile": {
            "title": "Maximum IGTV/videos per profile",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Maximum number of latest public IGTV/video previews to include per profile. Keep at 0 for the lowest cost.",
            "default": 0
          },
          "includeRelatedProfiles": {
            "title": "Include related profiles",
            "type": "boolean",
            "description": "Include related or suggested public profiles where available. Disabled by default to reduce output size and runtime.",
            "default": false
          },
          "maxRelatedProfiles": {
            "title": "Maximum related profiles",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum number of related or suggested profiles to include per profile. Keep at 0 for the lowest cost.",
            "default": 0
          },
          "includeExternalUrls": {
            "title": "Include external URLs",
            "type": "boolean",
            "description": "Extract public external websites and bio links.",
            "default": true
          },
          "resolveExternalUrls": {
            "title": "Resolve external URLs",
            "type": "boolean",
            "description": "Follow Instagram-shimmed links to their final destination URL. This adds network requests and may increase runtime.",
            "default": false
          },
          "externalUrlTimeoutSecs": {
            "title": "External URL timeout",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Maximum time to spend resolving each external URL.",
            "default": 8
          },
          "includeContactInfo": {
            "title": "Extract public contact info",
            "type": "boolean",
            "description": "Extract emails, phone numbers, mailto links, WhatsApp links, and business contact fields only when publicly listed.",
            "default": true
          },
          "outputMode": {
            "title": "Output mode",
            "enum": [
              "compact",
              "full",
              "split"
            ],
            "type": "string",
            "description": "Choose compact spreadsheet-friendly rows, full nested records, or split datasets for profiles/posts/related profiles. Compact is the cheapest default.",
            "default": "compact"
          },
          "pushErrorRecords": {
            "title": "Push error records",
            "type": "boolean",
            "description": "Add a dataset item for profiles that are not found, private, blocked, or failed after retries.",
            "default": true
          },
          "enableChangeDetection": {
            "title": "Enable change detection",
            "type": "boolean",
            "description": "Compare current records to a previous dataset.",
            "default": false
          },
          "baselineDatasetId": {
            "title": "Baseline dataset ID",
            "type": "string",
            "description": "Previous dataset ID used for change detection.",
            "default": ""
          },
          "crawlerMode": {
            "title": "Crawler mode",
            "enum": [
              "auto",
              "httpOnly",
              "browserOnly"
            ],
            "type": "string",
            "description": "HTTP only is the cheapest default. Auto can improve success by using browser fallback, but it may cost more.",
            "default": "httpOnly"
          },
          "maxConcurrency": {
            "title": "Maximum concurrency",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Maximum number of profiles processed at the same time. Higher values can finish sooner but may increase blocking risk.",
            "default": 10
          },
          "maxRequestRetries": {
            "title": "Maximum request retries",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Maximum retry attempts per profile. The default 0 avoids extra requests and keeps runs cheap.",
            "default": 0
          },
          "maxRequestsPerMinute": {
            "title": "Maximum requests per minute",
            "minimum": 1,
            "maximum": 6000,
            "type": "integer",
            "description": "Soft request-rate limit for profile fetching. Lower this if you enable retries, proxy, or browser fallback.",
            "default": 600
          },
          "requestDelayMillis": {
            "title": "Delay between requests",
            "minimum": 0,
            "maximum": 60000,
            "type": "integer",
            "description": "Optional per-request delay in milliseconds.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Configure Apify Proxy or custom proxy URLs. Disabled by default for the lowest possible cost; enable proxies when success rate matters more than cost.",
            "default": {
              "useApifyProxy": false
            }
          },
          "saveRawResponses": {
            "title": "Save raw responses",
            "type": "boolean",
            "description": "Save sanitized raw profile responses to key-value store for debugging. Avoid enabling in production unless needed.",
            "default": false
          },
          "debugLog": {
            "title": "Debug logging",
            "type": "boolean",
            "description": "Enable verbose structured logs.",
            "default": false
          },
          "failFast": {
            "title": "Fail fast",
            "type": "boolean",
            "description": "Stop the run on the first unrecoverable error instead of pushing error records.",
            "default": false
          },
          "onlyPublicData": {
            "title": "Only collect public data",
            "type": "boolean",
            "description": "The Actor is designed to collect only public profile information. Keep enabled.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}