{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Posts Scraper - Keyword & Hashtag [NO COOKIES] ✅",
    "description": "Search LinkedIn's public post graph by keyword, hashtag, or author. Extract content, engagement metrics, reaction breakdowns, author profile data, and timestamps. No login, no cookies. Built for social listening, B2B competitive intelligence, and thought-leader research.",
    "version": "0.0",
    "x-build-id": "OKdfJw0AbHJgOvBnA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/unseenuser~LinkedIn-Post-Seach-Scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-unseenuser-LinkedIn-Post-Seach-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/unseenuser~LinkedIn-Post-Seach-Scraper/runs": {
      "post": {
        "operationId": "runs-sync-unseenuser-LinkedIn-Post-Seach-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/unseenuser~LinkedIn-Post-Seach-Scraper/run-sync": {
      "post": {
        "operationId": "run-sync-unseenuser-LinkedIn-Post-Seach-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Step 1: What do you want to do?",
            "enum": [
              "search",
              "search_and_enrich",
              "get_details"
            ],
            "type": "string",
            "description": "Pick 'Search posts' to find posts by keyword or filter (most common). Pick 'Search + auto-fetch' to also grab full engagement details for every match. Pick 'Get details' if you already have post URLs and just want their full data.",
            "default": "search"
          },
          "searchKeywords": {
            "title": "Keywords or hashtags (bulk supported)",
            "type": "array",
            "description": "Type or paste one keyword or hashtag per line. Each is searched separately and results are merged. Examples: `#GenAI`, `AI safety`, `remote work`.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "How many posts to return (0 = everything)",
            "minimum": 0,
            "type": "integer",
            "description": "0 = return every result the search finds (no limit). This cap protects you from an unexpected bill and keeps the shared queue fair - it is not a technical limit.\n\nSet any other number to cap results at that amount. Cost: $5.50 per 1,000 posts returned.",
            "default": 0
          },
          "datePosted": {
            "title": "Posted within (any time by default)",
            "enum": [
              "any",
              "1h",
              "24h",
              "week",
              "month",
              "3months",
              "6months",
              "year"
            ],
            "type": "string",
            "description": "Only return posts from this time window. Example: pick 'Past 24 hours' for daily trend briefs. Leave the default 'Any time' for no date filter.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort by (Relevance by default)",
            "enum": [
              "relevance",
              "date"
            ],
            "type": "string",
            "description": "Choose 'Relevance' for the best keyword matches (default). Choose 'Date' for the newest posts first.",
            "default": "relevance"
          },
          "contentType": {
            "title": "Content type (leave blank for all)",
            "enum": [
              "videos",
              "images",
              "live_videos",
              "documents",
              "collaborative_articles",
              "jobs"
            ],
            "type": "string",
            "description": "Pick one kind of post to include. Leave blank to include every type. Power users hitting the API can send an array here (e.g. [\"videos\",\"documents\"]) to combine multiple types in one run."
          },
          "authorsCompany": {
            "title": "Posts by employees of these companies",
            "type": "array",
            "description": "Track what a company's employees are posting. Paste a LinkedIn company URL or its short handle, one per line. Examples: `https://www.linkedin.com/company/stripe` or just `stripe`.",
            "items": {
              "type": "string"
            }
          },
          "authorProfiles": {
            "title": "Posts by these specific people",
            "type": "array",
            "description": "Paste a LinkedIn profile URL or its handle, one per line. Examples: `https://www.linkedin.com/in/satyanadella` or just `satyanadella`.",
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "Posts from these company pages (not their employees)",
            "type": "array",
            "description": "Posts published by the company page itself. Paste a LinkedIn company URL or handle, one per line. Examples: `https://www.linkedin.com/company/stripe` or just `stripe`.",
            "items": {
              "type": "string"
            }
          },
          "authorKeywords": {
            "title": "Author's profile must contain these words (bulk supported)",
            "type": "array",
            "description": "Match only authors whose LinkedIn profile contains these words. Each entry runs as a separate search and results merge. Examples: `VP Engineering`, `CFO`, `recruiter`.",
            "items": {
              "type": "string"
            }
          },
          "groups": {
            "title": "Inside these LinkedIn groups (bulk supported)",
            "type": "array",
            "description": "Restrict to posts inside one or more LinkedIn groups. Paste the group URL or ID, one per line. Example: `https://www.linkedin.com/groups/4316014/` or `4316014`.",
            "items": {
              "type": "string"
            }
          },
          "mentioningCompanies": {
            "title": "Posts that mention these companies",
            "type": "array",
            "description": "The brand-monitoring filter. Paste a LinkedIn company URL or handle, one per line. Every post tagging or @-mentioning them is returned. Examples: `https://www.linkedin.com/company/stripe` or just `stripe`.",
            "items": {
              "type": "string"
            }
          },
          "mentioningMembers": {
            "title": "Posts that @mention these people",
            "type": "array",
            "description": "Paste a LinkedIn profile URL or handle, one per line. Examples: `https://www.linkedin.com/in/satyanadella` or just `satyanadella`.",
            "items": {
              "type": "string"
            }
          },
          "postUrls": {
            "title": "Post URLs to fetch (required for 'Get details' mode)",
            "type": "array",
            "description": "Paste full LinkedIn post URLs, one per line. Example: `https://www.linkedin.com/posts/example-activity-1234567890`.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}