Introduction

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.

Required Python Libraries

We will be using the requests library. Please ensure that you have it installed in your environment.

pip install requests

Next, import the requests library to your python file.

import requests

Authentication

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.

Compulsory Headers for All Requests

headers = {
    "Authorization": "Token xxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json"
}

Response Codes

HTTP Status Codes

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

Order Status Codes

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.

Filter Codes

The filters below are used to specify your search criteria for multiple endpoints, such as Profiles Filter Search and Profiles Count.

Industries

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

Industries Filters in JSON Format

{
    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"
}

Company Sizes

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

Company Sizes Filters in JSON Format

{
    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",
}

Seniority Levels

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

Seniority Levels Filters in JSON Format

{
    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",
}

Job Functions

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

Job Functions Filters in JSON Format

{
    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",
}

Profiles API

Profiles Filter Search Endpoints

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.

POST Profiles Filter Search

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.

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.

HTTP Request

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 <= 100 characters
None
lastName string <= 100 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.

Submit a Profile Search Order

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)

JSON Response from Submitting an Order

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
}

POST Profiles Linkedin URL Search

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.

HTTP Request

POST https://api.mantheos.com/profiles/linkedin-url/
Parameter Description
profileUrl string <= 200 characters
Full url of the profile

Submit a Profile Linkedin ULR Search Order

import requests

headers = {
    "Authorization": "Token xxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json"
}

url = "https://api.mantheos.com/profiles/linkedin-url/"

data = {
    "profileUrl": "https://www.linkedin.com/in/elon-musk",
}

response = requests.post(url, headers=headers, json=data)

POST Profiles Count

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.

HTTP Request

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 <= 100 characters
None
lastName string <= 100 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.

Sending Request to Count Endpoint

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)

JSON Response from Count Endpoint

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
}

GET Search History

Collect your search history using this endpoint. The history is sorted by datetime, with your latest search being the first object returned.

HTTP Request

GET https://api.mantheos.com/profiles/history/
Parameter Description
page integer >= 1
page_size integer 1 - 1000 (default = 50)

Sending Request to Profiles History Endpoint

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)

JSON Response from Search History

"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
}