# Naukri API for agents

> API for Agents · https://apiforagents.dev/platforms/naukri · HTML twin: https://apiforagents.dev/platforms/naukri

Job search from Naukri with the board's own filters.

Endpoint: `POST https://apiforagents.dev/v1/naukri`. One op per call. Quote first with `"estimateOnly": true`.

## Prices (USD per record, pay as you go)

| Record | Per record |
|---|---|
| job | $0.0018 |

## Operations

### search

Search Naukri. A keyword (or a pasted Naukri search URL) with the board's own filters. Coded filters (department, roleCategory, industry, companyType, topCompanies, ugCourse, pgCourse) take Naukri's numeric ids, as the site's URLs carry them.

| Field | Required | Type | Meaning |
|---|---|---|---|
| query | yes | string (≤300 chars) | A keyword, or a pasted Naukri search URL. |
| postedWithin | no | enum |  Values: 1d, 3d, 7d, 15d, 30d, any. |
| sort | no | enum |  Values: relevance, newest. |
| experience | no | string (pattern `^(all|[0-9]|1[0-9]|2[0-3])$`) | Years of experience, "all" or "0".."23". |
| workplace | no | list of enum |  Values: onsite, remote, hybrid, temporary_wfh. |
| salaryMin | no | integer (0-1000) | Lakhs per annum; mapped onto Naukri's salary bands. |
| salaryMax | no | integer (0-1000) | Upper bound in lakhs per annum; with salaryMin, the bands that overlap the range are searched. |
| locations | no | list of string (each ≤60 chars) |  |
| department | no | list of string (each ≤20 chars) | Naukri's own department codes (the numbers in its filter URLs, e.g. "5" for Engineering). Any of them matches. Empty = every department. |
| roleCategory | no | list of string (each ≤20 chars) | Naukri's role-category codes, narrower than a department. Empty = all. |
| industry | no | list of string (each ≤20 chars) | Naukri's industry codes. Empty = every industry. |
| companyType | no | list of string (each ≤20 chars) | Naukri's company-type codes (corporate, startup, MNC…). Empty = all. |
| topCompanies | no | list of string (each ≤20 chars) | Naukri's top-company group codes, to keep only well-known employers. Empty = all companies. |
| postedBy | no | list of enum | Who posted the job: the company itself, a consultant, or both when empty. Values: company, consultant. |
| ugCourse | no | list of string (each ≤20 chars) | Naukri's undergraduate-degree codes the posting asks for. Empty = any. |
| pgCourse | no | list of string (each ≤20 chars) | Naukri's postgraduate-degree codes the posting asks for. Empty = any. |
| fetchDetails | no | boolean | Pull each posting's full description and requirements. Slower. |
| limit | no | integer (50-200) |  |

Response fields (each row of data; every field present, null when the source had nothing):

| Field | Type |
|---|---|
| jobId | string |
| jobUrl | string |
| applyUrl | string |
| jobTitle | string |
| company | string |
| companyId | string |
| companyDetails | any |
| hiringFor | string |
| location | string |
| description | string |
| requirementsSummary | string |
| skills | string |
| role | string |
| roleCategory | string |
| department | string |
| industry | string |
| jobType | string |
| workplaceType | string |
| hybridDetail | string |
| minExperienceYrs | integer |
| maxExperienceYrs | integer |
| salaryMin | number |
| salaryMax | number |
| benchmarkMinCtcLakhs | number |
| benchmarkAvgCtcLakhs | number |
| benchmarkMaxCtcLakhs | number |
| benchmarkRole | string |
| benchmarkSalariesUrl | string |
| educationUg | string |
| educationPg | string |
| posted | string |
| applicants | integer |
| views | integer |
| vacancies | integer |
| appliesOnCompanySite | boolean |
| postedByConsultant | boolean |
| listingSource | string |
| referenceCode | string |
| hasQuestionnaire | boolean |
| walkInJob | boolean |
| walkInStart | string |
| walkInEnd | string |
| walkInVenue | string |
| walkInTiming | string |
| walkInContact | string |
| walkInPhone | string |
| internshipDuration | string |
| diversityTags | string |
| benefits | string |
| employeeReviews | any |
| details | object |

`details` is always the last field: everything else the source sent for that row, under our own field names. Its keys depend on the source that answered, so read them defensively; it is `{}` when there is nothing more.

Example request:

```bash
curl -X POST https://apiforagents.dev/v1/naukri \
  -H "Authorization: Bearer $AFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"search","query":"data scientist","postedWithin":"7d","experience":"3","locations":["Bengaluru"],"limit":50}'
```

Example response rows (real rows, business data; a live row carries every field above):

```json
[
  {
    "jobId": "060926000168",
    "jobUrl": "https://www.naukri.com/job-listings-artificial-intelligence-engineer-bangalore-ai-ml-data-science-shadowfax-technologies-bengaluru-1-to-6-years-060926000168",
    "jobTitle": "Artificial Intelligence Engineer-Bangalore (AI/ ML/ Data Science)",
    "company": "Shadowfax Technologies",
    "companyId": "2449574",
    "companyDetails": {
      "hq": "Bengaluru, India",
      "logo": "https://img.naukimg.com/logo_images/groups/v1/4625023.gif",
      "name": "Shadowfax Technologies",
      "about": "Shadowfax is Indias leading on-demand tech-backed gig marketplace that helps businessesoutsource last mile activities. Shadowfax employs tech-enabled solutions like ML and AI to offersupply that keeps pace with demand in the fast-growing and highly fragmented hyperlocaldistribution ecosystem and ensures a wonderful end-user experience.The Shadowfax app has over two million downloads, and is designed as an immersive platform fordelivery and is a single app that works across multiple platforms. The app is used as a channel forguaranteed earnings across multiple E-com and Hyperlocal platforms. Shadowfax has beenconsistently widening its area of operations by expanding in E-commerce and Hyperlocalsegments and getting into new growth areas like grocery distribution.Shadowfax has extremely friendly people and partnership policies that are designed to be highlyempathetic and are always looking for ways to make the riders lives better, and transform theappeal of delivery and other blue-collar jobs as an attractive career option. Working with theShadowfax platform ensures strong earning potential along with a high degree of flexibility andfreedom along with financial support services like loans, and insurance.In October 2021, Shadowfax launched Indias first delivery SuperApp to accelerate the growth ofdeliverypartners by empowering them to access multiple opportunities via a single platform.Shadowfax was co-founded by Abhishek Bansal, Gaurav Jaithliya, Praharsh Chandra, andVaibhav Khandelwal in 2015. Over the last seven years, it has now grown to a team size of closeto 5000 employeeswith 1.25 Lakhs+daily active users (delivery partners) in more than 1100+ citiesin India, fulfilling 20 millionorders per month across 100+ leading brands in 9500+ pin codesOur clients are present across sectors like e-commerce, food, grocery, FMCG,lectronics,consumer durables, pharma, apparel, auto, BFSI and Insurance etc.We foster a culture that values first principle thinking and problem solving, encouragesconstructive feedback, engagement, inclusion and diversity at all levels. Our core values defineour identity and form the basis of our actions and reflect in everything that we do at Shadowfax.",
      "rating": 3.5,
      "address": "77/A,3RD FLOOR,CYGNUS CHAMBERS,JYOTHI NIVAS COLLEG  , BANGALORE, Karnataka, India",
      "jobsUrl": "https://www.naukri.com/shadowfax-technologies-jobs-careers-1836376",
      "website": "https://www.shadowfax.in",
      "reviewsUrl": "https://www.ambitionbox.com/reviews/shadowfax-technologies-reviews",
      "reviewCount": 2157,
      "naukriFollowers": 105189
    },
    "location": "Bengaluru",
    "description": "Artificial Intelligence Engineer  AI/ML Location: Bengaluru, KarnatakaWork Mode: Full-time, On-siteExperience: 1+ yearsJoining: Immediate joiners preferredRole OverviewWe are looking for an Artificial Intelligence Engineer with 1+ years of experience in AI/ML, Data Science, AI tools, and software development frameworks to join our team in Bengaluru.The ideal candidate should have hands-on experience with Python, SQL, Excel, AI tools, and data analytics, along with an understanding of either frontend or backend development frameworks. The candidate will work on AI-driven business and analytics projects across Supply Chain Management (SCM), Quick Commerce, Logistics, and Network Planning.This role requires someone who can combine technical AI/ML capabilities with business understanding, analyze large datasets, develop analytical solutions, prepare management reports, and translate business problems into technology-driven solutions.Key ResponsibilitiesDevelop and implement AI/ML and data science solutions for real-world business and operational problems.Work on AI-driven use cases across SCM, logistics, quick commerce, network planning, and supply chain analytics.Analyze structured and unstructured data using Python and SQL.Build data pipelines, analytical models, and automation solutions to support business decision-making.Use AI/GenAI tools to improve data analysis, reporting, automation, research, and operational productivity.Develop predictive and analytical models for areas such as demand, capacity, network optimization, manpower, inventory, delivery, and operational performance.Work with frontend or backend frameworks to integrate AI/analytics solutions into business applications.Develop APIs, backend services, dashboards, or analytical interfaces as required.Extract, transform, validate, and analyze data from multiple sources.Prepare MIS reports, analytical reports, dashboards, and management presentations.Build automated reporting solutions using Python, SQL, Excel, and Power BI or similar tools.Perform exploratory data analysis and identify trends, patterns, anomalies, and business opportunities.Collaborate with business, operations, finance, SCM, and technology teams to understand requirements and deliver analytical solutions.Convert business requirements into data-driven and AI-enabled solutions.Conduct model performance analysis and continuously improve analytical solutions.Document methodologies, models, processes, and business insights.Support rapid prototyping and Proof of Concepts (PoCs) using emerging AI technologies.Key Project AreasThe candidate will have the opportunity to work on projects involving:Supply Chain Management (SCM)Supply chain analyticsDemand and capacity planningInventory analyticsSupply-demand matchingOperational optimizationQuick CommerceDark-store / fulfillment analyticsDemand forecastingDelivery and capacity optimizationOrder and customer analyticsInventory and availability analyticsLogisticsRoute and delivery analyticsNetwork optimizationShipment analyticsTransportation planningCost and productivity analyticsNetwork PlanningNetwork design and optimizationCapacity planningLocation and hub analysisNetwork cost optimizationDemand and capacity modelingTechnical SkillsMust HavePython – strong programming and data-analysis skills.SQL – strong understanding of queries, joins, aggregations, CTEs, subqueries, and data manipulation.Practical knowledge of AI/ML and Data Science concepts.Hands-on experience using AI/GenAI tools for analysis, coding, automation, research, or productivity.Strong Excel skills, including Pivot Tables, lookup functions, data analysis, and reporting.Good understanding of data cleaning, transformation, visualization, and exploratory data analysis.Experience in preparing reports, dashboards, and management insights.Frontend / BackendExperience with at least one frontend or backend technology/framework is preferred:FastAPI / Flask / DjangoNode.jsReact / AngularREST APIsBackend application developmentWeb application integrationKnowledge of integrating AI/ML models with applications or APIs will be an advantage.AI / ML SkillsExposure to one or more of the following will be preferred:Machine LearningGenerative AILarge Language Models (LLMs)Prompt EngineeringAI AgentsRAG-based applicationsNLPPredictive AnalyticsRecommendation systemsForecastingOptimization algorithmsModel deployment and APIsAI-assisted automationExperience with tools such as ChatGPT, GitHub Copilot, Gemini, Claude, or similar AI productivity/development tools is desirable.Good to HavePower BI or Tableau.Pandas, NumPy, Scikit-learn.Git/GitHub.Cloud platforms such as AWS, Azure, or GCP.Basic understanding of Docker and APIs.Exposure to optimization, forecasting, or operations research.Experience with SCM, logistics, quick commerce, e-commerce, transportation, or network planning.Understanding of business KPIs and operational metrics.Ideal Candidate ProfileWe are looking for a candidate who:Has a strong problem-solving and analytical mindset.Can understand a business problem and translate it into a data/AI solution.Has good pedagogy and communication skills and can explain technical concepts clearly to business stakeholders.Is comfortable working with both technology and business teams.Can independently analyze data and present actionable insights.Is curious about emerging AI technologies and tools and actively experiments with new solutions.Has strong attention to detail and ownership of deliverables.Can work in a fast-paced environment with multiple projects and stakeholders.Is comfortable preparing reports and presenting findings to management.Is a quick learner and hands-on problem solver.Education & ExperienceBachelor's/Master's degree in Computer Science, Information Technology, Engineering, Data Science, Artificial Intelligence, Statistics, Mathematics, or a related discipline.1+ years of relevant experience in AI/ML, Data Science, Analytics, Software Development, or AI Engineering.Candidates with project experience in SCM, logistics, quick commerce, e-commerce, transportation, or network planning will have an added advantage.Immediate joiners or candidates with a short notice period are strongly preferred.Key Skills good to have.Artificial Intelligence | Machine Learning | Data Science | Generative AI | Python | SQL | Excel | AI Tools | Frontend | Backend | APIs | FastAPI | Flask | Data Analytics | Power BI | Supply Chain | SCM | Quick Commerce | Logistics | Network Planning | Forecasting | Optimization | Automation | Reporting | Business Analytics",
    "requirementsSummary": "1+ years experience in AI/ML, Data Science with strong Python, SQL, AI/GenAI tools skills and knowledge of frontend/backend frameworks|Develop AI/ML solutions for SCM, logistics, quick commerce, and network planning; analyze data; build models, pipelines, and dashboards; integrate AI with applications; prepare reports and presentations",
    "skills": "Predictive Modeling, Artificial Intelligence, Machine Learning, Python, Data Science, Advanced Analytics, Natural Language Processing, Statistical Modeling, Deep Learning, SQL",
    "role": "Data Scientist",
    "roleCategory": "Data Science & Machine Learning",
    "department": "Data Science & Analytics",
    "industry": "Courier / Logistics (Logistics Tech)",
    "jobType": "Full Time",
    "workplaceType": null,
    "minExperienceYrs": 1,
    "maxExperienceYrs": 6,
    "salaryMin": null,
    "salaryMax": null,
    "benchmarkSalariesUrl": "https://www.ambitionbox.com/salaries/shadowfax-technologies-salaries",
    "educationUg": "Any Graduate",
    "posted": "2026-09-05T20:01:45+00:00",
    "applicants": 1103,
    "views": 1347,
    "vacancies": 2,
    "postedByConsultant": false,
    "listingSource": "jp",
    "walkInJob": false,
    "benefits": "Learning & Development Support, Health & Wellness Support, Transport / Travel Support, Free Meal, Performance Bonus, Relocation Assistance",
    "employeeReviews": [
      {
        "url": "https://www.ambitionbox.com/reviews/shadowfax-technologies-reviews?rid=80713252&utm_source=naukri&utm_campaign=jd_reviews",
        "date": "12 Aug 2026",
        "likes": "Salary step and work time soo good",
        "title": "Calling Agent in Jaipur",
        "rating": "5",
        "dislikes": null
      },
      {
        "url": "https://www.ambitionbox.com/reviews/shadowfax-technologies-reviews?rid=80669235&utm_source=naukri&utm_campaign=jd_reviews",
        "date": "09 Aug 2026",
        "likes": "Working experience is cool not di",
        "title": "Accountant&dataentryoperator in Prayagraj",
        "rating": "4",
        "dislikes": null
      },
      {
        "url": "https://www.ambitionbox.com/reviews/shadowfax-technologies-reviews?rid=80657456&utm_source=naukri&utm_campaign=jd_reviews",
        "date": "08 Aug 2026",
        "likes": "Very good i like you shadowfax",
        "title": "Logistics Manager in New Delhi",
        "rating": "5",
        "dislikes": null
      }
    ],
    "details": {}
  },
  {
    "jobId": "050926015054",
    "jobUrl": "https://www.naukri.com/job-listings-software-developer-pragmatechnology-bengaluru-0-to-5-years-050926015054",
    "jobTitle": "Software Developer",
    "company": "Pragmatechnology",
    "companyId": "125779112",
    "companyDetails": {
      "hq": null,
      "logo": "https://img.naukimg.com/logo_images/groups/v1/12489238.gif",
      "name": "Pragmatechnology",
      "about": "We are a tech based startup working from the middle east, We have a large number of remote workers working from India. We are in the pre-seed round and are looking to raise funds by March and want someone to work on the brand image of the company before then.",
      "rating": null,
      "address": "Anand Vihar T C Road Kuthuparamba Kannur Thalassery Kuthuparamba KANNUR Kerala India 670643, KANNUR, Kerala, India",
      "jobsUrl": "https://www.naukri.com/pragmatechnology-jobs-careers-125779112",
      "website": null,
      "reviewsUrl": null,
      "reviewCount": null,
      "naukriFollowers": null
    },
    "location": "Bengaluru",
    "description": "* We're Hiring: Senior Tech Developer (JS/Node/Native)**Are you a passionate full-stack developer ready to make an impact? We're looking for a **Senior Tech Developer** to join our growing team based in India!**About The Role:**We're seeking an experienced developer who excels across our tech stack  building robust backend services, scalable applications, and native mobile experiences. This is a hands-on role where you'll take ownership of technical decisions, mentor junior developers, and directly influence our product direction.**What We're Looking For:** Strong expertise in **JavaScript & Node.js** - comfortable building and optimizing server-side applications Proven experience with **React Native** or native mobile development (iOS/Android) Ability to architect scalable solutions across frontend and backend Experience mentoring team members and leading technical projects Strong understanding of databases, APIs, and system design Problem-solving mindset with attention to code quality and best practices Collaborative spirit and excellent communication skills**Experience & Compensation:** **1-3 years experience:** 60,000/month **3-5 years experience:** Up to 1,00,000/monthCompensation is based on your experience level, portfolio, and demonstrated expertise.**Why Join Us?** Competitive salary aligned with market standards Work on full-stack projects (backend + mobile) Growth and learning opportunities Collaborative, tech-forward environment Opportunity to make an immediate impact**Interested?**Comlete this test https://www.pragmatechnology.in/apply/poisoned#Hiring #JavaScript #NodeJS #ReactNative #TechJobs #SeniorDeveloper #India #FullStack",
    "requirementsSummary": "Expertise in JavaScript, Node.js, and React Native with 1-5 years experience|Build scalable backend services and native mobile apps, mentor juniors, lead technical projects|Salary ₹60,000-₹1,00,000/month based on experience",
    "skills": "ERP, Openerp, ERP Implementation, SAP ERP Implementation",
    "role": "ERP Developer",
    "roleCategory": "Software Development",
    "department": "Engineering - Software & QA",
    "industry": "Emerging Technologies (AI/ML)",
    "jobType": "Full Time",
    "workplaceType": "Remote",
    "minExperienceYrs": 0,
    "maxExperienceYrs": 5,
    "salaryMin": null,
    "salaryMax": null,
    "benchmarkSalariesUrl": null,
    "educationUg": "Any Graduate",
    "posted": "2026-09-05T15:54:00+00:00",
    "applicants": 2395,
    "views": 2803,
    "vacancies": 1,
    "postedByConsultant": false,
    "listingSource": "jp",
    "walkInJob": false,
    "benefits": null,
    "employeeReviews": null,
    "details": {}
  }
]
```

Try it in the playground: https://apiforagents.dev/dashboard/run?platform=naukri&op=search (sign in first).

### history (free)

Stored applicant/view series of postings already held. Free.

| Field | Required | Type | Meaning |
|---|---|---|---|
| subjects | yes | list of string (1-10 items) |  |
| metric | no | enum |  Values: applicants, views, vacancies. |
| days | no | integer (1-730) |  |

Request shape:

```json
{
  "op": "history",
  "subjects": [
    "example"
  ]
}
```

Try it in the playground: https://apiforagents.dev/dashboard/run?platform=naukri&op=history (sign in first).

## Notes for the agent

Measured Naukri job data, one operation per call. ops: search (a keyword or a pasted Naukri search URL, with the board's own filters. PostedWithin, sort, experience, workplace, salaryMin/Max in lakhs, locations, and Naukri's coded department/role/industry/company filters; every hit a full posting with skills, experience band, salary or benchmark CTC, applicants and views, walk-in details, company profile; minimum 50 rows per search, which is what it bills), history (stored applicant/view series of postings already held, by job id or URL, free). Fresh fetches are charged per record; your own answer is free while fresh.
