Welcome to the Mantheos API documentation. This documentation provides information on how you may access the API endpoints and consume them for the development of your solutions.
The API is based on the REST framework. Please keep in mind that all requests need to be made over SSL and encoded in JSON format.
Should you have further questions, feel free to contact us via support@mantheos.com.
To successfully consume the API you will require to pass in your API token under the
Authorization
header in each request. Should you not have an API
Token yet, please
contact us to receive one.
Please bear in mind to also specify the Content-Type
as application/json
format.
Our API returns standard HTTP success or error status codes as listed below.
Code | Title | Description |
---|---|---|
200 | Success | The request was successful |
202 | Accepted | The order has been successfully submitted |
400 | Bad Request | The request data has not been provided correctly |
401 | Unauthorized | Your API key is not authorised to access this endpoint |
403 | Forbidden | You do not have sufficient credits. Please top-up your account. |
404 | Not found | The endpoint does not exist |
50X | Internal Server Error | An error occurred on the server |
Aside from the standard HTTP codes we also provide additional status codes to indicate the progress
of your order. The status codes are delivered in the response under the status
attribute. The status
codes are listed in the table below.
Status Code | Description |
---|---|
-9 | You do not have access to this endpoint. Please contact us at support@mantheos.com to gain access to this endpoint. |
0 | Insufficient amount of credits. Please top-up your account. |
1 | Invalid request. |
9 | An error has occurred on the server side while processing the request. Please check if the filters are all set correctly. Should the error persist, please contact us at support@mantheos.com. |
10 | Your order has been submitted successfully and is being processed. Please wait for a
time interval as provided in the requestDataIn attribute
before collecting the data.
|
20 | Your order is still in process. Please collect the data once again after the time frame
of requestDataIn has elapsed to collect all the data. |
29 | Order has been processed, however the requested object does not exist. |
30 | Your order has been successfully processed. |
The filters below are used to specify your search criteria for multiple endpoints, such as Profiles Filter Search and Profiles Count.
ID | Description |
---|---|
0 | Accounting |
1 | Airlines/Aviation |
2 | Alternative Dispute Resolution |
3 | Alternative Medicine |
4 | Animation |
5 | Apparel & Fashion |
6 | Architecture & Planning |
7 | Arts and Crafts |
8 | Automotive |
9 | Aviation & Aerospace |
10 | Banking |
11 | Biotechnology |
12 | Broadcast Media |
13 | Building Materials |
14 | Business Supplies and Equipment |
15 | Capital Markets |
16 | Chemicals |
17 | Civic & Social Organization |
18 | Civil Engineering |
19 | Commercial Real Estate |
20 | Computer & Network Security |
21 | Computer Games |
22 | Computer Hardware |
23 | Computer Networking |
24 | Computer Software |
25 | Construction |
26 | Consumer Electronics |
27 | Consumer Goods |
28 | Consumer Services |
29 | Cosmetics |
30 | Dairy |
31 | Defense & Space |
32 | Design |
33 | Education Management |
34 | E-Learning |
35 | Electrical/Electronic Manufacturing |
36 | Entertainment |
37 | Environmental Services |
38 | Events Services |
39 | Executive Office |
40 | Facilities Services |
41 | Farming |
42 | Financial Services |
43 | Fine Art |
44 | Fishery |
45 | Food & Beverages |
46 | Food Production |
47 | Fund-Raising |
48 | Furniture |
49 | Gambling & Casinos |
50 | Glass, Ceramics & Concrete |
51 | Government Administration |
52 | Government Relations |
53 | Graphic Design |
54 | Health, Wellness and Fitness |
55 | Higher Education |
56 | Hospital & Health Care |
57 | Hospitality |
58 | Human Resources |
59 | Import and Export |
60 | Individual & Family Services |
61 | Industrial Automation |
62 | Information Services |
63 | Information Technology and Services |
64 | Insurance |
65 | International Affairs |
66 | International Trade and Development |
67 | Internet |
68 | Investment Banking |
69 | Investment Management |
70 | Judiciary |
71 | Law Enforcement |
72 | Law Practice |
73 | Legal Services |
74 | Legislative Office |
75 | Leisure, Travel & Tourism |
76 | Libraries |
77 | Logistics and Supply Chain |
78 | Luxury Goods & Jewelry |
79 | Machinery |
80 | Management Consulting |
81 | Maritime |
82 | Market Research |
83 | Marketing and Advertising |
84 | Mechanical or Industrial Engineering |
85 | Media Production |
86 | Medical Devices |
87 | Medical Practice |
88 | Mental Health Care |
89 | Military |
90 | Mining & Metals |
91 | Motion Pictures and Film |
92 | Museums and Institutions |
93 | Music |
94 | Nanotechnology |
95 | Newspapers |
96 | Non-Profit Organization Management |
97 | Oil & Energy |
98 | Online Media |
99 | Outsourcing/Offshoring |
100 | Package/Freight Delivery |
101 | Packaging and Containers |
102 | Paper & Forest Products |
103 | Performing Arts |
104 | Pharmaceuticals |
105 | Philanthropy |
106 | Photography |
107 | Plastics |
108 | Political Organization |
109 | Primary/Secondary Education |
110 | Printing |
111 | Professional Training & Coaching |
112 | Program Development |
113 | Public Policy |
114 | Public Relations and Communications |
115 | Public Safety |
116 | Publishing |
117 | Railroad Manufacture |
118 | Ranching |
119 | Real Estate |
120 | Recreational Facilities and Services |
121 | Religious Institutions |
122 | Renewables & Environment |
123 | Research |
124 | Restaurants |
125 | Retail |
126 | Security and Investigations |
127 | Semiconductors |
128 | Shipbuilding |
129 | Sporting Goods |
130 | Sports |
131 | Staffing and Recruiting |
132 | Supermarkets |
133 | Telecommunications |
134 | Textiles |
135 | Think Tanks |
136 | Tobacco |
137 | Translation and Localization |
138 | Transportation/Trucking/Railroad |
139 | Utilities |
140 | Venture Capital & Private Equity |
141 | Veterinary |
142 | Warehousing |
143 | Wholesale |
144 | Wine and Spirits |
145 | Wireless |
146 | Writing and Editing |
{
0: "Accounting",
1: "Airlines/Aviation",
2: "Alternative Dispute Resolution",
3: "Alternative Medicine",
4: "Animation",
5: "Apparel & Fashion",
6: "Architecture & Planning",
7: "Arts and Crafts",
8: "Automotive",
9: "Aviation & Aerospace",
10: "Banking",
11: "Biotechnology",
12: "Broadcast Media",
13: "Building Materials",
14: "Business Supplies and Equipment",
15: "Capital Markets",
16: "Chemicals",
17: "Civic & Social Organization",
18: "Civil Engineering",
19: "Commercial Real Estate",
20: "Computer & Network Security",
21: "Computer Games",
22: "Computer Hardware",
23: "Computer Networking",
24: "Computer Software",
25: "Construction",
26: "Consumer Electronics",
27: "Consumer Goods",
28: "Consumer Services",
29: "Cosmetics",
30: "Dairy",
31: "Defense & Space",
32: "Design",
33: "Education Management",
34: "E-Learning",
35: "Electrical/Electronic Manufacturing",
36: "Entertainment",
37: "Environmental Services",
38: "Events Services",
39: "Executive Office",
40: "Facilities Services",
41: "Farming",
42: "Financial Services",
43: "Fine Art",
44: "Fishery",
45: "Food & Beverages",
46: "Food Production",
47: "Fund-Raising",
48: "Furniture",
49: "Gambling & Casinos",
50: "Glass, Ceramics & Concrete",
51: "Government Administration",
52: "Government Relations",
53: "Graphic Design",
54: "Health, Wellness and Fitness",
55: "Higher Education",
56: "Hospital & Health Care",
57: "Hospitality",
58: "Human Resources",
59: "Import and Export",
60: "Individual & Family Services",
61: "Industrial Automation",
62: "Information Services",
63: "Information Technology and Services",
64: "Insurance",
65: "International Affairs",
66: "International Trade and Development",
67: "Internet",
68: "Investment Banking",
69: "Investment Management",
70: "Judiciary",
71: "Law Enforcement",
72: "Law Practice",
73: "Legal Services",
74: "Legislative Office",
75: "Leisure, Travel & Tourism",
76: "Libraries",
77: "Logistics and Supply Chain",
78: "Luxury Goods & Jewelry",
79: "Machinery",
80: "Management Consulting",
81: "Maritime",
82: "Market Research",
83: "Marketing and Advertising",
84: "Mechanical or Industrial Engineering",
85: "Media Production",
86: "Medical Devices",
87: "Medical Practice",
88: "Mental Health Care",
89: "Military",
90: "Mining & Metals",
91: "Motion Pictures and Film",
92: "Museums and Institutions",
93: "Music",
94: "Nanotechnology",
95: "Newspapers",
96: "Non-Profit Organization Management",
97: "Oil & Energy",
98: "Online Media",
99: "Outsourcing/Offshoring",
100: "Package/Freight Delivery",
101: "Packaging and Containers",
102: "Paper & Forest Products",
103: "Performing Arts",
104: "Pharmaceuticals",
105: "Philanthropy",
106: "Photography",
107: "Plastics",
108: "Political Organization",
109: "Primary/Secondary Education",
110: "Printing",
111: "Professional Training & Coaching",
112: "Program Development",
113: "Public Policy",
114: "Public Relations and Communications",
115: "Public Safety",
116: "Publishing",
117: "Railroad Manufacture",
118: "Ranching",
119: "Real Estate",
120: "Recreational Facilities and Services",
121: "Religious Institutions",
122: "Renewables & Environment",
123: "Research",
124: "Restaurants",
125: "Retail",
126: "Security and Investigations",
127: "Semiconductors",
128: "Shipbuilding",
129: "Sporting Goods",
130: "Sports",
131: "Staffing and Recruiting",
132: "Supermarkets",
133: "Telecommunications",
134: "Textiles",
135: "Think Tanks",
136: "Tobacco",
137: "Translation and Localization",
138: "Transportation/Trucking/Railroad",
139: "Utilities",
140: "Venture Capital & Private Equity",
141: "Veterinary",
142: "Warehousing",
143: "Wholesale",
144: "Wine and Spirits",
145: "Wireless",
146: "Writing and Editing"
}
ID | Description |
---|---|
0 | Self-employed |
1 | 1-10 employees |
2 | 11-50 employees |
3 | 51-200 employees |
4 | 201-500 employees |
5 | 501-1000 employees |
6 | 1001-5000 employees |
7 | 5001-10,000 employees |
8 | 10,001+ employees |
ID | Description |
---|---|
0 | Internship/Trainee |
1 | Entry-level |
2 | Senior |
3 | Manager |
4 | Director |
5 | Vice President (VP) |
6 | Chief X Officer (CXO) |
7 | Partner |
8 | Owner |
ID | Description |
---|---|
0 | Accounting |
1 | Administrative |
2 | Arts and Design |
3 | Business Development |
4 | Community & Social Services |
5 | Consulting |
6 | Education |
7 | Engineering |
8 | Entrepreneurship |
9 | Finance |
10 | Healthcare Services |
11 | Human Resources |
12 | Information Technology |
13 | Legal |
14 | Marketing |
15 | Media & Communications |
16 | Military & Protective Services |
17 | Operations |
18 | Product Management |
19 | Program & Product Management |
20 | Purchasing |
21 | Quality Assurance |
22 | Real Estate |
23 | Research |
24 | Sales |
25 | Support |
{
0: "Accounting",
1: "Administrative",
2: "Arts and Design",
3: "Business Development",
4: "Community & Social Services",
5: "Consulting",
6: "Education",
7: "Engineering",
8: "Entrepreneurship",
9: "Finance",
10: "Healthcare Services",
11: "Human Resources",
12: "Information Technology",
13: "Legal",
14: "Marketing",
15: "Media & Communications",
16: "Military & Protective Services",
17: "Operations",
18: "Product Management",
19: "Program & Product Management",
20: "Purchasing",
21: "Quality Assurance",
22: "Real Estate",
23: "Research",
24: "Sales",
25: "Support",
}
The Profiles Filter Search endpoints come in a POST & GET requests pair. They are the core of the Profiles API, and allow you (1) make an order to collect profiles using a specific search criteria using a POST request, and (2) collect the order containing the profiles data using a GET request after the data has been freshly aggregated. The returned profiles in the GET request are ranked by relevance.
This endpoint allows you to make a profile search order. Specify the search criteria based on the filter parameters below and the number of profiles you would like to collect. Each profile consumes one credit.
Using this endpoint you are able to collect up to 2500 profiles for each specific filter
combination, with up to 100 profiles in each request. Use the start
and
count
parameters to specify which profiles you would like to collect along the spectrum of 2500
profiles. As an example if you wish to collect 350 profiles use 4 following requests:
Request # | Start | Count |
---|---|---|
1 | 0 | 100 |
2 | 100 | 100 |
3 | 200 | 100 |
4 | 300 | 50 |
Should you wish to collect less than 100 profiles, keep start
to 0 and
specify
the amount of profiles
that you would like to collect in the count
parameter.
Please keep in mind that all filter parameters need to be passed in the request and none of the
arrays shall contain an empty string [""]
. You can leave the array
empty should you not wish to use that
filter.
After submitting the POST request, some time is required for the data to
be collected and processed.
The response data includes a requestDataIn
variable. This is how long
you should wait in
seconds before executing the GET request to collect the data.
POST https://api.mantheos.com/profiles/
Parameter | Description |
---|---|
keywordsStr |
string
<= 500 characters
Keywords that can be found in the whole profile. This includes name, skills, etc. |
firstName |
string
<= 1000 characters
None |
lastName |
string
<= 1000 characters
None |
locationsIncluded |
array
of strings
<= 40 characters
Cities or Countries. You can include multiple locations, separating them by commas. |
locationsExcluded |
array
of strings
<= 40 characters
Cities or Countries. You can exclude multiple locations, separating them by commas. |
companiesIncluded |
array
of strings
<= 200 characters
Company name or a keyword that a company name contains. You can include multiple companies, separating them by commas. |
companiesExcluded |
array
of strings
<= 200 characters
Company name or a keyword that a company name contains. You can exclude multiple companies, separating them by commas. |
titlesIncluded |
array
of strings
<= 40 characters
Job titles or keywords that a job title contains. You can include multiple job titles, separating them by commas. |
titlesExcluded |
array
of strings
<= 40 characters
Job titles or keywords that a job title contains. You can exclude multiple job titles, separating them by commas. |
industriesIncluded |
array
of integers
0 - 146
Define a list of industries to include. Refer to the Industries filters in the section above. |
industriesExcluded |
array
of integers
0 - 146
Define a list of industries to exclude. Refer to the Industries filters in the section above. |
companySizesIncluded |
array
of integers
0 - 8
Define a list of company sizes to include. Refer to the Company Sizes filters in the section above. |
seniorityLevelsIncluded |
array
of integers
0 - 8
Define a list of seniority levels to include. Refer to the Senority Levels filters in the section above. |
seniorityLevelsExcluded |
array
of integers
0 - 8
Define a list of seniority levels to exclude. Refer to the Senority Levels filters in the section above. |
jobFunctionsIncluded |
array
of integers
0 - 25
Define a list of job functions to include. Refer to the Job Functions filters in the section above. |
jobFunctionsExcluded |
array
of integers
0 - 25
Define a list of job functions to exclude. Refer to the Job Functions filters in the section above. |
start |
integer (required)
0 -
2499
The index of the first item you want results for. |
count |
integer (required)
1 -
100
The number of items you want included on each page of results. There could be fewer items remaining than the value you specify. |
import requests
headers = {
"Authorization": "Token xxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json"
}
url = "https://api.mantheos.com/profiles/"
filters = {
"keywordsStr": "we are hiring OR we're hiring",
"locationsIncluded": ["usa", "united kingdom", "australia"],
"locationsExcluded": [],
"companiesIncluded": [],
"companiesExcluded": [],
"titlesIncluded": ["human resource", "hr"],
"titlesExcluded": ["talent", "recruit"],
"industriesIncluded": [20, 24, 63, 67],
"industriesExcluded": [],
"companySizesIncluded": [3, 4, 5],
"seniorityLevelsIncluded": [2, 3, 4, 5],
"seniorityLevelsExcluded": [],
"jobFunctionsIncluded": [],
"jobFunctionsExcluded": [],
"start": 0,
"count": 10
}
response = requests.post(url, headers=headers, json=filters)
The response to the POST request contains the filters submitted including other important
information such as order id
, status
of the order and the requestDataIn
attribute.
Keep the provided order id
, as you will need it in the following
GET request to collect
the profiles data. Additionally, make sure that the status
of your
order is 10, which
means that your order has been submitted successfully and is being processed. Should the status
contain a different value, please check the status table above
to understand the error code.
As the next step you will need to send a GET request to collect the
requested profiles. The data processing time is indicated by the requestDataIn
attribute.
This value is provided in seconds. You may make a GET request to the search endpoint to collect
the data after this time.
"request": {
"id": "aeb3166a-a8d9-4eea-b2f0-4f18de8d24c3",
"timestampCreated": "2020-07-12T21:00:00.000000+08:00",
"keywordsStr": "we are hiring OR we're hiring",
"locationsIncluded": ["usa", "united kingdom", "australia"],
"locationsExcluded": [],
"companiesIncluded": [],
"companiesExcluded": [],
"titlesIncluded": ["human resource", "hr"],
"titlesExcluded": ["talent", "recruit"],
"industriesIncluded": [20, 24, 63, 67],
"industriesExcluded": [],
"companySizesIncluded": [3, 4, 5],
"seniorityLevelsIncluded": [2, 3, 4, 5],
"seniorityLevelsExcluded": [],
"jobFunctionsIncluded": [],
"jobFunctionsExcluded": [],
"start": 0,
"count": 10,
"requestDataIn": "6.0",
"status": 10
},
"info": {
"credits": 10000,
"profiles_available": 269
}
Collect the processed data by specifying the order id
that you have
received
in response of the previous POST Profiles Filter Search response as shown
above.
GET https://api.mantheos.com/profiles/?id={order id}
Replace the id
parameter in the url below with the id
you have received in the POST Profile Search request.
import requests
headers = {
"Authorization": "Token xxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json"
}
url = "https://api.mantheos.com/profiles/?id=aeb3166a-a8d9-4eea-b2f0-4f18de8d24c3"
response = requests.get(url, headers=headers)
Profile data that has been collected can be found in the "profiles" array.
"results": {
"id": "aeb3166a-a8d9-4eea-b2f0-4f18de8d24c3",
"timestampCreated": "2020-07-12T21:00:00.000000+08:00",
"keywordsStr": "we are hiring OR we're hiring",
"locationsIncluded": ["usa", "united kingdom", "australia"],
"locationsExcluded": [],
"companiesIncluded": [],
"companiesExcluded": [],
"titlesIncluded": ["human resource", "hr"],
"titlesExcluded": ["talent", "recruit"],
"industriesIncluded": [20, 24, 63, 67],
"industriesExcluded": [],
"companySizesIncluded": [3, 4, 5],
"seniorityLevelsIncluded": [2, 3, 4, 5],
"seniorityLevelsExcluded": [],
"jobFunctionsIncluded": [],
"jobFunctionsExcluded": [],
"start": 0,
"count": 10,
"numProfilesCollected": 10,
"status": 30,
"profiles": [
{
"id": "997b64ba-e252-4b47-beb7-2f6215c3ec50",
"firstName": "John",
"lastName": "Doe",
"location": "Greater Colorado Springs Area",
"headline": "Hiring Manager at Mars",
"summary": "Lorem, ipsum dolor sit amet consectetur adipisicing elit.",
"industry": "Computer Software",
"workExperience": [
{
"title": "Human Resource Partner",
"location": "Colorado Springs, Colorado, United States",
"companyID": "9120123",
"startedOn": {
"year": 1990,
"month": 5
},
"companyName": "Mars",
"description": "Lorem, ipsum dolor sit amet consectetur adipisicing elit."
},
...
],
"education": [
{
"degree": "Bachelor of Business",
"endedOn": {
"year": 2015
},
"startedOn": {
"year": 2011
},
"schoolName": "University of Mars",
"fieldsOfStudy": [
"Human Resources Management"
]
},
...
],
"skills": [
"React.js",
"API Development",
"Express.js",
"Science",
"Laboratory",
"Microbiology",
"Molecular Biology",
"Object-Oriented Programming (OOP)",
"HTML5",
"Cascading Style Sheets (CSS)",
"Bootstrap",
"JavaScript",
"jQuery",
"GitHub",
"Node.js",
"JSON",
"AJAX",
"Ruby on Rails",
"HTML",
"CSS3"
],
"coursesTaken": [
{
"name": "Presentation",
"number": "3"
},
...
],
"languages": [
{
"name": "English",
"proficiency": "FULL_PROFESSIONAL"
},
...
],
"awards": [
{
"title": "Master Toastmaster",
"issuer": "Toastmasters Club",
"issuedOn": {
"year": 2015,
"month": 5
},
"description": "Lorem, ipsum dolor sit amet consectetur adipisicing elit."
},
...
],
"memberships": [
{
"name": "Toastmasters Club",
"endedOn": {
"year": 2016,
"month": 6
},
"position": "President",
"startedOn": {
"year": 2015,
"month": 1
},
"description": "Lorem ipsum dolor sit amet consectetur adipisicing elit."
},
...
],
"certifications": [
{
"url": "https://www.example.com/",
"name": "Machine Learning in HR",
"endedOn": {
"year": 2015,
"month": 4
},
"authority": "Mars Academy",
"companyID": "12345",
"startedOn": {
"year": 2014,
"month": 5
},
"licenseNumber": "123456"
},
...
],
"volunteeringExperiences": [
{
"role": "Team Lead",
"cause": "humanitarianRelief",
"endedOn": {
"year": 2014,
"month": 4
},
"companyID": "12346",
"startedOn": {
"year": 2013,
"month": 4
},
"companyName": "Mars Humanitarian",
"description": "Lorem ipsum dolor sit amet consectetur adipisicing elit."
}
],
"projects": [
{
"url": "https://www.example.com/",
"title": "Lorem ipsum dolor",
"endedOn": {
"year": 2016,
"month": 2
},
"startedOn": {
"year": 2015,
"month": 4
},
"description": "Lorem ipsum dolor sit amet consectetur adipisicing elit."
}
],
"publications": [
{
"url": "https://www.example.com/",
"name": "Lorem ipsum dolor",
"publisher": "Mars Publications",
"description": "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
"publishedOn": {
"day": 13,
"year": 2015,
"month": 4
}
}
],
"patents": [
{
"url": "https://www.example.com/",
"title": "Lorem ipsum dolor",
"issuedIn": "us",
"issuedOn": {
"day": 13,
"year": 2015,
"month": 4
},
"description": "Lorem ipsum dolor sit amet consectetur adipisicing elit."
}
],
"emails": [
{
"dataSource": "LINKEDIN",
"emailAddress": "john.doe@example.com"
},
...
],
"websites": [
{
"url": "https://www.company-site.com/",
"category": "COMPANY",
"dataSource": "LINKEDIN"
},
{
"url": "https://www.personal-site.com",
"category": "PERSONAL",
"dataSource": "LINKEDIN"
}
],
"socialAccounts": [
{
"name": "JohnDoe",
"type": "WECHAT",
"dataSource": "LINKEDIN"
},
{
"name": "JohnDoe",
"type": "TWITTER",
"dataSource": "LINKEDIN"
}
],
"linkedinProfileURL": "https://www.linkedin.com/in/johndoe",
"linkedinInfluencer": null,
"linkedinOpenLink": true,
"linkedinPremium": true
},
...
]
},
"info": {
"credits": 10000,
"profiles_available": 200000
}
This endpoint allows you to search for profiles via the provided Linkedin URL of the profile. Please ensure that the provided profile URL contains at least the basic structure as "linkedin.com/in/profile-id"
.
This endpoint processes one profile at a time. The profile data will be provided instantly in the response of this POST request with the equivalent structure as in the Profiles Filter Search request.
POST https://api.mantheos.com/profiles/linkedin-url/
Parameter | Description |
---|---|
profileUrl |
string
<= 200 characters
Full url of the profile |
The Profiles Count endpoint allows you to find out how many profiles are matching your filter criteria without consuming credits. Input your search filters using the parameters below. Ensure that the restrictions for each parameter have been accounted for.
Please keep in mind that all filter parameters need to be passed in the request and none of
the
arrays shall contain an empty string [""]
. You can leave the
array empty should you not wish to use that
filter.
POST https://api.mantheos.com/profiles/count/
Parameter | Description |
---|---|
keywordsStr |
string
<= 500 characters
Keywords that can be found in the whole profile. This includes name, skills, etc. |
firstName |
string
<= 1000 characters
None |
lastName |
string
<= 1000 characters
None |
locationsIncluded |
array
of strings
<= 40 characters
Cities or Countries. You can include multiple locations, separating them by commas. |
locationsExcluded |
array
of strings
<= 40 characters
Cities or Countries. You can exclude multiple locations, separating them by commas. |
companiesIncluded |
array
of strings
<= 200 characters
Company name or a keyword that a company name contains. You can include multiple companies, separating them by commas. |
companiesExcluded |
array
of strings
<= 200 characters
Company name or a keyword that a company name contains. You can exclude multiple companies, separating them by commas. |
titlesIncluded |
array
of strings
<= 40 characters
Job titles or keywords that a job title contains. You can include multiple job titles, separating them by commas. |
titlesExcluded |
array
of strings
<= 40 characters
Job titles or keywords that a job title contains. You can exclude multiple job titles, separating them by commas. |
industriesIncluded |
array
of integers
0 - 146
Define a list of industries to include. Refer to the Industries filters in the section above. |
industriesExcluded |
array
of integers
0 - 146
Define a list of industries to exclude. Refer to the Industries filters in the section above. |
companySizesIncluded |
array
of integers
0 - 8
Define a list of company sizes to include. Refer to the Company Sizes filters in the section above. |
seniorityLevelsIncluded |
array
of integers
0 - 8
Define a list of seniority levels to include. Refer to the Senority Levels filters in the section above. |
seniorityLevelsExcluded |
array
of integers
0 - 8
Define a list of seniority levels to exclude. Refer to the Senority Levels filters in the section above. |
jobFunctionsIncluded |
array
of integers
0 - 25
Define a list of job functions to include. Refer to the Job Functions filters in the section above. |
jobFunctionsExcluded |
array
of integers
0 - 25
Define a list of job functions to exclude. Refer to the Job Functions filters in the section above. |
start |
integer (required)
0 -
2499
The index of the first item you want results for. |
count |
integer (required)
1 -
100
The number of items you want included on each page of results. There could be fewer items remaining than the value you specify. |
import requests
headers = {
"Authorization": "Token xxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json"
}
url = "https://api.mantheos.com/profiles/count/"
filters = {
"keywordsStr": "we are hiring OR we're hiring",
"locationsIncluded": ["usa", "united kingdom", "australia"],
"locationsExcluded": [],
"companiesIncluded": [],
"companiesExcluded": [],
"titlesIncluded": ["human resource", "hr"],
"titlesExcluded": ["talent", "recruit"],
"industriesIncluded": [20, 24, 63, 67],
"industriesExcluded": [],
"companySizesIncluded": [3, 4, 5],
"seniorityLevelsIncluded": [2, 3, 4, 5],
"seniorityLevelsExcluded": [],
"jobFunctionsIncluded": [],
"jobFunctionsExcluded": [],
"start": 0,
"count": 10
}
response = requests.post(url, headers=headers, json=filters)
Number of profiles that match your search criteria can be found in "profiles_available" under "info"
"filters": {
"keywordsStr": "we are hiring OR we're hiring",
"locationsIncluded": ["usa", "united kingdom", "australia"],
"locationsExcluded": [],
"companiesIncluded": [],
"companiesExcluded": [],
"titlesIncluded": ["human resource", "hr"],
"titlesExcluded": ["talent", "recruit"],
"industriesIncluded": [20, 24, 63, 67],
"industriesExcluded": [],
"companySizesIncluded": [3, 4, 5],
"seniorityLevelsIncluded": [2, 3, 4, 5],
"seniorityLevelsExcluded": [],
"jobFunctionsIncluded": [],
"jobFunctionsExcluded": [],
"status": 30
},
"request_stats": {
"seniorityLevel": [
{
"count": 166,
"value": "Senior"
},
{
"count": 73,
"value": "Entry"
},
{
"count": 69,
"value": "Manager"
},
{
"count": 56,
"value": "Director"
},
{
"count": 18,
"value": "VP"
},
{
"count": 8,
"value": "CXO"
},
{
"count": 6,
"value": "Owner"
},
{
"count": 4,
"value": "Internship"
},
{
"count": 4,
"value": "Partner"
}
],
"industry": [
{
"count": 1052,
"value": "Human Resources"
},
{
"count": 157,
"value": "Staffing and Recruiting"
},
{
"count": 140,
"value": "Information Technology and Services"
},
{
"count": 109,
"value": "Hospital & Health Care"
},
{
"count": 92,
"value": "Computer Software"
},
{
"count": 80,
"value": "Financial Services"
},
{
"count": 68,
"value": "Construction"
},
{
"count": 55,
"value": "Nonprofit Organization Management"
},
{
"count": 52,
"value": "Insurance"
},
{
"count": 43,
"value": "Marketing and Advertising"
},
{
"count": 42,
"value": "Government Administration"
},
{
"count": 41,
"value": "Higher Education"
},
{
"count": 38,
"value": "Management Consulting"
},
{
"count": 28,
"value": "Internet"
},
{
"count": 9,
"value": "Computer & Network Security"
}
],
"companySize": [
{
"count": 13,
"value": "Self-employed"
},
{
"count": 57,
"value": "1-10"
},
{
"count": 87,
"value": "11-50"
},
{
"count": 130,
"value": "51-200"
},
{
"count": 84,
"value": "201-500"
},
{
"count": 61,
"value": "501-1000"
},
{
"count": 136,
"value": "1001-5000"
},
{
"count": 55,
"value": "5001-10,000"
},
{
"count": 290,
"value": "10,000+"
}
],
"function": [
{
"count": 265,
"value": "Human Resources"
},
{
"count": 25,
"value": "Business Development"
},
{
"count": 17,
"value": "Operations"
},
{
"count": 15,
"value": "Information Technology"
},
{
"count": 13,
"value": "Administrative"
},
{
"count": 9,
"value": "Consulting"
},
{
"count": 5,
"value": "Accounting"
},
{
"count": 5,
"value": "Finance"
},
{
"count": 5,
"value": "Education"
},
{
"count": 4,
"value": "Legal"
},
{
"count": 4,
"value": "Media and Communication"
},
{
"count": 4,
"value": "Support"
},
{
"count": 4,
"value": "Engineering"
},
{
"count": 3,
"value": "Sales"
},
{
"count": 3,
"value": "Arts and Design"
}
]
},
"info": {
"credits": 10000,
"profiles_available": 269
}
Collect your search history using this endpoint. The history is sorted by datetime, with your latest search being the first object returned.
GET https://api.mantheos.com/profiles/history/
Parameter | Description |
---|---|
page |
integer >= 1 |
page_size |
integer 1 - 1000 (default = 50) |
import requests
headers = {
"Authorization": "Token xxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json"
}
# page and page_size are optional fields
url = "https://api.mantheos.com/profiles/history/?page=2&page_size=50"
response = requests.get(url, headers=headers)
"links": {
"next": "https://api.mantheos.com/profiles/history/?page=3&page_size=50",
"previous": "https://api.mantheos.com/profiles/history/?page_size=50"
},
"count": 150,
"results": [
{
"id": "aeb3166a-a8d9-4eea-b2f0-4f18de8d24c3",
"timestampCreated": "2020-07-12T21:00:00.000000+08:00",
"keywordsStr": "we are hiring OR we're hiring",
"locationsIncluded": ["usa", "united kingdom", "australia"],
"locationsExcluded": [],
"companiesIncluded": [],
"companiesExcluded": [],
"titlesIncluded": ["human resource", "hr"],
"titlesExcluded": ["talent", "recruit"],
"industriesIncluded": [20, 24, 63, 67],
"industriesExcluded": [],
"companySizesIncluded": [3, 4, 5],
"seniorityLevelsIncluded": [2, 3, 4, 5],
"seniorityLevelsExcluded": [],
"jobFunctionsIncluded": [],
"jobFunctionsExcluded": [],
"start": 0,
"count": 10,
"requestDataIn": 6.0,
"status": 30
},
...
],
"info": {
"credits": 10000
}