API for job details

आपको एक विश्वसनीय स्रोत से पूर्ण नौकरी विवरण (शीर्षक, नियोक्ता, विवरण, आवेदन लिंक, और वेतन संदर्भ) प्रोग्रामेटिक रूप से प्राप्त करने की आवश्यकता है और इसे इस सप्ताह भेजना है। इस लेख के अंत तक, आप नौकरियों की खोज कर सकेंगे, एक नौकरी के विस्तृत प्रोफ़ाइल को ID द्वारा खींच सकेंगे, और Zyla API Hub के माध्यम से एकल कुंजी का उपयोग करके एक स्थान के चारों ओर अनुमानित वेतन प्राप्त कर सकेंगे।

इस API के साथ आप क्या बना सकते हैं

JSearch API वेब से नौकरियों को एकत्र करता है (जिसमें Google for Jobs शामिल है) और निम्नलिखित को उजागर करता है:

खोज: Google for Jobs पर उपलब्ध व्यापक फ़िल्टरिंग विकल्पों के साथ नौकरियों के लिए क्वेरी करें।
नौकरी विवरण: एक job_id को पूर्ण विवरण में विस्तारित करें, जिसमें अतिरिक्त आवेदन विकल्प, नियोक्ता समीक्षाओं का संदर्भ, और समान भूमिकाओं के लिए अनुमानित वेतन शामिल हैं।
अनुमानित वेतन: एक स्थान के चारों ओर नौकरी शीर्षक के लिए वेतन रेंज प्राप्त करें।

टीम इसका उपयोग नौकरी बोर्ड, भर्ती स्वचालन, आवेदक ट्रैकिंग एकीकरण, और आंतरिक स्रोत उपकरणों को शक्ति देने के लिए करती हैं।

Zyla API Hub पर शुरू करना

Zyla API Hub पर JSearch API पृष्ठ खोलें और सदस्यता लें। हब एक कोटा के साथ सदस्यता का उपयोग करता है (पे-पर-कॉल नहीं)। पहले एकीकरण के लिए, आप 7-दिन की परीक्षण अवधि या उपलब्धता के आधार पर 50 अनुरोधों के साथ शुरू कर सकते हैं। आपको एकल API कुंजी प्राप्त होगी जो इस और किसी अन्य API को कॉल करने के लिए अधिकृत करती है, जिस पर आप हब पर सदस्यता लेते हैं।

JSearch API पर 7-दिन की परीक्षण अवधि शुरू करें

प्रमाणीकरण

प्रत्येक अनुरोध के लिए Authorization हेडर में अपनी कुंजी भेजें:

Authorization: Bearer YOUR_API_KEY

एंडपॉइंट्स

1) खोज

वेब पर नौकरी साइटों पर पोस्ट की गई नौकरियों के लिए खोजें, जो दुनिया में सबसे बड़े नौकरी एग्रीगेटर (Google for Jobs) पर हैं। URL और विधि:

विधि: GET
URL: https://zylalabs.com/api/2526/jsearch-api/2516/search

आवश्यक क्वेरी पैरामीटर:

query (string): उदाहरण के लिए, “javascript developer”

cURL उदाहरण (कॉपी/पेस्ट):

curl -s -X GET "https://zylalabs.com/api/2526/jsearch-api/2516/search?query=javascript+developer" \
-H "Authorization: Bearer YOUR_API_KEY"

नमूना JSON प्रतिक्रिया:

{
"status": "OK",
"request_id": "9d5b1504-e1c0-43dc-ba08-7cd4ef1de4a6",
"parameters": {
"query": "javascript developer",
"page": 1,
"num_pages": 1,
"country": "us",
"language": "en"
},
"data": [
{
"job_id": "NWFBUzhCZkdmOVBVbVdKYUFBQUFBQT09OkVzc0JDb3dCUVVwcFZEUjBTMnBvWlhWUk1qUkdSRmx5TUVKNWNUSTBSRmhLTVZBdGRXeFRMVWd0ZUdwUmRtVnlNVXRYYUVOM2JIRk9jWE16ZUVka2F6a3dORmRWV2xVNFYzbHhSRGRaV1VrdE0wbFdkMHBIZGxoaU5UTkNUazVxUmpOUE5XVmlYM0E0ZEZWQk1sWnlRbWwwV2tSMGMxcE1RVTFEYUdoblVteGpTRUpXVGtjNVNtazFUMmhZUVc1R1dYb1NGbEo0TlRkaGRXbExRbEJEYTJ0UVNWQTVjVVJLU1ZFYUlrRkVjM0k1WmxJdFlsSkpkbVJRY204MFV6UTVjSEJTTkhCcmJXd3lRbU41YkVF",
"job_title": "Full Stack JavaScript Developer - Top Secret Clearance",
"employer_name": "Metric5",
"employer_logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTpqtlYyQWQ7NZ_F3cBFi24PFec2gdiTaCd_CJ&s=0",
"employer_website": "https://www.metric5.com",
"job_publisher": "LinkedIn",
"job_employment_type": "Full-time",
"job_employment_types": [
"FULLTIME"
],
"job_apply_link": "https://www.linkedin.com/jobs/view/full-stack-javascript-developer-top-secret-clearance-at-metric5-4447358729",
"job_apply_is_direct": false,
"apply_options": [
{
"apply_link": "https://www.linkedin.com/jobs/view/full-stack-javascript-developer-top-secret-clearance-at-metric5-4447358729",
"is_direct": false,
"publisher": "LinkedIn"
}
],
"job_description": "Location: Springfield, VA - onsite

Metric5 is looking for a motivated Full Stack JavaScript Developer for work on a highly visible project for our NGA/DoD customer.

The ideal Full Stack JavaScript Developer has hands-on experience working in a true Agile environment performing software engineering tasks across multiple teams, with expertise spanning front-end and back-end development. Our software engineers serve in critical roles to design, build, test, and maintain software products to ensure strong functionality and optimization.

As a software engineer at Metric5, you will be responsible for the technical design, development, documentation, and engineering of software solutions using React, NestJS, Node.js, TypeScript, and Vite within a modern cloud-native ecosystem. Your resp…

क्या उपयोग करें:

data[].job_id: इसे नौकरी विवरण में पास करें ताकि एक लिस्टिंग का विस्तार किया जा सके।
data[].job_title, employer_name: इसे अपनी UI सूची में दिखाएं।
data[].job_apply_link और apply_options: “आवेदन करें” बटन बनाएं।
parameters: लॉगिंग और पृष्ठांकन लॉजिक के लिए उपयोगी जहां लागू हो।

Python उदाहरण खोज के लिए

यह स्निपेट “javascript developer” के लिए खोज करता है और परिणाम पृष्ठ में दिखाए जाने वाले प्रमुख क्षेत्रों को प्रिंट करता है, फिर विवरण के लिए एक job_id कैप्चर करता है।

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/2526/jsearch-api/2516/search"

headers = {
"Authorization": f"Bearer {API_KEY}"
}

params = {
"query": "javascript developer"
}

resp = requests.get(BASE_URL, headers=headers, params=params, timeout=30)
resp.raise_for_status()
payload = resp.json()

print("Status:", payload.get("status"))
for i, job in enumerate(payload.get("data", []), start=1):
print(f"{i}. {job.get('job_title')} — {job.get('employer_name')}")
print(" Apply:", job.get("job_apply_link"))
print(" Publisher:", job.get("job_publisher"))
print()

# Capture a job_id to fetch details later
first_job_id = payload.get("data", [{}])[0].get("job_id")
print("First job_id for details:", first_job_id)

2) नौकरी विवरण

सभी नौकरी विवरण प्राप्त करें, जिसमें अतिरिक्त आवेदन विकल्प/लिंक, नियोक्ता समीक्षाओं का संदर्भ, और समान नौकरियों के लिए अनुमानित वेतन शामिल हैं।

विधि: GET
URL: https://zylalabs.com/api/2526/jsearch-api/2517/job-details

आवश्यक क्वेरी पैरामीटर:

job_id (string)

cURL उदाहरण:

नमूना JSON प्रतिक्रिया अंश:

क्या उपयोग करें:

data[].job_uid और data[].job_id: डुप्लीकेशन और भंडारण के लिए स्थिर पहचानकर्ता।
पूर्ण विवरण और अतिरिक्त आवेदन विकल्प आपके विवरण पृष्ठ को प्रस्तुत करने के लिए।

3) अनुमानित वेतन

एक स्थान के चारों ओर नौकरी के लिए अनुमानित वेतन प्राप्त करें।

विधि: GET
URL: https://zylalabs.com/api/2526/jsearch-api/2518/estimated-salary

पैरामीटर:

job_title (string, आवश्यक)
location (string, आवश्यक)
radius (string, वैकल्पिक)

cURL उदाहरण:

नमूना JSON प्रतिक्रिया:

क्या उपयोग करें:

median_salary: कंप बैंड के लिए त्वरित बेंचमार्क।
salary_period और salary_currency: सही इकाइयाँ दिखाएं (इस उदाहरण में वार्षिक USD)।
salaries_updated_at: टाइमस्टैम्प जिसे आप प्रदर्शित कर सकते हैं या कैश अमान्यकरण के लिए उपयोग कर सकते हैं। टाइमस्टैम्प ISO 8601 है।

एंड-टू-एंड प्रवाह: खोज से विवरण तक वेतन

नौकरियों और job_id मानों की सूची प्राप्त करने के लिए टेक्स्ट क्वेरी के साथ खोज कॉल करें।
एक job_id चुनें और अपने विवरण पृष्ठ को पूर्ण सामग्री और आवेदन विकल्पों के साथ समृद्ध करने के लिए नौकरी विवरण कॉल करें।
वैकल्पिक रूप से भूमिका और स्थान के लिए अनुमानित वेतन कॉल करें जिसे उपयोगकर्ता देख रहा है ताकि कंप संदर्भ जोड़ा जा सके।

डुप्लिकेट से बचने के लिए job_id और job_uid को स्टोर करें। खोज प्रतिक्रिया में एक “parameters” ब्लॉक शामिल है जिसे आप क्वेरी संदर्भ को ट्रेस करने के लिए लॉग कर सकते हैं। पुनरावृत्तियों पर एक्सपोनेंशियल बैकऑफ लागू करें।

व्यावहारिक कार्यान्वयन नोट्स

Authorization: हमेशा “Authorization: Bearer YOUR_API_KEY”।
इकाइयाँ और मुद्रा: अनुमानित वेतन वेतन_period (जैसे, YEAR) और वेतन_currency (जैसे, USD) लौटाता है। दोनों को राशियों के साथ प्रदर्शित करें।
टाइमस्टैम्प: salaries_updated_at ISO 8601 है; यदि आवश्यक हो तो अपने UI में स्थानीय प्रदर्शन प्रारूप में परिवर्तित करें।
कोटा मॉडल: Zyla सदस्यता + कोटा का उपयोग करता है, पे-पर-कॉल नहीं। पहले उपयोग के लिए, 7-दिन की परीक्षण अवधि या 50 अनुरोधों की अपेक्षा करें। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
पृष्ठांकन और फ़िल्टरिंग: खोज उदाहरण प्रतिक्रिया में पृष्ठ और num_pages शामिल हैं; Google for Jobs पर समर्थित अतिरिक्त फ़िल्टरिंग विकल्पों के लिए API पृष्ठ का पालन करें।
त्रुटि हैंडलिंग: स्थिति और HTTP कोड की जांच करें; समर्थन के साथ मुद्दों को सहसंबंधित करने के लिए request_id को लॉग करें।

AI एजेंटों के माध्यम से API को कॉल करना MCP

Zyla पर हर API को AI एजेंटों और IDE सहायक उपकरणों से भी कॉल किया जा सकता है जो मॉडल संदर्भ प्रोटोकॉल (MCP) का समर्थन करते हैं। अपने क्लाइंट को इस पर इंगित करें:

https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

एक बार कनेक्ट होने पर, Claude Code, Cursor, और Windsurf जैसे उपकरण आपके समान कुंजी का उपयोग करके JSearch API को कॉल कर सकते हैं। क्लाइंट सेटअप विवरण के लिए, MCP एंडपॉइंट जानकारी देखें।

वास्तविक दुनिया के उपयोग के मामले

नौकरी बोर्ड खोज: खोज को कॉल करके “JavaScript Developer” फ़ीड लागू करें और job_title, employer_name, और job_apply_link को प्रस्तुत करें।
ATS समृद्धि: एक स्क्रैप की गई नौकरी लिंक के साथ, भूमिका की कीवर्ड द्वारा खोजें, फिर फ़ील्ड को सामान्य करने और डुप्लिकेट के लिए job_uid को स्टोर करने के लिए नौकरी विवरण कॉल करें।
कंप बैंड: आवेदन CTA के बगल में अपेक्षाएँ सेट करने के लिए job_title और उपयोगकर्ता-चुने गए शहर द्वारा अनुमानित वेतन कॉल करें।
अलर्ट और डाइजेस्ट: अनुसूचित खोज क्वेरी चलाएँ और नौकरी_apply_link और employer_website के साथ व्यक्तिगत ईमेल डाइजेस्ट भेजें।

उत्पादन चेकलिस्ट

API कुंजी को सुरक्षित रूप से स्टोर करें; इसे कभी भी स्रोत नियंत्रण में न डालें।
पर्यवेक्षण और ऑडिट के लिए request_id और parameters को लॉग करें।
सदस्यता कोटा का सम्मान करें; पुनरावृत्तियों पर एक्सपोनेंशियल बैकऑफ लागू करें।
(job_title, location, radius) के लिए अनुमानित वेतन प्रतिक्रियाओं को कुछ घंटों के लिए कैश करें।
नियोक्ता नामों को सामान्य करें और डुप्लिकेट को रोकने के लिए job_uid को बनाए रखें।

अक्सर पूछे जाने वाले प्रश्न

मैं नौकरी विवरण को कॉल करने के लिए job_id कैसे प्राप्त करूँ?
पहले खोज एंडपॉइंट का उपयोग करें। data[] में प्रत्येक आइटम में एक job_id शामिल है जिसे आप नौकरी विवरण को पास कर सकते हैं।

क्या मैं क्वेरी स्ट्रिंग के परे खोज को फ़िल्टर कर सकता हूँ?
खोज एंडपॉइंट Google for Jobs के समान व्यापक फ़िल्टरिंग का समर्थन करता है। समर्थित पैरामीटर के पूर्ण सेट के लिए Zyla पर API पृष्ठ देखें।

सैलरी किस मुद्रा और इकाइयों का उपयोग करती है?
अनुमानित वेतन प्रति रिकॉर्ड salary_currency और salary_period लौटाता है। ऊपर दिए गए उदाहरण में, मान वार्षिक USD हैं।

क्या कोई मुफ्त योजना है?
नहीं। Zyla सदस्यता + कोटा का उपयोग करता है। वर्तमान पहुंच विकल्पों के लिए API पृष्ठ की जांच करें। पहले उपयोग के लिए, आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं।

क्या मैं इन एंडपॉइंट्स को IDE एजेंट से कॉल कर सकता हूँ?
हाँ। अपने IDE या एजेंट के साथ MCP एंडपॉइंट का उपयोग करें जो MCP का समर्थन करता है: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY।

क्या आप अपने एकीकरण को भेजने के लिए तैयार हैं? सदस्यता लें और JSearch API पृष्ठ पर अपनी API कुंजी प्राप्त करें, फिर अपने नौकरी फ़ीड और विवरण पृष्ठों को शक्ति देने के लिए खोज, नौकरी विवरण, और अनुमानित वेतन एंडपॉइंट्स को प्लग करें। JSearch API पर 7-दिन की परीक्षण अवधि शुरू करें