{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Groups Scraper",
    "description": "Search public LinkedIn groups by keyword or fetch a group URL: name, member count, description, admins, optional posts and free deduped admin/poster lead rows. No LinkedIn login or cookies needed.",
    "version": "0.1",
    "x-build-id": "DKLoTn5tyvnbbbvBD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~linkedin-groups-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-linkedin-groups-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~linkedin-groups-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-linkedin-groups-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~linkedin-groups-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-linkedin-groups-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": {
          "searchKeywords": {
            "title": "Search keywords",
            "type": "string",
            "description": "Industry, role, or niche used to search public LinkedIn groups (e.g., Sales Operations). Specific phrases beat broad ones. Leave empty when you already have group URLs or use the keyword list below. NOT a LinkedIn profile or company URL - use our sibling LinkedIn Actors for those."
          },
          "searchKeywordList": {
            "title": "More search keywords",
            "maxItems": 20,
            "type": "array",
            "description": "Extra keywords searched in the same run (up to 20 in total with the field above). Groups found by several keywords are saved once. Max groups applies to the whole run.",
            "items": {
              "type": "string"
            }
          },
          "groupUrls": {
            "title": "Group URLs or IDs",
            "maxItems": 500,
            "type": "array",
            "description": "LinkedIn group URLs or numeric IDs to fetch in full. Accepts https://www.linkedin.com/groups/1898033/ and 1898033. Up to 500 unique IDs per run. NOT profile, company, or job URLs.",
            "items": {
              "type": "string"
            }
          },
          "maxGroups": {
            "title": "Max groups",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of group rows to save and bill (up to 1,000). The saved quality sample uses 1; raise this for bulk discovery. The cap applies to keyword results and URL fetches combined.",
            "default": 10
          },
          "enrichGroups": {
            "title": "Fetch full group profiles",
            "type": "boolean",
            "description": "On: each hit is followed by a full group fetch so the row includes description, rules, memberCount, admins and a health score (billed as 'LinkedIn group found'). Off: cheaper discovery cards only (name, URL, member text; billed as 'LinkedIn group card' and about 3x faster on big runs). URL mode always fetches the full profile.",
            "default": true
          },
          "includePosts": {
            "title": "Also scrape group posts",
            "type": "boolean",
            "description": "When enabled, public posts from each saved group are written as extra dataset rows (recordType=post). Billed per post plus one small 'posts run' fee per run. Leave off when you only need group metadata and admins. This is not the login-gated full member roster.",
            "default": false
          },
          "maxPostsPerGroup": {
            "title": "Max posts per group",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum public posts to save per group when posts are on (up to 500; 100 posts are fetched per provider page). Default 10.",
            "default": 10
          },
          "outputLeads": {
            "title": "Output deduped admin and poster leads",
            "type": "boolean",
            "description": "When enabled, the run also writes one free person row (recordType=lead) per unique group admin, poster or engager. Each lead lists personName, profileUrl, headline, role (admin, poster, engager, or a combination), groupsSeenIn and postCount. Lead rows are not billed. Default false.",
            "default": false
          },
          "postsOnly": {
            "title": "Posts only (no group row)",
            "type": "boolean",
            "description": "Fetch only the public posts of the groups in 'Group URLs or IDs'. No group row is saved or billed, so small post runs stay cheap. Needs at least one group URL or ID.",
            "default": false
          },
          "includeEngagers": {
            "title": "Add engagers (reactors and commenters)",
            "type": "boolean",
            "description": "For posts with 12 or more reactions or comments, also save the people who reacted or commented as 'engager' rows (name, profile URL, headline, reaction or comment text). One row per person per run, billed per engager row. Needs posts on.",
            "default": false
          },
          "maxEngagersPerPost": {
            "title": "Max engagers per post",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Cap of engager rows taken from each post's reactions and comments.",
            "default": 50
          },
          "maxEngagers": {
            "title": "Max engagers per run",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Overall cap of engager rows saved and billed in one run.",
            "default": 200
          },
          "outputInsights": {
            "title": "Free insight rows (growth and shared admins)",
            "type": "boolean",
            "description": "Free, not billed. Writes one 'member_growth' row per group whose member count changed since your last run (this Actor remembers counts between runs) and one 'admin_overlap' row per person who admins two or more of the groups found. Health scores are always added to full group rows for free.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}