The 8LEGS API allows you to search for job pages using REST principles.

Using the API

Request

8LEGS API requires Authorization header with API Key which you can find in "My account" tab after receiving access to the API.

Request attributes:

Required	Attribute	Type	Description
Yes	phrase	string	Searched phrase
Yes	country	string	Country code (one of: gb, us, au)
No	headersPhrase	string	Searched phrase in headers/bolds
No	zip	string	Zip code/Postcode for location radius (use with range)
No	range	number	Location radius in miles (use with zip)
No	pageNumber	number	Page number (default 1)

Response

Responses will be in the JSON format.

Response attributes:

Attribute	Type	Description
code	number	Successful response returns 0
message	string	Error message in case of code != 0
pageNumber	number	Requested page number
totalJobPages	number	Total number of job pages matching the criteria
totalResults	number	Total number of companies matching the criteria
totalPages	number	Total number of pages for use in pageNumber attribute
results	json	List of companies with nested job pages matching the criteria

Errors

8LEGS uses HTTP status codes to indicate success or failure of an API call. In general, status codes in the 2xx range means success, 4xx range means there was an error in the provided information, and those in the 5xx range indicates server side errors.

Besides HTTP status codes 8LEGS uses applications codes in the code field. Successful request returns 0 in the response.

List of possible codes:

Code	Message
3001	Missing API Key in header
3002	Invalid API Key
3012	Missing phrase parameter
3013	Missing country parameter
3021	Missing range parameter
3022	Missing zip parameter
3031	Invalid page number

Example

Search for "java developer" within 10 miles of SL1 1BZ in GB

curl -H "Authorization: 3a66db08-aa25-7365-dbe2-b29ca51f5f41" \
'https://www.8legs.com/api/searchJobPages?phrase="java%20developer"&country=gb&zip=SL1%201BZ&range=10&pageNumber=1'

{
    "code": 0,
    "pageNumber": 1,
    "results": [
        {
            "companyName": "Parexel",
            "jobPages": [
                {
                    "title": "Statistics Jobs | Jobs",
                    "url": "https://jobs.parexel.com/employment/united-kingdom-statistics-jobs/877/6954/6252001/2"
                }
            ],
            "zip": "ub8 1lz"
        },
        {
            "companyName": "H C L Technologies Europe Ltd",
            "jobPages": [
                {
                    "title": "Java/J2EE",
                    "url": "http://www.hcltech.com/print/careers/jobs-in-united-kingdom/sfo/javaj2ee"
                }
            ],
            "zip": "sl6 4fj"
        },
        {
            "companyName": "Search Technologies",
            "jobPages": [
                {
                    "title": "How Search and Big Data Make Recruiting",
                    "url": "http://www.searchtechnologies.com/search-big-data-analytics-recruiting"
                }
            ],
            "zip": "sl5 7bh"
        }
    ],
    "totalJobPages": 3,
    "totalPages": 1,
    "totalResults": 3
}
                    

Contact us if you would like to request API access.