{
  "openapi": "3.0.1",
  "info": {
    "title": "🔥 Linkedin Profile Scraper [Cheapst+ Fastest]",
    "description": "LinkedIn Profile Scraper extracts public profile data at scale, including names, headlines, experiences, skills, education, and connections. Perfect for lead generation, recruitment, and market research. Get structured, reliable LinkedIn data quickly with customizable scraping options.",
    "version": "0.1",
    "x-build-id": "b2tBladiix2ScB4FI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scraper-engine~linkedin-profile-scraper-cheapst-fastest/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scraper-engine-linkedin-profile-scraper-cheapst-fastest",
        "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/scraper-engine~linkedin-profile-scraper-cheapst-fastest/runs": {
      "post": {
        "operationId": "runs-sync-scraper-engine-linkedin-profile-scraper-cheapst-fastest",
        "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/scraper-engine~linkedin-profile-scraper-cheapst-fastest/run-sync": {
      "post": {
        "operationId": "run-sync-scraper-engine-linkedin-profile-scraper-cheapst-fastest",
        "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": {
          "profileUrls": {
            "title": "🔗 Profiles to score",
            "type": "array",
            "description": "Public LinkedIn profile links to scan (e.g. linkedin.com/in/username). One per line; processed in order. The base key `urls` is also accepted for backward compatibility.",
            "items": {
              "type": "string"
            }
          },
          "computeCredibilityScore": {
            "title": "🏆 Compute credibility score",
            "type": "boolean",
            "description": "Add a composite credibilityScore (0-100) and credibilityBand (Minimal/Low/Moderate/High/Very High) to every profile. Default true.",
            "default": true
          },
          "includeCredibilityBreakdown": {
            "title": "🧮 Include score breakdown",
            "type": "boolean",
            "description": "Include credibilityBreakdown — the per-signal points (recommendations, network, experience, education, content, completeness) so the score is fully transparent. Default true.",
            "default": true
          },
          "includeRecommendations": {
            "title": "⭐ Extract recommendations",
            "type": "boolean",
            "description": "Extract written recommendations (recommender name, link, photo, text) from the public profile and compute recommendationAnalytics. Many profiles show none anonymously → returns an empty list, never fabricated. Default true.",
            "default": true
          },
          "recommendationKeywords": {
            "title": "🔍 Recommendation keywords filter",
            "type": "array",
            "description": "Keep only recommendations whose text contains any of these keywords (case-insensitive). Example: [\"leadership\", \"reliable\"]. Leave empty to keep all. recommendationAnalytics reports count vs matchedCount.",
            "items": {
              "type": "string"
            }
          },
          "includePeopleAlsoViewed": {
            "title": "👥 People also viewed",
            "type": "boolean",
            "description": "Include the “People also viewed” / similar-profiles list. Default true.",
            "default": true
          },
          "includeProjects": {
            "title": "📁 Projects",
            "type": "boolean",
            "description": "Extract the Projects section (name, dates, description, contributors). Default true.",
            "default": true
          },
          "maxRetries": {
            "title": "🔁 Max retries per profile",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "Direct-fetch attempts before falling back (exponential backoff + jitter; escalates to RESIDENTIAL on block). Default 5.",
            "default": 5
          },
          "requestTimeoutSecs": {
            "title": "⏱️ Request timeout (seconds)",
            "minimum": 5,
            "maximum": 180,
            "type": "integer",
            "description": "Per-request timeout in seconds. Default 30.",
            "default": 30
          },
          "customFetcherUrlTemplate": {
            "title": "🧰 Custom fetcher URL template",
            "type": "string",
            "description": "Optional. Route the fetch through a 3rd-party scraping API you pay for, using the literal {url} placeholder. Examples:\n  • ScrapingBee:  https://app.scrapingbee.com/api/v1/?api_key=YOUR_KEY&url={url}&premium_proxy=true&country_code=us\n  • ScraperAPI:   http://api.scraperapi.com/?api_key=YOUR_KEY&url={url}&premium=true\nLeave empty to skip."
          },
          "enableWaybackFallback": {
            "title": "🗄️ Wayback Machine fallback",
            "type": "boolean",
            "description": "If LinkedIn blocks and no custom fetcher succeeds, look up an existing Wayback Machine snapshot of the URL (free, fast). Default true.",
            "default": true
          },
          "enableWaybackSaveFallback": {
            "title": "💾 Wayback Save-Page-Now fallback",
            "type": "boolean",
            "description": "If no existing snapshot is found, trigger Wayback Save Page Now to create a fresh one. Slow (30-60s per profile) and rate-limited (~15/min) but free and needs no auth. Disable for large bulk runs. Default true.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Select Apify Proxy (RESIDENTIAL recommended) or custom proxy URLs.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}