{"openapi":"3.1.0","info":{"title":"Arihaan Jobs API","version":"1.0.0","description":"Open jobs crawled daily from company career sites (Workday, Greenhouse, Lever, Ashby, SmartRecruiters …). Each call to a /v1/jobs endpoint counts as one request against your account's limit."},"servers":[{"url":"https://jobs-api.arihaan.ai"}],"security":[{"bearer":[]},{"apiKey":[]}],"paths":{"/v1/jobs":{"get":{"operationId":"searchJobs","summary":"Search jobs (newest first)","parameters":[{"name":"title","in":"query","required":false,"description":"Title has ANY of these as words, case and punctuation ignored; the last word may continue ('Product Lead' finds 'Product Leader').","schema":{"type":"array","items":{"type":"string"},"example":["Product Manager","Program Manager"]},"style":"form","explode":true},{"name":"title_exclude","in":"query","required":false,"description":"Drop jobs whose title contains ANY of these.","schema":{"type":"array","items":{"type":"string"},"example":["Director"]},"style":"form","explode":true},{"name":"title_whole_words","in":"query","required":false,"description":"Match title and title_exclude as whole words only: the last word is not continued ('Lead' does not find 'Leader'). Words are always whole: 'CTO' never finds 'Director', excluding 'IT' keeps 'Security Analyst'.","schema":{"type":"boolean"}},{"name":"company","in":"query","required":false,"description":"Only these companies (substring of the company name or its board key).","schema":{"type":"array","items":{"type":"string"},"example":["Stripe"]},"style":"form","explode":true},{"name":"exclude_company","in":"query","required":false,"description":"Drop these companies (substring match).","schema":{"type":"array","items":{"type":"string"},"example":["Amazon"]},"style":"form","explode":true},{"name":"sources","in":"query","required":false,"description":"Only jobs from these applicant-tracking systems.","schema":{"type":"array","items":{"type":"string","enum":["workday","greenhouse","smartrecruiters","lever","ashby","teamtailor","breezy","personio","pinpoint","gem"]}},"style":"form","explode":true},{"name":"exclude_sources","in":"query","required":false,"description":"Drop jobs from these applicant-tracking systems, e.g. ['manatal'] (its boards are mostly recruiting agencies).","schema":{"type":"array","items":{"type":"string"},"example":["manatal"]},"style":"form","explode":true},{"name":"industry","in":"query","required":false,"description":"Company industry contains ANY (LinkedIn industry names).","schema":{"type":"array","items":{"type":"string"},"example":["Software Development"]},"style":"form","explode":true},{"name":"exclude_industry","in":"query","required":false,"description":"Drop companies whose industry contains ANY of these. Jobs whose industry is unknown are kept.","schema":{"type":"array","items":{"type":"string"},"example":["Staffing and Recruiting"]},"style":"form","explode":true},{"name":"skills","in":"query","required":false,"description":"The job lists ANY of these skills (whole skill, case-insensitive).","schema":{"type":"array","items":{"type":"string"},"example":["Python","SQL"]},"style":"form","explode":true},{"name":"company_size","in":"query","required":false,"description":"Company headcount bucket(s). Unknown size is excluded.","schema":{"type":"array","items":{"type":"string","enum":["1","2-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000","10000+"]}},"style":"form","explode":true},{"name":"exclude_agencies","in":"query","required":false,"description":"Drop staffing and recruiting agencies.","schema":{"type":"boolean"}},{"name":"sector","in":"query","required":false,"description":"Company sector(s), from our company profile (98.7% of jobs).","schema":{"type":"array","items":{"type":"string","enum":["AGRICULTURE","CONSTRUCTION_AND_REAL_ESTATE","CONSUMER_GOODS","EDUCATION","ENERGY","FINANCIAL_SERVICES","GOVERNMENT","HARDWARE_AND_ELECTRONICS","HEALTHCARE","HOSPITALITY","INSURANCE","MANUFACTURING","MEDIA_AND_ENTERTAINMENT","NONPROFIT","OTHER","PHARMA_AND_BIOTECH","PROFESSIONAL_SERVICES","RETAIL","SOFTWARE","STAFFING","TELECOMMUNICATIONS","TRANSPORTATION_AND_LOGISTICS"]},"example":["SOFTWARE","FINANCIAL_SERVICES"]},"style":"form","explode":true},{"name":"company_kind","in":"query","required":false,"description":"Kind of employer: OPERATING_COMPANY, CONSULTING, STAFFING_AGENCY …","schema":{"type":"array","items":{"type":"string","enum":["CONSULTING","EDUCATION","GOVERNMENT","HEALTH_PROVIDER","NONPROFIT","OPERATING_COMPANY","STAFFING_AGENCY"]},"example":["OPERATING_COMPANY"]},"style":"form","explode":true},{"name":"customer","in":"query","required":false,"description":"Who the company sells to.","schema":{"type":"array","items":{"type":"string","enum":["B2B","B2C","B2G","BOTH"]},"example":["B2B"]},"style":"form","explode":true},{"name":"ownership","in":"query","required":false,"description":"PUBLIC, PRIVATE, NONPROFIT … Companies with unknown ownership are excluded.","schema":{"type":"array","items":{"type":"string","enum":["EDUCATION","GOVERNMENT","NONPROFIT","PRIVATE","PUBLIC"]},"example":["PUBLIC"]},"style":"form","explode":true},{"name":"work_mode","in":"query","required":false,"description":"ANY of: On-site (the posting never mentions remote, hybrid or work from home, or its text says the job is on site), Remote OK (it mentions remote anywhere and its text does not say the job is hybrid or on site), Remote Solely (title or location says remote, same exception), Hybrid (title or location says hybrid, or its text does). All four = no filter.","schema":{"type":"array","items":{"type":"string","enum":["On-site","Hybrid","Remote OK","Remote Solely"]}},"style":"form","explode":true},{"name":"exclude_work_mode","in":"query","required":false,"description":"Drop jobs matching ANY of these work modes (same rules as work_mode). ['Remote Solely'] keeps every job someone could go in to.","schema":{"type":"array","items":{"type":"string","enum":["On-site","Hybrid","Remote OK","Remote Solely"]}},"style":"form","explode":true},{"name":"description","in":"query","required":false,"description":"The title or full description contains ANY of these, as whole words (case-insensitive). Needs title or company in the same search.","schema":{"type":"array","items":{"type":"string"},"example":["Snowflake","dbt"]},"style":"form","explode":true},{"name":"exclude_description","in":"query","required":false,"description":"Drop jobs whose full description contains ANY of these, as whole words (case-insensitive). Needs title or company in the same search.","schema":{"type":"array","items":{"type":"string"},"example":["clearance"]},"style":"form","explode":true},{"name":"taxonomies","in":"query","required":false,"description":"Job category, Fantastic's names. Read from the job's function flags, the company's sector or kind, and title words; any one is enough.","schema":{"type":"array","items":{"type":"string","enum":["Technology","Healthcare","Management & Leadership","Finance & Accounting","Human Resources","Sales","Marketing","Customer Service & Support","Education","Legal","Engineering","Science & Research","Trades","Construction","Manufacturing","Logistics","Creative & Media","Hospitality","Retail","Data & Analytics","Software","Energy","Agriculture","Government & Public Sector","Art & Design","Transportation","Consulting"]},"example":["Data & Analytics"]},"style":"form","explode":true},{"name":"education","in":"query","required":false,"description":"The job's requirements ask for ANY of these.","schema":{"type":"array","items":{"type":"string","enum":["high school","associate degree","bachelor degree","professional certificate","postgraduate degree"]},"example":["bachelor degree"]},"style":"form","explode":true},{"name":"visa","in":"query","required":false,"description":"only = the job offers visa sponsorship (the company sponsors, or the posting says so, and the posting never refuses); exclude = it does not.","schema":{"type":"string"}},{"name":"remote_friendly","in":"query","required":false,"description":"true = the posting mentions remote/hybrid/WFH anywhere; false = it does not. Prefer work_mode.","schema":{"type":"boolean"}},{"name":"countries","in":"query","required":false,"description":"ISO-3166 alpha-2 country codes.","schema":{"type":"array","items":{"type":"string"},"example":["US","CA"]},"style":"form","explode":true},{"name":"locations","in":"query","required":false,"description":"ANY of these places. Each is 'City, State', 'State' or 'City'; every comma part must match. US states in full or as postal codes.","schema":{"type":"array","items":{"type":"string"},"example":["Chicago, Illinois","TX"]},"style":"form","explode":true},{"name":"exclude_locations","in":"query","required":false,"description":"Drop jobs in ANY of these places (same rules as locations).","schema":{"type":"array","items":{"type":"string"},"example":["New York"]},"style":"form","explode":true},{"name":"experience","in":"query","required":false,"description":"Years of experience asked for. Postings that do not say are kept.","schema":{"type":"array","items":{"type":"string","enum":["0-2","2-5","5-10","10+"]}},"style":"form","explode":true},{"name":"employment_type","in":"query","required":false,"description":"Employment type. Postings that do not say are kept.","schema":{"type":"array","items":{"type":"string","enum":["FULL_TIME","PART_TIME","CONTRACTOR","TEMPORARY","INTERN"]}},"style":"form","explode":true},{"name":"min_salary_annual","in":"query","required":false,"description":"Published annual pay at least this much. Postings that publish no pay are kept; add has_salary=true to drop them. Estimates never count.","schema":{"type":"number","minimum":0,"example":120000}},{"name":"has_salary","in":"query","required":false,"description":"Only jobs whose posting states pay.","schema":{"type":"boolean"}},{"name":"posted_within_days","in":"query","required":false,"description":"Posted (or first seen) in the last N days, today included.","schema":{"type":"integer","minimum":1,"maximum":365,"example":7}},{"name":"posted_since","in":"query","required":false,"description":"Posted (or first seen) on or after this date, YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"posted_before","in":"query","required":false,"description":"Posted (or first seen) before this date, YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"include_internships","in":"query","required":false,"description":"Internships and co-ops are included by default; false leaves them out.","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Jobs per page.","schema":{"type":"integer","minimum":1,"maximum":100,"example":20}},{"name":"cursor","in":"query","required":false,"description":"next_cursor from the previous page. The way to page.","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Skip N jobs (max 5,000). Use cursor for deeper paging.","schema":{"type":"integer","minimum":0,"maximum":5000}},{"name":"include_description","in":"query","required":false,"description":"Include each job's full description, requirements, responsibilities, job function and AI flags (large).","schema":{"type":"boolean"}},{"name":"include_company","in":"query","required":false,"description":"Attach each job's full company profile (size, headcount, revenue range, funding, founded, headquarters, followers).","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobPage"}}}},"400":{"description":"Invalid filter (invalid_request), or a search too broad to answer (too_broad)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or bad key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily tokens used up, or too many requests at once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/jobs/search":{"post":{"operationId":"searchJobsPost","summary":"Search jobs with a JSON body","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"array","items":{"type":"string"},"example":["Product Manager","Program Manager"],"description":"Title has ANY of these as words, case and punctuation ignored; the last word may continue ('Product Lead' finds 'Product Leader')."},"title_exclude":{"type":"array","items":{"type":"string"},"example":["Director"],"description":"Drop jobs whose title contains ANY of these."},"title_whole_words":{"type":"boolean","description":"Match title and title_exclude as whole words only: the last word is not continued ('Lead' does not find 'Leader'). Words are always whole: 'CTO' never finds 'Director', excluding 'IT' keeps 'Security Analyst'."},"company":{"type":"array","items":{"type":"string"},"example":["Stripe"],"description":"Only these companies (substring of the company name or its board key)."},"exclude_company":{"type":"array","items":{"type":"string"},"example":["Amazon"],"description":"Drop these companies (substring match)."},"sources":{"type":"array","items":{"type":"string","enum":["workday","greenhouse","smartrecruiters","lever","ashby","teamtailor","breezy","personio","pinpoint","gem"]},"description":"Only jobs from these applicant-tracking systems."},"exclude_sources":{"type":"array","items":{"type":"string"},"example":["manatal"],"description":"Drop jobs from these applicant-tracking systems, e.g. ['manatal'] (its boards are mostly recruiting agencies)."},"industry":{"type":"array","items":{"type":"string"},"example":["Software Development"],"description":"Company industry contains ANY (LinkedIn industry names)."},"exclude_industry":{"type":"array","items":{"type":"string"},"example":["Staffing and Recruiting"],"description":"Drop companies whose industry contains ANY of these. Jobs whose industry is unknown are kept."},"skills":{"type":"array","items":{"type":"string"},"example":["Python","SQL"],"description":"The job lists ANY of these skills (whole skill, case-insensitive)."},"company_size":{"type":"array","items":{"type":"string","enum":["1","2-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000","10000+"]},"description":"Company headcount bucket(s). Unknown size is excluded."},"exclude_agencies":{"type":"boolean","description":"Drop staffing and recruiting agencies."},"sector":{"type":"array","items":{"type":"string","enum":["AGRICULTURE","CONSTRUCTION_AND_REAL_ESTATE","CONSUMER_GOODS","EDUCATION","ENERGY","FINANCIAL_SERVICES","GOVERNMENT","HARDWARE_AND_ELECTRONICS","HEALTHCARE","HOSPITALITY","INSURANCE","MANUFACTURING","MEDIA_AND_ENTERTAINMENT","NONPROFIT","OTHER","PHARMA_AND_BIOTECH","PROFESSIONAL_SERVICES","RETAIL","SOFTWARE","STAFFING","TELECOMMUNICATIONS","TRANSPORTATION_AND_LOGISTICS"]},"example":["SOFTWARE","FINANCIAL_SERVICES"],"description":"Company sector(s), from our company profile (98.7% of jobs)."},"company_kind":{"type":"array","items":{"type":"string","enum":["CONSULTING","EDUCATION","GOVERNMENT","HEALTH_PROVIDER","NONPROFIT","OPERATING_COMPANY","STAFFING_AGENCY"]},"example":["OPERATING_COMPANY"],"description":"Kind of employer: OPERATING_COMPANY, CONSULTING, STAFFING_AGENCY …"},"customer":{"type":"array","items":{"type":"string","enum":["B2B","B2C","B2G","BOTH"]},"example":["B2B"],"description":"Who the company sells to."},"ownership":{"type":"array","items":{"type":"string","enum":["EDUCATION","GOVERNMENT","NONPROFIT","PRIVATE","PUBLIC"]},"example":["PUBLIC"],"description":"PUBLIC, PRIVATE, NONPROFIT … Companies with unknown ownership are excluded."},"work_mode":{"type":"array","items":{"type":"string","enum":["On-site","Hybrid","Remote OK","Remote Solely"]},"description":"ANY of: On-site (the posting never mentions remote, hybrid or work from home, or its text says the job is on site), Remote OK (it mentions remote anywhere and its text does not say the job is hybrid or on site), Remote Solely (title or location says remote, same exception), Hybrid (title or location says hybrid, or its text does). All four = no filter."},"exclude_work_mode":{"type":"array","items":{"type":"string","enum":["On-site","Hybrid","Remote OK","Remote Solely"]},"description":"Drop jobs matching ANY of these work modes (same rules as work_mode). ['Remote Solely'] keeps every job someone could go in to."},"description":{"type":"array","items":{"type":"string"},"example":["Snowflake","dbt"],"description":"The title or full description contains ANY of these, as whole words (case-insensitive). Needs title or company in the same search."},"exclude_description":{"type":"array","items":{"type":"string"},"example":["clearance"],"description":"Drop jobs whose full description contains ANY of these, as whole words (case-insensitive). Needs title or company in the same search."},"taxonomies":{"type":"array","items":{"type":"string","enum":["Technology","Healthcare","Management & Leadership","Finance & Accounting","Human Resources","Sales","Marketing","Customer Service & Support","Education","Legal","Engineering","Science & Research","Trades","Construction","Manufacturing","Logistics","Creative & Media","Hospitality","Retail","Data & Analytics","Software","Energy","Agriculture","Government & Public Sector","Art & Design","Transportation","Consulting"]},"example":["Data & Analytics"],"description":"Job category, Fantastic's names. Read from the job's function flags, the company's sector or kind, and title words; any one is enough."},"education":{"type":"array","items":{"type":"string","enum":["high school","associate degree","bachelor degree","professional certificate","postgraduate degree"]},"example":["bachelor degree"],"description":"The job's requirements ask for ANY of these."},"visa":{"type":"string","description":"only = the job offers visa sponsorship (the company sponsors, or the posting says so, and the posting never refuses); exclude = it does not."},"remote_friendly":{"type":"boolean","description":"true = the posting mentions remote/hybrid/WFH anywhere; false = it does not. Prefer work_mode."},"countries":{"type":"array","items":{"type":"string"},"example":["US","CA"],"description":"ISO-3166 alpha-2 country codes."},"locations":{"type":"array","items":{"type":"string"},"example":["Chicago, Illinois","TX"],"description":"ANY of these places. Each is 'City, State', 'State' or 'City'; every comma part must match. US states in full or as postal codes."},"exclude_locations":{"type":"array","items":{"type":"string"},"example":["New York"],"description":"Drop jobs in ANY of these places (same rules as locations)."},"experience":{"type":"array","items":{"type":"string","enum":["0-2","2-5","5-10","10+"]},"description":"Years of experience asked for. Postings that do not say are kept."},"employment_type":{"type":"array","items":{"type":"string","enum":["FULL_TIME","PART_TIME","CONTRACTOR","TEMPORARY","INTERN"]},"description":"Employment type. Postings that do not say are kept."},"min_salary_annual":{"type":"number","minimum":0,"example":120000,"description":"Published annual pay at least this much. Postings that publish no pay are kept; add has_salary=true to drop them. Estimates never count."},"has_salary":{"type":"boolean","description":"Only jobs whose posting states pay."},"posted_within_days":{"type":"integer","minimum":1,"maximum":365,"example":7,"description":"Posted (or first seen) in the last N days, today included."},"posted_since":{"type":"string","format":"date","description":"Posted (or first seen) on or after this date, YYYY-MM-DD."},"posted_before":{"type":"string","format":"date","description":"Posted (or first seen) before this date, YYYY-MM-DD."},"include_internships":{"type":"boolean","description":"Internships and co-ops are included by default; false leaves them out."},"limit":{"type":"integer","minimum":1,"maximum":100,"example":20,"description":"Jobs per page."},"cursor":{"type":"string","description":"next_cursor from the previous page. The way to page."},"offset":{"type":"integer","minimum":0,"maximum":5000,"description":"Skip N jobs (max 5,000). Use cursor for deeper paging."},"include_description":{"type":"boolean","description":"Include each job's full description, requirements, responsibilities, job function and AI flags (large)."},"include_company":{"type":"boolean","description":"Attach each job's full company profile (size, headcount, revenue range, funding, founded, headquarters, followers)."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobPage"}}}},"400":{"description":"Invalid filter (invalid_request), or a search too broad to answer (too_broad)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or bad key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily tokens used up, or too many requests at once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/jobs/count":{"get":{"operationId":"countJobs","summary":"Count matching jobs","parameters":[{"name":"title","in":"query","required":false,"description":"Title has ANY of these as words, case and punctuation ignored; the last word may continue ('Product Lead' finds 'Product Leader').","schema":{"type":"array","items":{"type":"string"},"example":["Product Manager","Program Manager"]},"style":"form","explode":true},{"name":"title_exclude","in":"query","required":false,"description":"Drop jobs whose title contains ANY of these.","schema":{"type":"array","items":{"type":"string"},"example":["Director"]},"style":"form","explode":true},{"name":"title_whole_words","in":"query","required":false,"description":"Match title and title_exclude as whole words only: the last word is not continued ('Lead' does not find 'Leader'). Words are always whole: 'CTO' never finds 'Director', excluding 'IT' keeps 'Security Analyst'.","schema":{"type":"boolean"}},{"name":"company","in":"query","required":false,"description":"Only these companies (substring of the company name or its board key).","schema":{"type":"array","items":{"type":"string"},"example":["Stripe"]},"style":"form","explode":true},{"name":"exclude_company","in":"query","required":false,"description":"Drop these companies (substring match).","schema":{"type":"array","items":{"type":"string"},"example":["Amazon"]},"style":"form","explode":true},{"name":"sources","in":"query","required":false,"description":"Only jobs from these applicant-tracking systems.","schema":{"type":"array","items":{"type":"string","enum":["workday","greenhouse","smartrecruiters","lever","ashby","teamtailor","breezy","personio","pinpoint","gem"]}},"style":"form","explode":true},{"name":"exclude_sources","in":"query","required":false,"description":"Drop jobs from these applicant-tracking systems, e.g. ['manatal'] (its boards are mostly recruiting agencies).","schema":{"type":"array","items":{"type":"string"},"example":["manatal"]},"style":"form","explode":true},{"name":"industry","in":"query","required":false,"description":"Company industry contains ANY (LinkedIn industry names).","schema":{"type":"array","items":{"type":"string"},"example":["Software Development"]},"style":"form","explode":true},{"name":"exclude_industry","in":"query","required":false,"description":"Drop companies whose industry contains ANY of these. Jobs whose industry is unknown are kept.","schema":{"type":"array","items":{"type":"string"},"example":["Staffing and Recruiting"]},"style":"form","explode":true},{"name":"skills","in":"query","required":false,"description":"The job lists ANY of these skills (whole skill, case-insensitive).","schema":{"type":"array","items":{"type":"string"},"example":["Python","SQL"]},"style":"form","explode":true},{"name":"company_size","in":"query","required":false,"description":"Company headcount bucket(s). Unknown size is excluded.","schema":{"type":"array","items":{"type":"string","enum":["1","2-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000","10000+"]}},"style":"form","explode":true},{"name":"exclude_agencies","in":"query","required":false,"description":"Drop staffing and recruiting agencies.","schema":{"type":"boolean"}},{"name":"sector","in":"query","required":false,"description":"Company sector(s), from our company profile (98.7% of jobs).","schema":{"type":"array","items":{"type":"string","enum":["AGRICULTURE","CONSTRUCTION_AND_REAL_ESTATE","CONSUMER_GOODS","EDUCATION","ENERGY","FINANCIAL_SERVICES","GOVERNMENT","HARDWARE_AND_ELECTRONICS","HEALTHCARE","HOSPITALITY","INSURANCE","MANUFACTURING","MEDIA_AND_ENTERTAINMENT","NONPROFIT","OTHER","PHARMA_AND_BIOTECH","PROFESSIONAL_SERVICES","RETAIL","SOFTWARE","STAFFING","TELECOMMUNICATIONS","TRANSPORTATION_AND_LOGISTICS"]},"example":["SOFTWARE","FINANCIAL_SERVICES"]},"style":"form","explode":true},{"name":"company_kind","in":"query","required":false,"description":"Kind of employer: OPERATING_COMPANY, CONSULTING, STAFFING_AGENCY …","schema":{"type":"array","items":{"type":"string","enum":["CONSULTING","EDUCATION","GOVERNMENT","HEALTH_PROVIDER","NONPROFIT","OPERATING_COMPANY","STAFFING_AGENCY"]},"example":["OPERATING_COMPANY"]},"style":"form","explode":true},{"name":"customer","in":"query","required":false,"description":"Who the company sells to.","schema":{"type":"array","items":{"type":"string","enum":["B2B","B2C","B2G","BOTH"]},"example":["B2B"]},"style":"form","explode":true},{"name":"ownership","in":"query","required":false,"description":"PUBLIC, PRIVATE, NONPROFIT … Companies with unknown ownership are excluded.","schema":{"type":"array","items":{"type":"string","enum":["EDUCATION","GOVERNMENT","NONPROFIT","PRIVATE","PUBLIC"]},"example":["PUBLIC"]},"style":"form","explode":true},{"name":"work_mode","in":"query","required":false,"description":"ANY of: On-site (the posting never mentions remote, hybrid or work from home, or its text says the job is on site), Remote OK (it mentions remote anywhere and its text does not say the job is hybrid or on site), Remote Solely (title or location says remote, same exception), Hybrid (title or location says hybrid, or its text does). All four = no filter.","schema":{"type":"array","items":{"type":"string","enum":["On-site","Hybrid","Remote OK","Remote Solely"]}},"style":"form","explode":true},{"name":"exclude_work_mode","in":"query","required":false,"description":"Drop jobs matching ANY of these work modes (same rules as work_mode). ['Remote Solely'] keeps every job someone could go in to.","schema":{"type":"array","items":{"type":"string","enum":["On-site","Hybrid","Remote OK","Remote Solely"]}},"style":"form","explode":true},{"name":"description","in":"query","required":false,"description":"The title or full description contains ANY of these, as whole words (case-insensitive). Needs title or company in the same search.","schema":{"type":"array","items":{"type":"string"},"example":["Snowflake","dbt"]},"style":"form","explode":true},{"name":"exclude_description","in":"query","required":false,"description":"Drop jobs whose full description contains ANY of these, as whole words (case-insensitive). Needs title or company in the same search.","schema":{"type":"array","items":{"type":"string"},"example":["clearance"]},"style":"form","explode":true},{"name":"taxonomies","in":"query","required":false,"description":"Job category, Fantastic's names. Read from the job's function flags, the company's sector or kind, and title words; any one is enough.","schema":{"type":"array","items":{"type":"string","enum":["Technology","Healthcare","Management & Leadership","Finance & Accounting","Human Resources","Sales","Marketing","Customer Service & Support","Education","Legal","Engineering","Science & Research","Trades","Construction","Manufacturing","Logistics","Creative & Media","Hospitality","Retail","Data & Analytics","Software","Energy","Agriculture","Government & Public Sector","Art & Design","Transportation","Consulting"]},"example":["Data & Analytics"]},"style":"form","explode":true},{"name":"education","in":"query","required":false,"description":"The job's requirements ask for ANY of these.","schema":{"type":"array","items":{"type":"string","enum":["high school","associate degree","bachelor degree","professional certificate","postgraduate degree"]},"example":["bachelor degree"]},"style":"form","explode":true},{"name":"visa","in":"query","required":false,"description":"only = the job offers visa sponsorship (the company sponsors, or the posting says so, and the posting never refuses); exclude = it does not.","schema":{"type":"string"}},{"name":"remote_friendly","in":"query","required":false,"description":"true = the posting mentions remote/hybrid/WFH anywhere; false = it does not. Prefer work_mode.","schema":{"type":"boolean"}},{"name":"countries","in":"query","required":false,"description":"ISO-3166 alpha-2 country codes.","schema":{"type":"array","items":{"type":"string"},"example":["US","CA"]},"style":"form","explode":true},{"name":"locations","in":"query","required":false,"description":"ANY of these places. Each is 'City, State', 'State' or 'City'; every comma part must match. US states in full or as postal codes.","schema":{"type":"array","items":{"type":"string"},"example":["Chicago, Illinois","TX"]},"style":"form","explode":true},{"name":"exclude_locations","in":"query","required":false,"description":"Drop jobs in ANY of these places (same rules as locations).","schema":{"type":"array","items":{"type":"string"},"example":["New York"]},"style":"form","explode":true},{"name":"experience","in":"query","required":false,"description":"Years of experience asked for. Postings that do not say are kept.","schema":{"type":"array","items":{"type":"string","enum":["0-2","2-5","5-10","10+"]}},"style":"form","explode":true},{"name":"employment_type","in":"query","required":false,"description":"Employment type. Postings that do not say are kept.","schema":{"type":"array","items":{"type":"string","enum":["FULL_TIME","PART_TIME","CONTRACTOR","TEMPORARY","INTERN"]}},"style":"form","explode":true},{"name":"min_salary_annual","in":"query","required":false,"description":"Published annual pay at least this much. Postings that publish no pay are kept; add has_salary=true to drop them. Estimates never count.","schema":{"type":"number","minimum":0,"example":120000}},{"name":"has_salary","in":"query","required":false,"description":"Only jobs whose posting states pay.","schema":{"type":"boolean"}},{"name":"posted_within_days","in":"query","required":false,"description":"Posted (or first seen) in the last N days, today included.","schema":{"type":"integer","minimum":1,"maximum":365,"example":7}},{"name":"posted_since","in":"query","required":false,"description":"Posted (or first seen) on or after this date, YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"posted_before","in":"query","required":false,"description":"Posted (or first seen) before this date, YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"include_internships","in":"query","required":false,"description":"Internships and co-ops are included by default; false leaves them out.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Count"}}}},"400":{"description":"Invalid filter (invalid_request), or a search too broad to answer (too_broad)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or bad key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily tokens used up, or too many requests at once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/jobs/{job_id}":{"get":{"operationId":"getJob","summary":"One job with its full description","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}}},"400":{"description":"Invalid filter (invalid_request), or a search too broad to answer (too_broad)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or bad key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily tokens used up, or too many requests at once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/jobs/batch":{"post":{"operationId":"getJobs","summary":"Up to 100 jobs in full, by id","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","items":{"type":"string"},"maxItems":100}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobPage"}}}},"400":{"description":"Invalid filter (invalid_request), or a search too broad to answer (too_broad)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or bad key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily tokens used up, or too many requests at once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/companies":{"get":{"operationId":"findCompanies","summary":"Companies by name, industry or size, with open-job counts","parameters":[{"name":"name","in":"query","schema":{"type":"string"}},{"name":"industry","in":"query","schema":{"type":"string"}},{"name":"company_size","in":"query","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"hiring_only","in":"query","schema":{"type":"boolean","default":true}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK"}}}},"/v1/companies/{key}":{"get":{"operationId":"getCompany","summary":"A company's profile and live hiring stats","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"},"description":"Name or LinkedIn slug"}],"responses":{"200":{"description":"OK"}}}},"/v1/meta":{"get":{"operationId":"describeCatalog","summary":"Every filter and its allowed values, plus facts about the data (free)","responses":{"200":{"description":"OK"}}}},"/v1/usage":{"get":{"operationId":"getUsage","summary":"Your requests today and this month (free)","responses":{"200":{"description":"OK"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your API key"},"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Job":{"type":"object","description":"One job. Field names follow Fantastic Jobs where one exists.","properties":{"id":{"type":"string","description":"Stable id: vendor:tenant:source_job_id"},"title":{"type":"string"},"organization":{"type":"string"},"url":{"type":"string"},"apply_url":{"type":"string"},"source":{"type":"string"},"date_posted":{"type":["string","null"],"format":"date"},"date_first_seen":{"type":["string","null"],"format":"date"},"locations_derived":{"type":"array","items":{"type":"string"}},"countries_derived":{"type":"array","items":{"type":"string"}},"remote_friendly":{"type":"boolean"},"arrangement":{"type":["string","null"],"enum":["remote","hybrid","on_site","unclear",null],"description":"Where the person works, read from the posting's own words (no AI). unclear = the text does not say; null = not classified yet"},"arrangement_confidence":{"type":["number","null"]},"ai_experience_level":{"type":["string","null"]},"ai_employment_type":{"type":"array","items":{"type":"string"}},"has_salary":{"type":"boolean"},"ai_salary_min_value":{"type":["number","null"]},"ai_salary_max_value":{"type":["number","null"]},"ai_salary_currency":{"type":["string","null"]},"org_linkedin_industry":{"type":["string","null"]},"org_linkedin_size":{"type":["string","null"]},"ai_key_skills":{"type":"array","items":{"type":"string"}},"description_text":{"type":"string","description":"Only with include_description, or from GET /v1/jobs/{id}"}}},"JobPage":{"type":"object","properties":{"jobs":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"count":{"type":"integer"},"next_cursor":{"type":["string","null"]}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Count":{"type":"object","properties":{"count":{"type":"integer"}}}}}}