YM REST Services

JobSearch

**Requires Authentication**
Requires the role:	member

The following routes are available for this service:
GET	/Ymc/{ClientID}/Member/{MemberID}/JobSearch	Returns a list of jobs that matched your search criteria. For advanced search, use PUT to prevent complex types serialization issues with encoded values.
PUT	/Ymc/{ClientID}/Member/{MemberID}/JobSearch	Returns a list of jobs that matched your search criteria.

**JobSearch** Parameters:
Name	Parameter	Data Type	Required
q	body	string	No
start	body	int	No
rows	body	int	No
sort	body	string	No
lat	body	double	No
lng	body	double	No
radius	body	double	No
fq	body	Dictionary<string, List<Selection>>	No

**MemberBaseSharedDto** Parameters:
Name	Parameter	Data Type	Required	Description
MemberID	form	int	No

**BaseSharedDto** Parameters:
Name	Parameter	Data Type	Required
ClientID	form	int	No
ResponseStatus	form	ResponseStatus	No
BypassCache	form	bool	No
DateCached	form	DateTime	No
Device	form	Device	No

**JobSearchResponse** Parameters:
Name	Parameter	Data Type	Required	Description
response	form	Data	No

**Data** Parameters:
Name	Parameter	Data Type	Required
num_found	form	int	No
start	form	int	No
rows	form	int	No
sort	form	string	No
docs	form	Doc[]	No

**Doc** Parameters:
Name	Parameter	Data Type	Required
id	form	string	No
sitejobid	form	string	No
position	form	string	No
site_id	form	string	No
city	form	string[]	No
country	form	string[]	No
industry	form	string[]	No
location	form	string[]	No
region	form	string[]	No
state	form	string[]	No
zip	form	string[]	No
company	form	string	No
duration	form	string	No
education	form	string	No
entrylevel	form	bool	No
experience	form	string	No
function	form	string[]	No
sort	form	long	No
contact_email	form	string	No
contact_phone	form	string	No
contact_name	form	string	No
jobpool	form	bool	No
anonymous	form	bool	No
state_abbr	form	string[]	No
country_abbr	form	string[]	No
internship	form	bool	No
job_category	form	string	No
rank	form	string	No
powerpost	form	bool	No
spotlight	form	bool	No
origin_site_id	form	string	No
job_type	form	string	No
recruiter_id	form	string	No
salary	form	string	No
salary_currency	form	string	No
salary_high	form	string	No
salary_low	form	string	No
salary_type	form	string	No
security	form	string	No
travel	form	string	No
careerfair	form	string	No
description	form	string	No
latlon	form	string	No
latitude	form	string	No
longitude	form	string	No
network_vertical	form	string	No
requirements	form	string	No
source	form	string	No
source_id	form	string	No
apply_online	form	bool	No
apply_url	form	string	No
job_url	form	string	No
language	form	string	No
posted_date	form	DateTime	No
expire_date	form	DateTime	No
start_date	form	DateTime	No
updated	form	DateTime	No
featured	form	bool	No
preferred	form	bool	No
veteransupgrade	form	int	No
diversityupgrade	form	int	No
socialupgrade	form	int	No
link	form	string	No
is_saved	form	bool	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /Ymc/{ClientID}/Member/{MemberID}/JobSearch HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	q: String,
	start: 0,
	rows: 0,
	sort: String,
	lat: 0,
	lng: 0,
	radius: 0,
	fq: 
	{
		String: 
		[
			{
				Id: 0,
				Text: String
			}
		]
	},
	MemberID: 0,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2025-11-16T04:39:49.3938633-05:00,
	Device: Desktop
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	response: 
	{
		num_found: 0,
		start: 0,
		rows: 0,
		sort: String,
		docs: 
		[
			{
				id: String,
				sitejobid: String,
				position: String,
				site_id: String,
				city: 
				[
					String
				],
				country: 
				[
					String
				],
				industry: 
				[
					String
				],
				location: 
				[
					String
				],
				region: 
				[
					String
				],
				state: 
				[
					String
				],
				zip: 
				[
					String
				],
				company: String,
				duration: String,
				education: String,
				entrylevel: False,
				experience: String,
				function: 
				[
					String
				],
				sort: 0,
				contact_email: String,
				contact_phone: String,
				contact_name: String,
				jobpool: False,
				anonymous: False,
				state_abbr: 
				[
					String
				],
				country_abbr: 
				[
					String
				],
				internship: False,
				job_category: String,
				rank: String,
				powerpost: False,
				spotlight: False,
				origin_site_id: String,
				job_type: String,
				recruiter_id: String,
				salary: String,
				salary_currency: String,
				salary_high: String,
				salary_low: String,
				salary_type: String,
				security: String,
				travel: String,
				careerfair: String,
				description: String,
				latlon: String,
				latitude: String,
				longitude: String,
				network_vertical: String,
				requirements: String,
				source: String,
				source_id: String,
				apply_online: False,
				apply_url: String,
				job_url: String,
				language: String,
				posted_date: 0001-01-01,
				expire_date: 0001-01-01,
				start_date: 0001-01-01,
				updated: 0001-01-01,
				featured: False,
				preferred: False,
				veteransupgrade: 0,
				diversityupgrade: 0,
				socialupgrade: 0,
				link: String,
				is_saved: False
			}
		]
	},
	q: String,
	start: 0,
	rows: 0,
	sort: String,
	lat: 0,
	lng: 0,
	radius: 0,
	fq: 
	{
		String: 
		[
			{
				Id: 0,
				Text: String
			}
		]
	},
	MemberID: 0,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2025-11-16T04:39:49.4186287-05:00,
	Device: Desktop
}