{
  "openapi": "3.0.1",
  "info": {
    "title": "Internshala Scraper - Internships, Jobs, Stipends & Applicants",
    "description": "Scrape Internshala internships and fresher jobs in India by keyword, category, city and every Internshala filter, or from search, listing and company links. Stipend or CTC, applicants, openings, skills, perks, employer history, monitor mode. $0.27 per 1,000 listings, $0.08 more with full details.",
    "version": "0.1",
    "x-build-id": "DVx2kgqrRT5SXPgMY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~internshala-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-internshala-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~internshala-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-internshala-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~internshala-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-internshala-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": {
          "keywords": {
            "title": "Search keywords",
            "type": "array",
            "description": "Roles, skills or keywords, e.g. python, marketing, data science, graphic design. Each keyword runs its own Internshala keyword search, combined with the category, city and filters below. Leave empty to search by category / city only, or to read the links below.",
            "items": {
              "type": "string"
            }
          },
          "listingType": {
            "title": "Internships, jobs or both",
            "enum": [
              "internship",
              "job",
              "both"
            ],
            "type": "string",
            "description": "Internships, fresher jobs (Internshala's jobs board) or both. With both, every search runs once on each board.",
            "default": "internship"
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Internshala categories (profiles), written as the site writes them: python, data science, web development, marketing, digital marketing, content writing, graphic design, human resources, finance, sales, operations, computer science, mechanical, civil, android app development, machine learning. Several categories are combined with OR in one search, as on Internshala.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Cities",
            "type": "array",
            "description": "Cities, e.g. delhi, mumbai, bangalore, hyderabad, pune, noida, gurgaon, kolkata, chennai. Several cities are combined with OR in one search, as on Internshala.",
            "items": {
              "type": "string"
            }
          },
          "workFromHome": {
            "title": "Work from home only",
            "type": "boolean",
            "description": "Only remote (work from home) listings, using Internshala's own filter.",
            "default": false
          },
          "partTime": {
            "title": "Part-time only",
            "type": "boolean",
            "description": "Only part-time listings, using Internshala's own filter.",
            "default": false
          },
          "startUrls": {
            "title": "Internshala links",
            "type": "array",
            "description": "Any internshala.com link: a search or list page you filtered on the site (internships, jobs, fresher jobs, work from home, internships for women, keyword pages), a single listing (/internship/detail/... or /job/detail/...) or a company page (/company/...: every open listing of that employer). Search pages are read from their first page with every page after it.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "urlsFromFile": {
            "title": "Links from a file",
            "type": "string",
            "description": "Optional: the URL of a text or CSV file with Internshala links, one per line (for example a file in your own Apify key-value store, a Google Sheet published as CSV or a raw GitHub file)."
          },
          "durationMonths": {
            "title": "Internship duration (months)",
            "type": "array",
            "description": "Internships only: exact durations in months, Internshala's own duration filter. One search runs per value. Leave empty for any duration.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "12"
              ],
              "enumTitles": [
                "1 month",
                "2 months",
                "3 months",
                "4 months",
                "5 months",
                "6 months",
                "12 months"
              ]
            }
          },
          "maxDurationMonths": {
            "title": "Longest duration (months)",
            "minimum": 0,
            "type": "integer",
            "description": "Internships only: drop listings longer than this many months (a duration in weeks counts as part of a month). 0 = no limit."
          },
          "minStipend": {
            "title": "Minimum stipend (INR a month)",
            "minimum": 0,
            "type": "integer",
            "description": "Internships only: Internshala's own stipend filter (2,000 to 10,000 on the site), then every row is checked: unpaid listings and stipends whose top end is below this are dropped. Listings that do not state a stipend are kept. 0 = no minimum."
          },
          "startDate": {
            "title": "Starting from",
            "type": "string",
            "description": "Internships only: Internshala's start-date filter (YYYY-MM-DD), e.g. 2026-12-01."
          },
          "withJobOffer": {
            "title": "With job offer (PPO) only",
            "type": "boolean",
            "description": "Internships only: internships that come with a pre-placement job offer.",
            "default": false
          },
          "fastResponse": {
            "title": "Fast response only",
            "type": "boolean",
            "description": "Internships only: employers who usually respond quickly.",
            "default": false
          },
          "earlyApplicant": {
            "title": "Early applicant only",
            "type": "boolean",
            "description": "Only listings where you would be among the first applicants (Internshala's 'Be an early applicant').",
            "default": false
          },
          "forWomen": {
            "title": "Internships for women",
            "type": "boolean",
            "description": "Internships only: Internshala's internships-for-women board.",
            "default": false
          },
          "internationalOnly": {
            "title": "International internships only",
            "type": "boolean",
            "description": "Internships only: Internshala's international internships.",
            "default": false
          },
          "fresherOnly": {
            "title": "Fresher jobs only",
            "type": "boolean",
            "description": "Jobs only: Internshala's fresher-jobs board (no experience required).",
            "default": false
          },
          "minSalary": {
            "title": "Minimum salary (INR a year)",
            "minimum": 0,
            "type": "integer",
            "description": "Jobs only: Internshala's salary filter in lakhs a year (the value is rounded down to whole lakhs, up to 10), then every row is checked: annual CTCs whose top end is below this are dropped. 0 = no minimum."
          },
          "experience": {
            "title": "Experience",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "5",
              "5plus"
            ],
            "type": "string",
            "description": "Jobs only: Internshala's experience filter. The numbered options are 'up to N years'; 'More than 5 years' is a separate bucket."
          },
          "maxExperienceYears": {
            "title": "Most experience required (years)",
            "minimum": 0,
            "type": "integer",
            "description": "Jobs only: drop jobs that require more than this many years of experience."
          },
          "datePosted": {
            "title": "Posted within",
            "enum": [
              "all",
              "24h",
              "3d",
              "7d",
              "14d",
              "30d"
            ],
            "type": "string",
            "description": "Keep listings whose posting age on the card ('Few hours ago', '3 days ago', '2 weeks ago') falls in this window. Checked before the listing's page is read; dropped listings are not charged.",
            "default": "all"
          },
          "fromDate": {
            "title": "Posted on or after",
            "type": "string",
            "description": "YYYY-MM-DD. Uses the posting date on the listing's page (or the card's age when details are off)."
          },
          "toDate": {
            "title": "Posted on or before",
            "type": "string",
            "description": "YYYY-MM-DD."
          },
          "skills": {
            "title": "Required skills",
            "type": "array",
            "description": "Keep listings that ask for these skills (e.g. Python, SQL, Canva). With full details on, the full skill list of the listing is checked.",
            "items": {
              "type": "string"
            }
          },
          "skillsMatch": {
            "title": "Skills must match",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "Any one of the skills above, or all of them.",
            "default": "any"
          },
          "includeKeywords": {
            "title": "Must mention one of",
            "type": "array",
            "description": "Keep listings whose title, skills, categories or description mention at least one of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Skip if it mentions",
            "type": "array",
            "description": "Drop listings whose title, company, skills, categories or description mention any of these words, e.g. sales, telecalling, unpaid.",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Skip these companies",
            "type": "array",
            "description": "Drop listings from employers whose name contains any of these.",
            "items": {
              "type": "string"
            }
          },
          "specialFilters": {
            "title": "Badges to require",
            "type": "array",
            "description": "Keep only listings showing every badge picked.",
            "items": {
              "type": "string",
              "enum": [
                "actively_hiring",
                "early_applicant",
                "job_offer"
              ],
              "enumTitles": [
                "Actively hiring",
                "Be an early applicant",
                "Job offer after the internship"
              ]
            }
          },
          "minOpenings": {
            "title": "Minimum openings",
            "minimum": 0,
            "type": "integer",
            "description": "Needs full details: keep listings with at least this many openings."
          },
          "maxApplicants": {
            "title": "Most applicants",
            "minimum": 0,
            "type": "integer",
            "description": "Needs full details: drop listings with more applicants than this (listings showing 'Be an early applicant' are kept)."
          },
          "maxApplicantsPerOpening": {
            "title": "Most applicants per opening",
            "minimum": 0,
            "type": "integer",
            "description": "Needs full details: drop listings with more applicants per opening than this."
          },
          "closingWithinDays": {
            "title": "Closing within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Needs full details: keep listings whose apply-by date is within this many days."
          },
          "maxResults": {
            "title": "Max listings per search",
            "minimum": 0,
            "type": "integer",
            "description": "The most listings delivered from each search, link or company. 0 = every listing of the search (Internshala shows 40-52 a page).",
            "default": 100
          },
          "maxTotalResults": {
            "title": "Max listings in total",
            "minimum": 0,
            "type": "integer",
            "description": "The most listings delivered by the whole run. 0 = no total limit."
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "The most result pages read per search. 0 = no limit."
          },
          "sortBy": {
            "title": "Order of the results",
            "enum": [
              "relevance",
              "newest"
            ],
            "type": "string",
            "description": "Internshala's own order, or newest first (rows are then delivered at the end of the run, sorted by posting date).",
            "default": "relevance"
          },
          "includeDetails": {
            "title": "Full details",
            "type": "boolean",
            "description": "Read each listing's own page: full description, start date, apply-by date, applicants, openings, every skill, perks, who can apply, other requirements, salary breakup and probation (jobs), job-offer details, company website and about text, employer activity (hiring since, opportunities posted, candidates hired), industry, region. Charged as the 'Listing details' add-on per row; off = the search card's fields only.",
            "default": true
          },
          "includeCompanyProfile": {
            "title": "Company profile (free)",
            "type": "boolean",
            "description": "Add the employer's Internshala company page to every row: employee count, industry, location, hiring since, opportunities posted, candidates hired, about, website, salaries the employer has offered, perks. Read once per employer per run.",
            "default": false
          },
          "enrichEmails": {
            "title": "Employer email",
            "type": "boolean",
            "description": "Look up a contact email on the employer's own website (the website Internshala publishes on the listing; never a social page): home page plus up to 3 contact / about pages, an address on the employer's own domain first. Charged once per employer with an email found; no email, no charge.",
            "default": false
          },
          "includeSearchReport": {
            "title": "Search report (free)",
            "type": "boolean",
            "description": "Write a SEARCH_REPORT record to the run's key-value store with, per search: stipend and salary ranges (min, quartiles, max), unpaid / work-from-home / part-time shares, durations, top skills, companies, cities and perks, posting freshness, applicant counts and total openings.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "all",
              "text",
              "html",
              "markdown",
              "none"
            ],
            "type": "string",
            "description": "Which description fields to fill: text, HTML, Markdown, all three, or none.",
            "default": "all"
          },
          "descriptionMaxLength": {
            "title": "Cut descriptions at",
            "minimum": 0,
            "type": "integer",
            "description": "Characters; 0 = no limit.",
            "default": 0
          },
          "compact": {
            "title": "Compact rows",
            "type": "boolean",
            "description": "Only the core fields (id, type, title, company, location, work mode, pay, duration or experience, skills, apply-by, applicants, openings, dates, link) - small rows for AI agents and spreadsheets.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "Drop fields that are empty for a row instead of writing null.",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode (only new listings)",
            "type": "boolean",
            "description": "Remember every listing delivered (in a named key-value store in your account) and deliver only listings not delivered before. Run it on a schedule for a daily feed; an empty poll costs a few list pages and is never charged.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Name of the key-value store that holds the monitor memory. Use a different name per feed.",
            "default": "internshala-monitor"
          },
          "monitorIncludeUpdated": {
            "title": "Also deliver changed listings",
            "type": "boolean",
            "description": "Deliver a known listing again (changeType 'updated') when its pay, location, duration, openings, apply-by date or description changed, or when its applicants rose by the surge percent below.",
            "default": false
          },
          "applicantSurgePercent": {
            "title": "Applicant surge (%)",
            "minimum": 0,
            "type": "integer",
            "description": "With changed listings on and full details on: deliver a known listing again when its applicant count rose by at least this percent since the last run (applicantCountPrevious / applicantCountDelta are filled). 0 = off.",
            "default": 0
          },
          "monitorRecheckHours": {
            "title": "Re-read known listings every (hours)",
            "minimum": 0,
            "type": "integer",
            "description": "With changed listings on: a remembered listing's own page is read again for applicant and content changes at most this often. A listing whose search card changed is re-read at once. Lower = fresher applicant counts, higher = cheaper polls.",
            "default": 6
          },
          "emitUnchanged": {
            "title": "Also deliver unchanged listings",
            "type": "boolean",
            "description": "Deliver every listing with its changeType (new / updated / unchanged).",
            "default": false
          },
          "emitRemovedListings": {
            "title": "Also deliver removed listings",
            "type": "boolean",
            "description": "After a complete read of every search, deliver one row (changeType 'removed') for each remembered listing that is no longer on Internshala.",
            "default": false
          },
          "monitorStopAfterKnownPages": {
            "title": "Stop after pages with nothing new",
            "minimum": 0,
            "type": "integer",
            "description": "A monitor poll stops reading a search after this many pages in a row with nothing new (Internshala lists the newest listings first). 0 = always read every page.",
            "default": 3
          },
          "skipReposts": {
            "title": "Skip reposts",
            "type": "boolean",
            "description": "Drop a listing that repeats one already delivered (same company, title and location under a new id). Off = delivered with isRepost true.",
            "default": false
          },
          "resetMonitor": {
            "title": "Start the monitor over",
            "type": "boolean",
            "description": "Forget every listing remembered under this monitor name before the run.",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST a JSON summary (count + the first rows) here after the run."
          },
          "webhookHeaders": {
            "title": "Webhook headers",
            "type": "object",
            "description": "Extra headers for the webhook, e.g. {\"Authorization\": \"Bearer ...\"}."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "A Slack incoming-webhook URL."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "A Discord channel webhook URL."
          },
          "telegramToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Your Telegram bot's token (with the chat id below)."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat that receives the alert."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp access token",
            "type": "string",
            "description": "WhatsApp Cloud API access token (Meta)."
          },
          "whatsappPhoneNumberId": {
            "title": "WhatsApp phone number id",
            "type": "string",
            "description": "The sender number id of your WhatsApp Cloud API app."
          },
          "whatsappTo": {
            "title": "WhatsApp recipient",
            "type": "string",
            "description": "The number that receives the alert, with country code."
          },
          "notificationLimit": {
            "title": "Listings per alert",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "How many listings each alert lists.",
            "default": 5
          },
          "notifyOnlyChanges": {
            "title": "Alert on new / changed only",
            "type": "boolean",
            "description": "With monitor mode: alert only about new and changed listings.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. By default the run reads Internshala directly and moves to Apify's datacenter proxy, then residential India, only if Internshala refuses it. Set your own proxy or an Apify proxy group here to start on it."
          },
          "maxConcurrency": {
            "title": "Pages read at once",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Listing pages read in parallel.",
            "default": 10
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}