|
|
Send a Listings Feed
<< back to feed page
Sample Job Feed Files
Oodle accepts job feed files in the CSV, Tab-Delimited, or XML formats. Here is a sample feed file for each of these formats:
CSV
Tab-Delimited
XML
Job Fields
Required Fields
Each job listing needs to include these fields.
Location Fields
The location fields indicate the location of the item being listed. For location-based search to work, it is highly recommended that each listing specify its location at least down to the city or zip/postal code level.
Additional Fields
The more of these additional fields that are included for a listing, the more likely that listing is to be found in searches.
Field Descriptions
| address |
| The street address of the listing. |
|
Format:
Text.
|
|
Example:
3459 Oak Street
|
| benefits |
| Benefits offered by the company for the job. |
|
Format:
Text. Allowed values include: 401K, child care, company car, dental, flexible spending, free food, health, stock, telecommuting, vision.
|
|
Example:
401K, child care
|
| category |
| The occupation of the job being listed. Here are some such categories. |
|
Format:
Text. Please be consistent in category names.
|
|
Example:
Recruiter Jobs
|
| city |
| The name of the city. Please use an official postal city name. |
|
Format:
Text.
|
|
Example:
Concord
|
| company |
| The name of the company with the job opening. |
|
Format:
Text.
|
|
Example:
Spool Software
|
| company_size |
| The number of people that work at the company. |
|
Format:
Number.
|
|
Example:
12,000
|
| country |
| The country abbreviation. |
Format:
Text. Preferably, the two letter ISO 3166 country code. |
|
Example:
US
|
| create_time |
| The date/time at which the listing was created. |
|
Format:
YYYY-MM-DD, or RSS format (i.e. 2004-07-16T14:00:00-07:00).
|
|
Example:
2004-07-16T14:00:00-07:00
|
| currency |
| The ISO 4217 three-letter currency code for the currency used in this listing. |
|
Format:
Text. By default, such fields as price and salary are assumed to be specified in the currency of the country the listing is located in, and this is sufficient for the vast majority of listings. Use this field to override this assumption.
|
|
Example:
USD
|
| description |
| A description of the listing. |
|
Format:
Text. Maximum length 20,000 bytes.
|
|
Example:
Recruiter needed to locate and hire engineers for this growing company. Join now and get stock options!
|
| employee_type |
| The characteristics of the employment being offered. Multiple characteristics may be included. |
|
Format:
Text. Recognized values include: Contractor, Employee, Full Time, Gig, Intern, Part Time, Permanent, Temporary, Volunteer.
|
|
Example:
Full Time Permanent
|
| expire_time |
| The date/time at which the listing expires. |
|
Format:
YYYY-MM-DD, or RSS format (i.e. 2004-09-16T14:00:00-07:00).
|
|
Example:
2004-09-16T14:00:00-07:00
|
| featured |
| Indicates that a particular listing should be featured. This field only works if prior arrangements have been made with Oodle. |
|
Format:
Text. Allowed values are: yes, no.
|
|
Example:
yes
|
| fee |
| Listing requires a fee to view the content (ie. requires registering at a fee-based site). |
|
Format:
Text. Allowed values are: yes, no.
|
|
Example:
yes
|
| hourly_rate |
| The hourly rate offered. If this job has a salary, then please use the salary field instead. |
|
Format:
Floating-point number. Please use the decimal point (.) rather than the comma to indicate cents. If a dash (-) is included between two such numbers, then the hourly rate is treated as a range.
|
|
Example:
12.50
|
| id |
| Unique ID for this listing. You must use the same id with a listing in subsequent versions of the feed. |
|
Format:
Text.
|
|
Example:
3916251
|
| industry |
| The industry the job is in. |
|
Format:
Text.
|
|
Example:
technology
|
| ip_address |
| The IP address of the user that the listing was posted from. |
|
Format:
IPv4 address in dot-decimal notation.
|
|
Example:
142.72.8.120
|
| latitude |
| Latitude, in degrees. |
|
Format:
Number.
|
|
Example:
37.5537
|
| longitude |
| Longitude, in degrees. |
|
Format:
Number.
|
|
Example:
-122.3038
|
| neighborhood |
| Neighborhood name. |
|
Format:
Text.
|
|
Example:
Willow Park
|
| registration |
| Listing requires registering at a site to view the content. |
|
Format:
Text. Allowed values are: yes, no.
|
|
Example:
yes
|
| required_education |
| The amount of education required. |
|
Format:
Text. Allowed values are: none, high school, 2 year degree, 4 year degree, graduate degree.
|
|
Example:
2 year degree
|
| required_experience |
| The minimum number of years of experience required for the position. |
|
Format:
Number of years, with optional trailing text.
|
|
Example:
4 years
|
| salary |
| The salary offered. |
|
Format:
Floating-point number. Please use the decimal point (.) rather than the comma to indicate cents. If a dash (-) is included between two such numbers, then the salary is treated as a range.
|
|
Example:
83000
|
| salary_type |
| The type of salary offered. |
|
Format:
Text. Allowed values are: hourly, bi-weekly, monthly, annually
|
|
Example:
hourly
|
| secondary_source |
| The name of the original source of the listings, if it is other than the provider of this feed. |
|
Format:
Text.
|
|
Example:
Pleasanton Listings
|
| seller_email |
| The email of the actual seller of the listing. |
|
Format:
Text.
|
|
Example:
joe@smith.com
|
| seller_name |
| The name of the actual seller of the listing. |
|
Format:
Text.
|
|
Example:
Joe Smith
|
| seller_phone |
| The phone number of the actual seller of the listing. |
|
Format:
Text.
|
|
Example:
123-456-7890
|
| seller_url |
| The URL of the actual seller of the listing. |
|
Format:
Fully qualified url.
|
|
Example:
http://smith-classifieds.com/
|
| state |
| The abbreviation for the province or state. |
|
Format:
Text. Please use standard abbreviations where possible.
|
|
Example:
CA
|
| title |
| The title of the listing. |
|
Format:
Text.
|
|
Example:
Recruiter Needed for Growing Company
|
| url |
| The URL of the details page for this listing. This URL must have relevent information about the listing. |
|
Format:
Fully qualified url.
|
|
Example:
http://www.example.com/listing/details.html
|
| zip_code |
| The postal code or zip code of the listing. |
|
Format:
Text. Please use a format standard to the postal codes of the country in question.
|
|
Example:
94772
|
<< back to feed page
|
