LinkedIn Jobs API & Scraper
The LinkedIn Jobs API returns job postings, company and location data as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary jobs/search endpoint returns jobs with id, URL, title, company (name, URL, slug), location, workplace type, posted date, salary and seniority, and you can pull a jobs/detail, a company, jobs by company, similar jobs and a location search. It is built for recruiting tools, labor-market analysts and sales intelligence that need LinkedIn job data without a login or a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Search filters, their accepted values, and what a bad value does
Every filter below is an enum with a fixed vocabulary, and the two failure modes are not the same. keywords is validated and a missing or empty value is rejected outright. The filters are not: a value outside the list is silently ignored, so a typo in date_posted returns unfiltered results that look correct. Check the values here before you ship a query builder.
| Parameter | Accepted values | Bad value |
|---|---|---|
| keywords | free text (title, skill, keyword) — required | rejected |
| date_posted | 24h · week · month | ignored (query runs unfiltered) |
| experience | internship · entry · associate · mid_senior · director · executive | ignored |
| job_type | fulltime · parttime · contract · temporary · internship · volunteer · other | ignored |
| workplace | onsite · remote · hybrid | ignored |
| geoId | numeric LinkedIn id — get it from locations/search | ignored |
| company | company slug, full company URL, or numeric LinkedIn company id | ignored |
| max_results | 1–1000, default 50 | rejected |
1000 is LinkedIn's own ceiling for a single guest query, not a plan limit — past it the result set stops regardless of paging. To go deeper, split the query by location or date window rather than paging further.
Real request and response JSON
Captured from the indexed primary action, jobs/search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/linkedin-jobs/v1/jobs/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"keywords": "python developer",
"location": "United States",
"max_results": 25
}
}{
"ok": true,
"meta": {
"api": "linkedin-jobs",
"endpoint": "jobs/search",
"mode": "live",
"latency_ms": 2206.8,
"record_count": 25,
"bytes": 89495,
"cache_hit": false,
"completeness_pct": 100,
"stop_reason": "max_results",
"requests": 3,
"included_detail": false,
"included_company": false,
"pagination": {
"has_more": true,
"next_cursor": "25"
},
"charged_credits": 1,
"version": "1.2.0"
},
"data": {
"jobs": [
{
"job_id": "4431992044",
"job_url": "https://www.linkedin.com/jobs/view/python-developer-at-caci-international-inc-4431992044",
"title": "Python Developer",
"company": {
"name": "CACI International Inc",
"url": "https://www.linkedin.com/company/caci-international-inc",
"slug": "caci-international-inc",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQFob5rET4oo0w/company-logo_100_100/B4EZpUDHB_GYAQ-/0/1762346693140/caci_international_inc_logo?e=2147483647&v=beta&t=Re0dd7_XNTi2d3bgLF4IqHIOhyYkT1r-x_e8HWa-Nyc",
"specialties": []
},
"location": "Chantilly, VA",
"posted_date": "2026-07-08",
"posted_relative": "2 months ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4451909310",
"job_url": "https://www.linkedin.com/jobs/view/python-django-developer-at-tata-consultancy-services-4451909310",
"title": "Python Django Developer",
"company": {
"name": "Tata Consultancy Services",
"url": "https://in.linkedin.com/company/tata-consultancy-services",
"slug": "tata-consultancy-services",
"logo": "https://media.licdn.com/dms/image/v2/D4D0BAQGsGR9p4ikS5w/company-logo_100_100/company-logo_100_100/0/1708946550425/tata_consultancy_services_logo?e=2147483647&v=beta&t=P-PkUMh7Ks1GQY0_l7GhzQiwfyLfQpvKWwX8Tq18Yc4",
"specialties": []
},
"location": "Morrisville, NC",
"posted_date": "2026-09-02",
"posted_relative": "3 weeks ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4465604021",
"job_url": "https://www.linkedin.com/jobs/view/senior-software-engineer-python-at-venmo-4465604021",
"title": "Senior Software Engineer - Python",
"company": {
"name": "Venmo",
"url": "https://www.linkedin.com/company/venmo",
"slug": "venmo",
"logo": "https://media.licdn.com/dms/image/v2/C560BAQFqYO6c_JfA5A/company-logo_100_100/company-logo_100_100/0/1630671648627/venmo_logo?e=2147483647&v=beta&t=Fi0eAWLUnQZSiwbMnfpJ8zsELjGcPFfJpi38G0DEBK8",
"specialties": []
},
"location": "San Jose, CA",
"posted_date": "2026-09-10",
"posted_relative": "1 week ago",
"benefits": [],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4445043643",
"job_url": "https://www.linkedin.com/jobs/view/26-1106-python-developer-herndon-va-at-navitas-business-consulting-inc-4445043643",
"title": "26-1106: Python Developer - Herndon, VA",
"company": {
"name": "Navitas Business Consulting, Inc.",
"url": "https://www.linkedin.com/company/navitas-business-consulting-inc",
"slug": "navitas-business-consulting-inc",
"logo": "https://media.licdn.com/dms/image/v2/C4E0BAQHbPqemb2QlAQ/company-logo_100_100/company-logo_100_100/0/1674086101320/navitas_business_consulting_inc_logo?e=2147483647&v=beta&t=ITfvaVqNlITQGq8z5hWgWbaSMKv8HSd-QWjCZKOO5uE",
"specialties": []
},
"location": "Herndon, VA",
"posted_date": "2026-07-30",
"posted_relative": "1 month ago",
"benefits": [
"Be an early applicant",
"Be an early applicant"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4438331320",
"job_url": "https://www.linkedin.com/jobs/view/python-developer-at-ltm-4438331320",
"title": "Python Developer",
"company": {
"name": "LTM",
"url": "https://www.linkedin.com/company/ltm-larsenandtoubrocompany",
"slug": "ltm-larsenandtoubrocompany",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQEXsM6QSJEXuQ/company-logo_100_100/B4EZ8mSMqoJYAI-/0/1783053732738/ltm_larsenandtoubrocompany_logo?e=2147483647&v=beta&t=j72IUXCCuPmp2TMOMd73esNO0ZZy-imz4O9GOF5OCIA",
"specialties": []
},
"location": "Irving, TX",
"posted_date": "2026-09-01",
"posted_relative": "3 weeks ago",
"benefits": [],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4447143680",
"job_url": "https://www.linkedin.com/jobs/view/26-1106-python-developer-herndon-va-at-navitas-business-consulting-inc-4447143680",
"title": "26-1106: Python Developer - Herndon, VA",
"company": {
"name": "Navitas Business Consulting, Inc.",
"url": "https://www.linkedin.com/company/navitas-business-consulting-inc",
"slug": "navitas-business-consulting-inc",
"logo": "https://media.licdn.com/dms/image/v2/C4E0BAQHbPqemb2QlAQ/company-logo_100_100/company-logo_100_100/0/1674086101320/navitas_business_consulting_inc_logo?e=2147483647&v=beta&t=ITfvaVqNlITQGq8z5hWgWbaSMKv8HSd-QWjCZKOO5uE",
"specialties": []
},
"location": "Herndon, VA",
"posted_date": "2026-07-31",
"posted_relative": "1 month ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4457571716",
"job_url": "https://www.linkedin.com/jobs/view/python-engineer-and-developer-associate-at-icapital-4457571716",
"title": "Python Engineer and Developer - Associate",
"company": {
"name": "iCapital",
"url": "https://www.linkedin.com/company/icapital-network-inc",
"slug": "icapital-network-inc",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQGjxyjVIVoBTA/company-logo_100_100/B4EZuUZDJfGcAQ-/0/1767721153693/icapital_network_inc_logo?e=2147483647&v=beta&t=THaTijdVBUP579JsHlEktWSTLZ8Nlv1m0wbGGh3doj8",
"specialties": []
},
"location": "Stamford, CT",
"posted_date": "2026-09-12",
"posted_relative": "1 week ago",
"benefits": [],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4468673021",
"job_url": "https://www.linkedin.com/jobs/view/senior-lead-python-developer-at-srs-consulting-inc-4468673021",
"title": "Senior / Lead Python Developer",
"company": {
"name": "SRS Consulting Inc",
"url": "https://www.linkedin.com/company/srs-consulting-inc",
"slug": "srs-consulting-inc",
"logo": "https://media.licdn.com/dms/image/v2/D4D0BAQE4o8rD75-VtQ/company-logo_100_100/B4DaBmrOOsI8AI-/0/1788429001971/srs_consulting_inc_logo?e=2147483647&v=beta&t=k17Ug7bik6fZOnf01hBp3S87UWdR1KMxXJszl6FSiow",
"specialties": []
},
"location": "San Jose, CA",
"posted_date": "2026-09-22",
"posted_relative": "1 day ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4457648341",
"job_url": "https://www.linkedin.com/jobs/view/python-django-developer-at-tata-consultancy-services-4457648341",
"title": "Python Django Developer",
"company": {
"name": "Tata Consultancy Services",
"url": "https://in.linkedin.com/company/tata-consultancy-services",
"slug": "tata-consultancy-services",
"logo": "https://media.licdn.com/dms/image/v2/D4D0BAQGsGR9p4ikS5w/company-logo_100_100/company-logo_100_100/0/1708946550425/tata_consultancy_services_logo?e=2147483647&v=beta&t=P-PkUMh7Ks1GQY0_l7GhzQiwfyLfQpvKWwX8Tq18Yc4",
"specialties": []
},
"location": "San Jose, CA",
"posted_date": "2026-09-16",
"posted_relative": "1 week ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4312949783",
"job_url": "https://www.linkedin.com/jobs/view/senior-python-software-engineer-at-kommerce-hub-4312949783",
"title": "Senior Python Software Engineer",
"company": {
"name": "Kommerce Hub",
"url": "https://www.linkedin.com/company/kommercehubofficial",
"slug": "kommercehubofficial",
"logo": "https://media.licdn.com/dms/image/v2/C4D0BAQEG8H3o_ff06Q/company-logo_100_100/company-logo_100_100/0/1644518222146?e=2147483647&v=beta&t=d02yUBSLwzWJ5N_KUubrM9KmV6LDmYJaret-_F6L11E",
"specialties": []
},
"location": "Tampa, FL",
"posted_date": "2025-10-10",
"posted_relative": "11 months ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4465379983",
"job_url": "https://www.linkedin.com/jobs/view/senior-software-engineer-python-at-venmo-4465379983",
"title": "Senior Software Engineer - Python",
"company": {
"name": "Venmo",
"url": "https://www.linkedin.com/company/venmo",
"slug": "venmo",
"logo": "https://media.licdn.com/dms/image/v2/C560BAQFqYO6c_JfA5A/company-logo_100_100/company-logo_100_100/0/1630671648627/venmo_logo?e=2147483647&v=beta&t=Fi0eAWLUnQZSiwbMnfpJ8zsELjGcPFfJpi38G0DEBK8",
"specialties": []
},
"location": "Austin, TX",
"posted_date": "2026-09-10",
"posted_relative": "1 week ago",
"benefits": [],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4462361684",
"job_url": "https://www.linkedin.com/jobs/view/python-software-developer-at-advatix-latam-4462361684",
"title": "Python/Software Developer",
"company": {
"name": "Advatix LATAM",
"url": "https://cl.linkedin.com/company/up-time-s-a",
"slug": "up-time-s-a",
"logo": "https://media.licdn.com/dms/image/v2/C4E0BAQFA_fdci6jCcA/company-logo_100_100/company-logo_100_100/0/1673868542191/up_time_s_a_logo?e=2147483647&v=beta&t=QwJfRaJofahq73URjRHo--gmyxUNXAKbDmWS2njsOHM",
"specialties": []
},
"location": "Bronx, NY",
"posted_date": "2026-09-05",
"posted_relative": "2 weeks ago",
"benefits": [],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4454812137",
"job_url": "https://www.linkedin.com/jobs/view/python-developer-iii-at-bank-of-america-4454812137",
"title": "Python Developer III",
"company": {
"name": "Bank of America",
"url": "https://www.linkedin.com/company/bank-of-america",
"slug": "bank-of-america",
"logo": "https://media.licdn.com/dms/image/v2/C4D0BAQEL1rI2h3XGxg/company-logo_100_100/company-logo_100_100/0/1676325271208/bank_of_america_logo?e=2147483647&v=beta&t=eB9ITURV8Kb7BaN5HJmVlYSlxdBBNffnqiMvUycVxSY",
"specialties": []
},
"location": "Jersey City, NJ",
"posted_date": "2026-09-05",
"posted_relative": "2 weeks ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4432486930",
"job_url": "https://www.linkedin.com/jobs/view/senior-python-developer-at-unis-4432486930",
"title": "Senior python developer",
"company": {
"name": "UNIS",
"url": "https://www.linkedin.com/company/unislogistics",
"slug": "unislogistics",
"logo": "https://media.licdn.com/dms/image/v2/D560BAQFsu-Nz0hqEPQ/company-logo_100_100/company-logo_100_100/0/1688581115354/unislogistics_logo?e=2147483647&v=beta&t=lL5vzrEgXQKWtetpIfaQXW8oxlGnksGO5QePaQteruw",
"specialties": []
},
"location": "Irvine, CA",
"posted_date": "2026-06-24",
"posted_relative": "3 months ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4461484466",
"job_url": "https://www.linkedin.com/jobs/view/python-software-developer-at-advatix-advanced-supply-chain-and-logistics-4461484466",
"title": "Python/Software Developer",
"company": {
"name": "ADVATIX - Advanced Supply Chain and Logistics",
"url": "https://www.linkedin.com/company/advatix",
"slug": "advatix",
"logo": "https://media.licdn.com/dms/image/v2/D560BAQEHAqPsYdm3uQ/company-logo_100_100/company-logo_100_100/0/1731065749162/advatix_logo?e=2147483647&v=beta&t=gvMOmJTmZh4Es_NJt1YO5Z4ktoz4KDidVSxQ8kzJPOg",
"specialties": []
},
"location": "Bronx, NY",
"posted_date": "2026-09-04",
"posted_relative": "2 weeks ago",
"benefits": [
"Be an early applicant",
"Be an early applicant"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4431788837",
"job_url": "https://www.linkedin.com/jobs/view/senior-python-software-engineer-at-gliacell-technologies-4431788837",
"title": "Senior Python Software Engineer",
"company": {
"name": "GliaCell Technologies",
"url": "https://www.linkedin.com/company/glia-cell-technologies",
"slug": "glia-cell-technologies",
"logo": "https://media.licdn.com/dms/image/v2/C4D0BAQFaa2wszqjcdw/company-logo_100_100/company-logo_100_100/0/1630541726279/glia_cell_technologies_logo?e=2147483647&v=beta&t=OWp5j1X5dGX9qAHyLYNT84E3q_eZ6p0sboRM0gcScl8",
"specialties": []
},
"location": "Linthicum Heights, MD",
"posted_date": "2026-06-22",
"posted_relative": "3 months ago",
"benefits": [
"Be an early applicant",
"Be an early applicant"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4433060008",
"job_url": "https://www.linkedin.com/jobs/view/senior-python-engineer-at-callibrity-4433060008",
"title": "Senior Python Engineer",
"company": {
"name": "Callibrity",
"url": "https://www.linkedin.com/company/callibrity",
"slug": "callibrity",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQG1iq98R5yKIQ/company-logo_100_100/B4EaCHDzfiIUAI-/0/1788972316927/callibrity_logo?e=2147483647&v=beta&t=zkxoG0aLkvHXQMWZxUpK5eUtNsSJJQXXZWbPm4q7-uw",
"specialties": []
},
"location": "Cincinnati, OH",
"posted_date": "2026-06-23",
"posted_relative": "3 months ago",
"benefits": [],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4437283709",
"job_url": "https://www.linkedin.com/jobs/view/backend-python-senior-engineer-at-techwish-4437283709",
"title": "Backend (Python) Senior Engineer",
"company": {
"name": "TechWish",
"url": "https://www.linkedin.com/company/techwish",
"slug": "techwish",
"logo": "https://media.licdn.com/dms/image/v2/D560BAQEtRqFK7dUqRg/company-logo_100_100/B56Zb8aRsBGsAQ-/0/1747991469383/techwish_logo?e=2147483647&v=beta&t=cCBBoaAHYTiUfDL10S0-x-DAlmZY0hNnyWH5DUUFckI",
"specialties": []
},
"location": "New York, NY",
"posted_date": "2026-07-13",
"posted_relative": "2 months ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4464227292",
"job_url": "https://www.linkedin.com/jobs/view/python-developer-at-synechron-4464227292",
"title": "Python Developer",
"company": {
"name": "Synechron",
"url": "https://www.linkedin.com/company/synechron",
"slug": "synechron",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQGU3XDmI-XtZg/company-logo_100_100/B4EZbozLqWHcAU-/0/1747662453848/synechron_logo?e=2147483647&v=beta&t=967JcOKqVUEfAxo-JLDXVLacACGsfj3Itpkbmqz1HrA",
"specialties": []
},
"location": "Jersey City, NJ",
"posted_date": "2026-09-11",
"posted_relative": "1 week ago",
"benefits": [
"Actively Hiring\n +8 benefits",
"Actively Hiring\n +8 benefits"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4375952828",
"job_url": "https://www.linkedin.com/jobs/view/automation-software-engineer-at-caci-international-inc-4375952828",
"title": "Automation Software Engineer",
"company": {
"name": "CACI International Inc",
"url": "https://www.linkedin.com/company/caci-international-inc",
"slug": "caci-international-inc",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQFob5rET4oo0w/company-logo_100_100/B4EZpUDHB_GYAQ-/0/1762346693140/caci_international_inc_logo?e=2147483647&v=beta&t=Re0dd7_XNTi2d3bgLF4IqHIOhyYkT1r-x_e8HWa-Nyc",
"specialties": []
},
"location": "Linthicum, MD",
"posted_date": "2026-02-27",
"posted_relative": "6 months ago",
"benefits": [
"Be an early applicant",
"Be an early applicant"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4470991596",
"job_url": "https://www.linkedin.com/jobs/view/software-engineer-i-at-los-angeles-capital-management-4470991596",
"title": "Software Engineer I",
"company": {
"name": "Los Angeles Capital Management",
"url": "https://www.linkedin.com/company/los-angeles-capital-management",
"slug": "los-angeles-capital-management",
"logo": "https://media.licdn.com/dms/image/v2/C560BAQFE0GVs9orIqA/company-logo_100_100/company-logo_100_100/0/1630579300181/los_angeles_capital_management_logo?e=2147483647&v=beta&t=xqJ2xpIFI43LZrHqEkkrlYGrqAm7mI45ol_bRg1UivU",
"specialties": []
},
"location": "Los Angeles Metropolitan Area",
"posted_date": "2026-09-23",
"posted_relative": "3 hours ago",
"benefits": [
"Medical insurance\n +7 benefits",
"Medical insurance\n +7 benefits"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4449766035",
"job_url": "https://www.linkedin.com/jobs/view/senior-backend-software-engineer-python-at-shield-consulting-solutions-inc-4449766035",
"title": "Senior Backend Software Engineer (Python)",
"company": {
"name": "Shield Consulting Solutions, Inc.",
"url": "https://www.linkedin.com/company/shield-consulting-solutions",
"slug": "shield-consulting-solutions",
"logo": "https://media.licdn.com/dms/image/v2/C4D0BAQFghP9mKDmXyQ/company-logo_100_100/company-logo_100_100/0/1631345620090?e=2147483647&v=beta&t=R92U4MgeTgzzV1oAx7hYb18NZ4-sQewhwCO2_c_ImmU",
"specialties": []
},
"location": "Annapolis Junction, MD",
"posted_date": "2026-08-06",
"posted_relative": "1 month ago",
"benefits": [
"Be an early applicant",
"Be an early applicant"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4438545327",
"job_url": "https://www.linkedin.com/jobs/view/software-python-developer-remote-schedule-at-cpi-card-group-4438545327",
"title": "Software (python) Developer - Remote Schedule",
"company": {
"name": "CPI Card Group",
"url": "https://www.linkedin.com/company/cpi-card-group",
"slug": "cpi-card-group",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQF_vwehTv5U7w/company-logo_100_100/B4EZ_3e8eGJ0AI-/0/1786563512523/cpi_card_group_logo?e=2147483647&v=beta&t=WuqW04AuAHbhfXVp8OAVRCoN2D_RTyjD9uqa3RRTsro",
"specialties": []
},
"location": "Littleton, CO",
"posted_date": "2026-07-09",
"posted_relative": "2 months ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4440359739",
"job_url": "https://www.linkedin.com/jobs/view/backend-engineer-core-product-at-scribe-4440359739",
"title": "Backend Engineer, Core Product",
"company": {
"name": "Scribe",
"url": "https://www.linkedin.com/company/scribehow",
"slug": "scribehow",
"logo": "https://media.licdn.com/dms/image/v2/D560BAQFOl0D6HTBe-A/company-logo_100_100/B56Z7WI87EG0AI-/0/1781709131682/scribehow_logo?e=2147483647&v=beta&t=tsVjfxxSVw5vC8xuhFphp8koZEkbnT_40EmX8FaZ2jQ",
"specialties": []
},
"location": "San Francisco, CA",
"posted_date": "2026-09-18",
"posted_relative": "5 days ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
},
{
"job_id": "4467800628",
"job_url": "https://www.linkedin.com/jobs/view/gen-ai-python-developer-assistant-vice-president-at-citi-4467800628",
"title": "Gen AI - Python Developer - Assistant Vice President",
"company": {
"name": "Citi",
"url": "https://www.linkedin.com/company/citi",
"slug": "citi",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAQFgF4xtqyXBcg/company-logo_100_100/company-logo_100_100/0/1719257286385/citi_logo?e=2147483647&v=beta&t=E0LjmXX_MaMB3pwg6W_ragjyCPSpChEG51ham_xSNVc",
"specialties": []
},
"location": "Tampa, FL",
"posted_date": "2026-09-17",
"posted_relative": "5 days ago",
"benefits": [
"Actively Hiring",
"Actively Hiring"
],
"search_query": "python developer",
"search_location": "United States"
}
],
"count": 25,
"pages_fetched": 3,
"stop_reason": "max_results"
}
}What the LinkedIn Jobs API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| jobs/search | Search public LinkedIn job postings by keywords, with optional location and date/seniority/job-type/workplace filters. | Recruiting teams call jobs/search to search public LinkedIn job postings by keywords, with optional location and date/seniority/jo…. | keywords, location, max_results, date_posted, experience, ... |
| jobs/detail | Full posting for one job: description, employment type, seniority, salary, applicant count. | Labor-market analysts call jobs/detail to get full posting for one job. | job_id, include_company |
| company | Company profile: description, website, employee count, industry, HQ, founded year, specialties. | Job boards call company to get company profile. | company |
| jobs/by-company | All public job postings at a specific company — pass a company slug, URL or numeric id; optionally narrow with the same keyword/location/date/seniority/job-type/workplace filters as jobs/search. | Sales intelligence teams call jobs/by-company to get all public job postings at a specific company. | company, keywords, location, max_results, date_posted, ... |
| locations/search | Location typeahead → resolve a place name (city, region, metro area, country) to the LinkedIn numeric geoId used by the `geoId` search param for precise geo-pinned searches. | Recruiting teams call locations/search to get location typeahead → resolve a place name (city, region, metro area, country) to the LinkedIn…. | query |
| jobs/similar | Related job postings for a given job_id. LinkedIn's guest surface exposes no direct similar-jobs feed, so results are a keyword+location re-search seeded from the source job's own title (the seed job is excluded). | Labor-market analysts call jobs/similar to get related job postings for a given job_id. | job_id, keywords, location, max_results, include_detail, ... |
Call jobs/search from your stack
curl -X POST https://api.reefapi.com/linkedin-jobs/v1/jobs/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"keywords":"python developer","location":"United States","max_results":25}'import requests
r = requests.post(
"https://api.reefapi.com/linkedin-jobs/v1/jobs/search",
headers={"x-api-key": REEF_KEY},
json={
"keywords": "python developer",
"location": "United States",
"max_results": 25
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/linkedin-jobs/v1/jobs/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"keywords": "python developer",
"location": "United States",
"max_results": 25
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.linkedin-jobs.jobs/search with {"keywords":"python developer","location":"United States","max_results":25}.Who uses this API and why
- Recruiting tools call jobs/search to track open roles by title, location and workplace type.
- Sales-intelligence teams use jobs/by-company to spot hiring and expansion signals at accounts.
- Labor-market analysts use seniority and posted_date to measure demand trends over time.
Questions developers ask before integrating
Which fields only appear when I pass include_detail?
A plain jobs/search result carries job_id, job_url, title, company (name, url, slug, logo), location, posted_date, posted_relative. Everything a hiring analyst actually wants — description_text, description_html, salary, seniority_level, employment_type, job_function, industries, applicant_count_text, apply_url, easy_apply, job_state — only arrives with include_detail set. The cost is one extra request per job: a 2-job search with include_detail measured 3 requests, so pull the list first and hydrate the rows you care about.
Why is salary missing on some LinkedIn jobs even with include_detail?
Because LinkedIn did not publish one. In a measured two-job sample one posting returned salary as an object with text, min_value, max_value and currency; the other had no salary key at all. Treat the field as absent-or-object, never as an empty string, and never infer a range from the seniority label. The same applies to benefits, which comes back as an empty array far more often than a populated one.
What is a LinkedIn geoId, and why does one city name return several?
geoId is LinkedIn's internal numeric id for a place, and it is the only way to pin a search to exactly the geography you mean. locations/search on 'Berlin' returned 10 of them: Berlin, Berlin, Germany (106967730), Berlin Metropolitan Area (90009712), Stadt Berlin (101283667), plus Berlin in Connecticut, Maryland and New Jersey. The free-text location parameter picks one of those for you and will sometimes pick a different one than you expect — resolve the geoId once and reuse it.
What does workplace_type_source mean on a job?
It tells you where the Remote/Hybrid/On-site label came from. A value of facet means the job inherited the label from the filter you searched with, not from a statement in the posting itself. That distinction matters if you are counting remote roles: filtering on workplace=remote and then counting workplace_type=Remote is circular. Only rows whose source is the posting are independent evidence.
Are seniority_level and employment_type reliable?
They are LinkedIn's own labels, copied through unchanged, and employers fill them in carelessly. A measured example: a Cargill posting titled 'Data Engineer' came back with seniority_level 'Not Applicable' and employment_type 'Internship'. We do not correct these — if we normalized them you would have no way to tell a real label from our guess. Filter on them, but expect noise at the tails.
How do I page through more than one screen of results?
meta.pagination returns has_more and next_cursor; pass next_cursor back as cursor to continue. record_count and stop_reason tell you why a page ended — stop_reason 'max_results' means you hit your own cap, not the end of the inventory. The ceiling on any single query is roughly 1000 postings.
Can I get every open role at one company?
Use jobs/by-company with a company slug (the part after linkedin.com/company/), the full company URL or the numeric id. It returns the same job shape plus the resolved company_id, and accepts the same keyword, location, date and seniority filters if you want to narrow within the employer. The separate company action returns the employer profile: description, website, employee_count, industry, headquarters, founded and specialties.
What is the LinkedIn Jobs API?
LinkedIn Jobs API is a ReefAPI endpoint group for public job listings and details. It returns live JSON through POST requests under /linkedin-jobs/v1.
Is the LinkedIn Jobs API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. LinkedIn Jobs calls use the same shared credit balance as every other ReefAPI engine.
Do I need a LinkedIn Jobs login or account?
No login to LinkedIn Jobs is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the LinkedIn Jobs data?
The page example is captured from a live jobs/search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the LinkedIn Jobs API use?
LinkedIn Jobs actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call LinkedIn Jobs from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call linkedin-jobs actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the LinkedIn Jobs API a LinkedIn Jobs scraper?
It is the managed alternative to a DIY LinkedIn Jobs scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same public job listings and details back as clean JSON.