{
  "openapi": "3.0.1",
  "info": {
    "title": "Instahyre Jobs Scraper - Company Ratings, Recruiters & Emails",
    "description": "Scrape Instahyre jobs in India: title, company, cities, skills, experience, full description, recruiter, stipend, company Glassdoor ratings, website and tech stack, employer emails. Every site filter, links or ids, newest first, monitor mode, company tracker. $0.94 per 1,000 jobs.",
    "version": "0.1",
    "x-build-id": "SpjVYSPxiIzdjHANX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~instahyre-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-instahyre-jobs-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/topapi~instahyre-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-instahyre-jobs-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/topapi~instahyre-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-instahyre-jobs-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": {
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Skill, job title or technology, one per line: python, react, data analyst, devops, product manager. Each keyword is one Instahyre search (Instahyre matches titles and skills). Empty = every job matching the filters below, or the whole board (about 13,000 jobs). API aliases: keywords, query.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Cities, states or regions as Instahyre names them: Bangalore (or Bengaluru), Pune, Hyderabad, Gurgaon (or Gurugram), Noida, Mumbai, Chennai, Delhi / NCR, Karnataka, South India, Anywhere in India, Work From Home. Instahyre filters by them itself; several = any of them. Empty = all of India. API aliases: cities, city.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Links",
            "type": "array",
            "description": "Instahyre links: search pages (instahyre.com/search-jobs/?skills=Python), landing pages (instahyre.com/python-jobs-in-bangalore/, /jobs-in-pune/, /internships-in-bangalore/, /work-from-home-react-jobs/), company pages (instahyre.com/jobs-at-zepto/) or single jobs (instahyre.com/job-443990-...). The filters below are added to search links. API aliases: searchUrls, jobUrls.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "jobIds": {
            "title": "Job ids",
            "type": "array",
            "description": "Instahyre job numbers, e.g. 443990 (the number in the job link).",
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "Only jobs of these companies, name as on Instahyre: Amazon, Accenture, Zepto. A name Instahyre does not know exactly is matched against its own company type-ahead (every word of your name). API alias: companyNames.",
            "items": {
              "type": "string"
            }
          },
          "experienceYears": {
            "title": "Years of experience",
            "minimum": 0,
            "maximum": 30,
            "type": "integer",
            "description": "Jobs open to a candidate with this many years of experience (Instahyre's own filter). 0 = jobs for freshers. Empty = any."
          },
          "jobFunctions": {
            "title": "Job functions",
            "type": "array",
            "description": "Instahyre's job functions, by name, slug or id: Backend Development, frontend-development, Data Science / Machine Learning, DevOps / Cloud, Product Management, Software Testing / QA / SDET, Sales / Business Development. Several = any of them. API alias: jobFunctionSlugs.",
            "items": {
              "type": "string"
            }
          },
          "jobCategories": {
            "title": "Job categories",
            "type": "array",
            "description": "Instahyre's broader groups of functions: Software Engineering, Data Science & Analytics, Product & Project Management, Design & Creative, Sales, Marketing, IT Operations, Operations, Human Resources, Customer Service, Accounting, Finance & Banking, Consulting, Hardware Engineering, Legal, Education & Training, General Management, Administration & Facilities.",
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Industries as on Instahyre: Computer Software / IT / Internet, Banking / Financial Services, Management Consulting, Healthcare / Hospitals, E-Commerce... Several = any of them.",
            "items": {
              "type": "string"
            }
          },
          "jobType": {
            "title": "Job type",
            "enum": [
              "any",
              "full_time",
              "internship"
            ],
            "type": "string",
            "description": "Full-time jobs, internships, or both (Instahyre's own filter).",
            "default": "any"
          },
          "companySize": {
            "title": "Company size",
            "enum": [
              "any",
              "small",
              "medium",
              "large"
            ],
            "type": "string",
            "description": "Instahyre's own company-size groups.",
            "default": "any"
          },
          "remoteOnly": {
            "title": "Work from home only",
            "type": "boolean",
            "description": "Only jobs Instahyre lists under Work From Home (with your locations: remote jobs of companies there). Every row has isRemote and workplaceType.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest"
            ],
            "type": "string",
            "description": "Instahyre sorts by relevance only and keeps jobs listed for months. Newest first reads the whole search (35 jobs a request) and orders it by job id, which rises with the posting date.",
            "default": "relevance"
          },
          "titleInclude": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only jobs whose title contains one of these words, e.g. senior, lead.",
            "items": {
              "type": "string"
            }
          },
          "titleExclude": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Remove jobs whose title contains one of these words, e.g. intern, manager.",
            "items": {
              "type": "string"
            }
          },
          "titleMustMatchKeyword": {
            "title": "Title must match the keyword",
            "type": "boolean",
            "description": "Instahyre's search also matches skills: python brings Backend Engineer jobs that list Python. On = only jobs whose title has every word of the keyword.",
            "default": false
          },
          "skills": {
            "title": "Skills filter",
            "type": "array",
            "description": "Keep only jobs whose skill tags match, e.g. react, sql (partial match). Alone (no keywords) they are also the search.",
            "items": {
              "type": "string"
            }
          },
          "skillMatch": {
            "title": "Skills must match",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "Any: a job passes when one listed skill matches. All: every listed skill must match.",
            "default": "any"
          },
          "keywords": {
            "title": "Text filter",
            "type": "array",
            "description": "With keywords above: keep only jobs with these terms in the title, skills, company or location. Without keywords above: these are the search.",
            "items": {
              "type": "string"
            }
          },
          "keywordMatch": {
            "title": "Text filter must match",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "Any: a job passes when one term matches. All: every term must match.",
            "default": "any"
          },
          "excludeKeywords": {
            "title": "Exclude terms",
            "type": "array",
            "description": "Remove jobs with any of these terms in the title, skills, company or location.",
            "items": {
              "type": "string"
            }
          },
          "companyExclude": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Remove jobs of companies whose name contains one of these, e.g. staffing agencies.",
            "items": {
              "type": "string"
            }
          },
          "excludeAgencyPosted": {
            "title": "Skip jobs posted by agencies",
            "type": "boolean",
            "description": "Skip jobs whose recruiter works for another company than the employer (a staffing agency). Needs job details.",
            "default": false
          },
          "diversityEmployersOnly": {
            "title": "Diversity employers only",
            "type": "boolean",
            "description": "Only jobs of employers Instahyre badges for diversity hiring.",
            "default": false
          },
          "featuredEmployersOnly": {
            "title": "Featured employers only",
            "type": "boolean",
            "description": "Only jobs of employers Instahyre features.",
            "default": false
          },
          "minCompanyRating": {
            "title": "Min company rating",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Keep jobs of companies rated at least this on Glassdoor (overall, 1-5, as Instahyre shows it), e.g. 4. Companies without a rating are removed. Removed jobs are free."
          },
          "skipDuplicates": {
            "title": "Skip reposts",
            "type": "boolean",
            "description": "Companies often post one job several times: same title + company + cities = one row.",
            "default": true
          },
          "includeDetails": {
            "title": "Job details",
            "type": "boolean",
            "description": "Full description, experience range, job category and functions, open or closed, recruiter name, designation and company, agency flag, internship stipend and duration. One request per job; charged as a job-details event per job that gets them.",
            "default": true
          },
          "includeCompanyProfile": {
            "title": "Company profile",
            "type": "boolean",
            "description": "The company's Glassdoor ratings (overall, culture, work-life balance, salary & benefits, career, diversity, recommend to a friend), website, LinkedIn and other links, benefits, tech stack, industry, about, why join, interview process and open jobs on Instahyre. One request per company, free.",
            "default": true
          },
          "enrichEmails": {
            "title": "Employer contacts",
            "type": "boolean",
            "description": "Read the company's own website (as Instahyre lists it) for contact emails, phone numbers and social profiles. Charged once per company whose website gave an email; no email, no charge.",
            "default": false
          },
          "withEmailOnly": {
            "title": "Only jobs with an employer email",
            "type": "boolean",
            "description": "With employer contacts: remove jobs whose company website gave no email (free).",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "text",
              "html",
              "markdown",
              "both",
              "all",
              "none"
            ],
            "type": "string",
            "description": "How the full description is delivered (with job details on).",
            "default": "text"
          },
          "descriptionMaxLength": {
            "title": "Description length cap",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Cut descriptions to this many characters (0 = full)."
          },
          "monitorMode": {
            "title": "Only new jobs",
            "type": "boolean",
            "description": "Remembers the jobs of earlier runs with the same search and monitor name and returns only new (and changed) ones, newest first. Jobs already delivered are free; a run with nothing new costs almost nothing. A job delivered earlier without the job details, employer contacts or company profile that a later run turns on comes again once with them, as changeType details (billed like any job).",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Separate memory for each alert: use a different name for each search you schedule. API aliases: stateName, monitorStateName.",
            "default": "instahyre-monitor"
          },
          "emitBaseline": {
            "title": "First run returns the current jobs",
            "type": "boolean",
            "description": "On: the first monitor run delivers every current match. Off: it only remembers them (nothing charged) and later runs return what appears after it.",
            "default": true
          },
          "includeUpdated": {
            "title": "Also changed jobs",
            "type": "boolean",
            "description": "Return jobs seen before whose title, company, cities or skills changed, as changeType updated.",
            "default": true
          },
          "includeUnchanged": {
            "title": "Also unchanged jobs",
            "type": "boolean",
            "description": "Return every match on every run (changeType unchanged for jobs seen before). Billed like any job.",
            "default": false
          },
          "includeRemoved": {
            "title": "Report removed jobs",
            "type": "boolean",
            "description": "After a full scan, one row (changeType removed) for each job of the last full scan that is gone, with removedReason closed or no longer in the search. Billed as a job.",
            "default": false
          },
          "resetMonitor": {
            "title": "Reset monitor",
            "type": "boolean",
            "description": "Forget the jobs remembered under this monitor name and start again.",
            "default": false
          },
          "trackCompanies": {
            "title": "Track companies (hiring tracker)",
            "type": "array",
            "description": "Company names to track instead of listing jobs: one row per company with open roles, function, location and skill mix, remote share and, from the second run, the change since the last run (roles opened and closed). The search fields above are ignored. Charged per company row.",
            "items": {
              "type": "string"
            }
          },
          "marketSnapshot": {
            "title": "Market snapshot",
            "type": "boolean",
            "description": "Write Instahyre's own counts for each search (total jobs, top companies, locations, functions, industries, company sizes, job types, experience levels) to the MARKET_SNAPSHOT record. Free.",
            "default": true
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 0,
            "maximum": 200000,
            "type": "integer",
            "description": "Jobs (or tracked companies) in total. 0 = no limit. API alias: maxJobs.",
            "default": 50
          },
          "maxItemsPerSearch": {
            "title": "Max rows per keyword",
            "minimum": 0,
            "maximum": 200000,
            "type": "integer",
            "description": "Per keyword or search link. API alias: maxJobsPerSearch."
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "maximum": 300,
            "type": "integer",
            "description": "Instahyre returns 35 jobs a page. Bounds how deep a search is read."
          },
          "splitLargeSearches": {
            "title": "Read past 10,000 per search",
            "type": "boolean",
            "description": "Instahyre shows at most 10,000 jobs per search. On = a bigger search is read per company size (then job type) and merged without duplicates.",
            "default": true
          },
          "maxConcurrency": {
            "title": "Max parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many Instahyre requests run at once (each egress stays under Instahyre's per-minute limits).",
            "default": 10
          },
          "telegramToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Bot token from @BotFather; with a chat id, each run sends its new jobs there."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat (or channel) id that receives the alert."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook",
            "type": "string",
            "description": "Slack incoming-webhook URL for a message with the new jobs."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook",
            "type": "string",
            "description": "Discord webhook URL for a message with the new jobs."
          },
          "teamsWebhookUrl": {
            "title": "Teams webhook",
            "type": "string",
            "description": "Microsoft Teams incoming-webhook URL for a message with the new jobs."
          },
          "ntfyTopic": {
            "title": "ntfy topic",
            "type": "string",
            "description": "ntfy.sh topic for a push notification with the new jobs."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp Cloud API token",
            "type": "string",
            "description": "WhatsApp Cloud API access token (Meta) for a message with the new jobs."
          },
          "whatsappPhoneNumberId": {
            "title": "WhatsApp phone number id",
            "type": "string",
            "description": "The sending WhatsApp Business phone number id."
          },
          "whatsappTo": {
            "title": "WhatsApp recipient",
            "type": "string",
            "description": "Recipient phone number with country code, e.g. 919812345678."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POSTs { total, items, datasetUrl } as JSON."
          },
          "notificationLimit": {
            "title": "Jobs per alert",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "How many jobs each alert lists (the count covers all of them).",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: Instahyre answers a direct connection, and the actor moves to the Apify datacenter proxy by itself when Instahyre rate-limits it. Set one only to send everything through your own proxy.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}