xiaozhaobao.com.cn

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text keyword, Chinese or English. Matches company name, position title, industry and company aliases (e.g. \"腾讯\", \"算法工程师\", \"Tencent\", \"数据分析\"). Bilingual: searching \"Amazon\" also finds 亚马逊."
    },
    "city": {
      "type": "string",
      "description": "City, comma-separated for multiple (\"上海,杭州\"). Values are normalised (北京市→北京); province prefixes and range words like 全国/不限 are already stripped. Querying 北京 also matches postings listed as \"北京,上海\"."
    },
    "company": {
      "type": "string",
      "description": "Exact employer name. Prefer `q` for fuzzy discovery first, then narrow with this."
    },
    "industry": {
      "type": "string",
      "description": "Industry keyword, e.g. \"互联网\", \"金融\", \"制造业\", \"医药\". Fuzzy matched."
    },
    "batch": {
      "type": "string",
      "description": "Recruitment batch: \"校招\", \"秋招\", \"春招\", \"实习\", \"提前批\". Normalised to the site's canonical batch names and expanded to the raw values stored in the database. Use batch=\"实习\" to find internships."
    },
    "company_type": {
      "type": "string",
      "description": "Employer category, e.g. \"央企\", \"国企\", \"外企\", \"民企\", \"事业单位\"."
    },
    "education": {
      "type": "string",
      "description": "Education requirement keyword: \"本科\", \"硕士\", \"博士\", \"专科\"."
    },
    "grad_year": {
      "type": "string",
      "description": "Graduation year cohort, e.g. \"2027\"."
    },
    "days_left_max": {
      "type": "integer",
      "description": "Only postings whose application deadline is within N days from today (Beijing time). Use this for \"what is closing soon\". Combine with sort=\"deadline\"."
    },
    "sort": {
      "type": "string",
      "enum": [
        "latest",
        "deadline",
        "quality"
      ],
      "description": "Ordering: \"latest\" = newest published first (default), \"deadline\" = soonest application deadline first, \"quality\" = highest data-completeness first."
    },
    "limit": {
      "type": "number",
      "description": "Maximum postings to return, 1-20. Default 10. The full hit count is always reported."
    }
  },
  "required": []
}