{
  "openapi": "3.0.1",
  "info": {
    "title": "OmniExtract AI: LinkedIn + Multi-Site Job Scraper + AI Engine",
    "description": "2026’s elite job scraper for LinkedIn, Indeed & more. Use advanced filters to extract rich data: full descriptions, salaries & seniority. Features LLM-powered AI extraction (SmartScraper/SearchGraph) for any URL. Fast, proxy-ready & optimized for deep data. No coding required. JSON/CSV/audio export.",
    "version": "0.0",
    "x-build-id": "Ptb4Qc9CSOz3PgIz5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/mr.data_scientist~OmniExtract-AI/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-mr.data_scientist-OmniExtract-AI",
        "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/mr.data_scientist~OmniExtract-AI/runs": {
      "post": {
        "operationId": "runs-sync-mr.data_scientist-OmniExtract-AI",
        "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/mr.data_scientist~OmniExtract-AI/run-sync": {
      "post": {
        "operationId": "run-sync-mr.data_scientist-OmniExtract-AI",
        "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": [
          "graph_type"
        ],
        "properties": {
          "graph_type": {
            "title": "Extraction Mode",
            "enum": [
              "LinkedInJobScraper",
              "ZipRecruiterJobScraper",
              "SmartScraperGraph",
              "SearchGraph"
            ],
            "type": "string",
            "description": "Choose your extraction mode:\n\n━━━ JOB SEARCH ━━━\n• LinkedIn Jobs: Scrape LinkedIn job listings\n• ZipRecruiter Jobs: Scrape ZipRecruiter job listings\n\n━━━ WEB EXTRACTION ━━━\n• Web Scraper: Extract data from any URL\n• Web Search: Search the web and extract data (no URL needed)",
            "default": "SmartScraperGraph"
          },
          "source": {
            "title": "Source URL",
            "type": "string",
            "description": "⚠️ LEAVE EMPTY for SearchGraph, LinkedInJobScraper!\n\nFor SmartScraper/Speech/Script, enter the full URL:\n• https://www.stripe.com\n• https://news.ycombinator.com"
          },
          "prompt": {
            "title": "Prompt / Search Query",
            "minLength": 1,
            "maxLength": 10000,
            "type": "string",
            "description": "For SmartScraper/Speech/Script: Describe what to extract.\nFor SearchGraph: This IS your web search query!\nFor LinkedInJobScraper: Not needed (use fields below)."
          },
          "search_provider": {
            "title": "Search Provider",
            "enum": [
              "serper"
            ],
            "type": "string",
            "description": "🔍 SEARCH ENGINE: Serper.dev API is used for all search queries (reliable, no rate limits).\n\nSerper API key is REQUIRED for SearchGraph.\n\nGet your free API key at https://serper.dev",
            "default": "serper"
          },
          "llm_provider": {
            "title": "AI Provider",
            "enum": [
              "openai",
              "deepseek",
              "anthropic",
              "groq",
              "gemini"
            ],
            "type": "string",
            "description": "Choose your AI provider. Supported: OpenAI, DeepSeek, Anthropic (Claude), Groq, Gemini. SpeechGraph requires OpenAI. LinkedInJobScraper: Any provider works for AI title expansion.",
            "default": "openai"
          },
          "llm_api_key": {
            "title": "API Key",
            "type": "string",
            "description": "Your API key from the selected provider. For LinkedInJobScraper: Optional, only needed for AI title expansion."
          },
          "llm_model": {
            "title": "Model (Optional)",
            "type": "string",
            "description": "Leave empty for default. Examples: gpt-4o-mini, claude-3-5-sonnet-20240620"
          },
          "llm_base_url": {
            "title": "Custom API URL (Optional)",
            "type": "string",
            "description": "Only for self-hosted or Azure. Leave empty normally."
          },
          "job_keyword": {
            "title": "Job Titles",
            "type": "string",
            "description": "💼 LINKEDIN JOBS: Job title(s) to search for. Supports comma-separated titles for multiple searches (e.g., 'Director Renewable Energy, VP Hydrogen, Head of Energy'). If resume_text is provided, AI will auto-generate optimal keywords."
          },
          "min_rating": {
            "title": "Minimum Job Rating (AI Filter)",
            "minimum": 1,
            "maximum": 10,
            "type": "number",
            "description": "💼 LINKEDIN JOBS + AI: Only return jobs with AI rating >= this value (out of 10). Jobs below this threshold are filtered out. Default: 7.0",
            "default": 7
          },
          "min_good_jobs": {
            "title": "Minimum Good Jobs to Find",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "💼 LINKEDIN JOBS + AI: Keep searching until at least this many jobs pass the rating threshold. The system will iterate up to 3 times with new keywords. If Serper API key is provided, will use fallback search to find more qualifying jobs. Default: 5",
            "default": 5
          },
          "job_location": {
            "title": "Job Location",
            "type": "string",
            "description": "💼 LINKEDIN JOBS ONLY: Location to search (e.g., 'San Francisco', 'Remote', 'United States')"
          },
          "max_jobs": {
            "title": "Maximum Jobs to Scrape",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "💼 LINKEDIN JOBS ONLY: How many job listings to scrape (1-500)",
            "default": 50
          },
          "scrape_job_details": {
            "title": "Scrape Full Job Details",
            "type": "boolean",
            "description": "💼 LINKEDIN JOBS ONLY: Fetch detailed info (description, requirements) for each job. Slower but more data.",
            "default": true
          },
          "experience_levels": {
            "title": "Experience Levels",
            "type": "array",
            "description": "💼 LINKEDIN JOBS ONLY: Filter by experience level",
            "items": {
              "type": "string",
              "enum": [
                "internship",
                "entry_level",
                "associate",
                "mid_senior",
                "director",
                "executive"
              ],
              "enumTitles": [
                "Internship",
                "Entry Level",
                "Associate",
                "Mid-Senior Level",
                "Director",
                "Executive"
              ]
            }
          },
          "work_types": {
            "title": "Work Types",
            "type": "array",
            "description": "💼 LINKEDIN JOBS ONLY: Filter by work arrangement",
            "items": {
              "type": "string",
              "enum": [
                "on_site",
                "remote",
                "hybrid"
              ],
              "enumTitles": [
                "On-Site",
                "Remote",
                "Hybrid"
              ]
            }
          },
          "date_posted": {
            "title": "Date Posted",
            "enum": [
              "",
              "past_24_hours",
              "past_week",
              "past_month"
            ],
            "type": "string",
            "description": "💼 LINKEDIN JOBS ONLY: Filter by posting date"
          },
          "distance": {
            "title": "Distance / Radius",
            "enum": [
              "",
              "exact",
              "5",
              "10",
              "25",
              "50",
              "100"
            ],
            "type": "string",
            "description": "💼 LINKEDIN JOBS ONLY: Search radius from location",
            "default": ""
          },
          "resume_text": {
            "title": "Resume / Background",
            "type": "string",
            "description": "📄 REQUIRED for AI Smart Filter: Paste your full resume or professional background. AI uses this to score jobs against your experience."
          },
          "enable_ai_job_filter": {
            "title": "🤖 AI Smart Job Filter",
            "type": "boolean",
            "description": "💼 LINKEDIN/INDEED JOBS: Use AI to intelligently filter and score jobs based on your resume. Only returns jobs that match your experience, industry, and seniority level.\n\n⚠️ Requires: resume_text + llm_api_key\n\n📊 Pricing: 4x standard rate (AI processing cost)",
            "default": false
          },
          "ziprecruiter_keyword": {
            "title": "🔍 ZipRecruiter Job Titles",
            "type": "string",
            "description": "🔍 ZIPRECRUITER JOBS ONLY: Job title(s) to search for on ZipRecruiter. Supports comma-separated titles (e.g., 'Software Engineer, Data Scientist, Product Manager')."
          },
          "ziprecruiter_location": {
            "title": "📍 ZipRecruiter Location",
            "type": "string",
            "description": "🔍 ZIPRECRUITER JOBS ONLY: Location to search (e.g., 'New York, NY', 'Remote', 'Washington DC')."
          },
          "ziprecruiter_max_jobs": {
            "title": "💼 Max ZipRecruiter Jobs",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "🔍 ZIPRECRUITER JOBS ONLY: Maximum number of job listings to scrape (1-500).",
            "default": 50
          },
          "ziprecruiter_scrape_details": {
            "title": "📄 Scrape Full Details",
            "type": "boolean",
            "description": "🔍 ZIPRECRUITER JOBS ONLY: Fetch full job descriptions for each listing. Slower but provides complete data.",
            "default": true
          },
          "ziprecruiter_date_posted": {
            "title": "📅 Date Posted",
            "enum": [
              "",
              "24hr",
              "5days",
              "10days",
              "month"
            ],
            "type": "string",
            "description": "🔍 ZIPRECRUITER JOBS ONLY: Filter by when job was posted. ZipRecruiter supports: 24hr, 5days, 10days, month."
          },
          "ziprecruiter_radius": {
            "title": "📍 Search Radius (Miles)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "🔍 ZIPRECRUITER JOBS ONLY: Search radius from location in miles. Valid values: 5, 10, 25, 50, 100. Leave empty or 0 for any distance."
          },
          "max_results": {
            "title": "Search Results Count",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "SearchGraph only: How many search results to process.",
            "default": 5
          },
          "serper_api_key": {
            "title": "Serper API Key",
            "type": "string",
            "description": "🔍 REQUIRED for SearchGraph.\n\nGet your FREE API key at https://serper.dev (2,500 free searches/month).\n\nThis powers all web searches with reliable Google results."
          },
          "enable_enrichment": {
            "title": "Enable Smart Enrichment",
            "type": "boolean",
            "description": "🔍 SEARCHGRAPH + SERPER ONLY: Automatically detect 'Unknown' values and run follow-up searches to find missing data (names, LinkedIn profiles, etc.). Requires Serper API key.",
            "default": true
          },
          "headless": {
            "title": "Headless Browser",
            "type": "boolean",
            "description": "Run browser in background (recommended).",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Enable for blocked websites. Recommended for LinkedIn job scraping."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}