--- agentTools: projectIndex: https://muraena.readme.io/llms.txt --- # People Search Returns list of people profiles by your criteria This is a POST endpoint that accepts various filters related to the person and the person's company as a JSON payload, and returns a list of people profiles based on the provided criteria. Filters related to the person start with "person\_", while company filters start with "company\_". Company filters are applied to the current person's company. We charge 1 credit per 1 successful request. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Muraena API", "version": "1.0" }, "servers": [ { "url": "https://contacts.muraena.ai/api/client_api/" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "token" } } }, "security": [ { "sec0": [] } ], "paths": { "/search/": { "post": { "summary": "People Search", "description": "Returns list of people profiles by your criteria", "operationId": "person-search", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "person_functional_areas": { "type": "array", "description": "List of functional areas of target profiles, takes values from \"Functional Areas list\" endpoint", "items": { "type": "string" } }, "person_job_titles": { "type": "array", "description": "List of titles or title-specific keywords, like [\"Backend Engineer\", \"Python\", \"Backend Development\"]", "items": { "type": "string" } }, "person_industries": { "type": "array", "description": "List of person industries, takes values from \"Industries list\" endpoint", "items": { "type": "string" } }, "person_locations": { "type": "array", "description": "List of person locations (location = city or state). You can obtain full list of locations in Meta requests section.", "items": { "type": "string" } }, "person_countries": { "type": "array", "description": "List of countries, where person is located. Takes values from \"Countries list\" endpoint", "items": { "type": "string" } }, "person_subregions": { "type": "array", "description": "List of sub-regions, where person is located. Takes values from \"Sub-regions list\" endpoint", "items": { "type": "string" } }, "person_regions": { "type": "array", "description": "List of regions, where person is located. Takes values from \"Regions list\" endpoint", "items": { "type": "string" } }, "person_first_name": { "type": "string", "description": "First name of the person" }, "person_last_name": { "type": "string", "description": "Last name of the person" }, "company_keywords": { "type": "array", "description": "List of company keywords, like [\"sales agency\", \"email marketing\", \"blockchain development\"]", "items": { "type": "string" } }, "company_headcount": { "type": "array", "description": "Range of company headcount, accepts list of 2 values, i.e [10,50]. Possible ranges are - 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5000-10000, 10001-100000", "items": { "type": "integer", "format": "int32" } }, "company_buyers_intent": { "type": "array", "description": "List of company intent topics, takes values from \"Buyers Intent list\" endpoint", "items": { "type": "string" } }, "company_technographics": { "type": "array", "description": "List of technologies, used by the company, takes values from \"Technographics list\" endpoint", "items": { "type": "string" } }, "company_funding_amount": { "type": "array", "description": "Range of funding amount, raised by the company. Accepts list of 2 values, i.e [100000,500000]", "items": { "type": "integer", "format": "int32" } }, "company_last_funding_date": { "type": "string", "description": "Datetime, after which company have raised funding. For example, \"2024-03-20\"", "format": "date" }, "company_linkedin_urls": { "type": "array", "description": "List of companies LinkedIn URLs, f.e to get all Google employees - [\"https://linkedin.com/company/google\"]", "items": { "type": "string" } }, "company_domains": { "type": "array", "description": "List of companies domains, f.e to get all Google employees - [\"google.com\"]", "items": { "type": "string" } }, "company_names": { "type": "array", "description": "List of companies names", "items": { "type": "string" } }, "company_lookalike": { "type": "array", "description": "List of domains (the more the better), for which we'll return employees from similar companies (by niche, industry, location, etc)", "items": { "type": "string" } }, "negative_person_functional_areas": { "type": "array", "description": "List of functional areas of target profiles to negate (exclude), takes values from \"Functional Areas list\" endpoint", "items": { "type": "string" } }, "negative_person_job_titles": { "type": "array", "description": "List of titles or title-specific keywords to negate (exclude), f.e \"Retired\"", "items": { "type": "string" } }, "negative_person_industries": { "type": "array", "description": "List of person industries to negate (exclude), takes values from \"Industries list\" endpoint", "items": { "type": "string" } }, "negative_company_keywords": { "type": "array", "description": "List of company keywords to negate (exclude), like [\"agency\"]", "items": { "type": "string" } }, "negative_company_technographics": { "type": "array", "description": "List of technologies, used by the company, to negate (exclude); takes values from \"Technographics list\" endpoint", "items": { "type": "string" } }, "negative_company_buyers_intent": { "type": "array", "description": "List of company intent topics to negate (exclude), takes values from \"Buyers Intent list\" endpoint", "items": { "type": "string" } }, "negative_company_names": { "type": "array", "description": "List of negative company names", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"count\": 39781,\n \"next\": \"http://contacts.muraena.ai/api/client_api/search/?page=2\",\n \"previous\": null,\n \"results\": [\n {\n \"profile_id\": 712644402,\n \"country\": \"United States\",\n \"first_name\": \"Ray\",\n \"last_name\": \"Peraza\",\n \"location\": \"Fort Lauderdale, Florida\",\n \"title\": \"Senior IT Recruiter at ProsourceIT\",\n \"industry\": \"Staffing & Recruiting\",\n \"functional_area\": [\n \"HR & Recruitment\"\n ],\n \"company\": \"Prosourceit\",\n \"company_domain\": \"prosourceit.net\",\n \"company_country\": \"United States\",\n \"company_industry\": \"Staffing and Recruiting\",\n \"linkedin_url\": \"https://www.linkedin.com/in/rayperaza/\",\n \"company_linkedin_url\": \"https://www.linkedin.com/company/prosourceit/\"\n },\n {\n \"profile_id\": 843146651,\n \"country\": \"United States\",\n \"first_name\": \"Avetis\",\n \"last_name\": \"Antaplyan\",\n \"location\": \"Los Angeles, California\",\n \"title\": \"Founder & CEO at HIRECLOUT (Now Hiring) \",\n \"industry\": \"Management, Scientific, & Technical Consulting Services\",\n \"functional_area\": [\n \"C-level/Leadership\"\n ],\n \"company\": \"Hireclout\",\n \"company_domain\": \"hireclout.com\",\n \"company_country\": \"United States\",\n \"company_industry\": \"IT Services and IT Consulting\",\n \"linkedin_url\": \"https://www.linkedin.com/in/yourpartnerrecruiteravetis/\",\n \"company_linkedin_url\": \"https://www.linkedin.com/company/hireclout/\"\n },\n {\n \"profile_id\": 282713652,\n \"country\": \"United States\",\n \"first_name\": \"Alexis\",\n \"last_name\": \"Palmer\",\n \"location\": \"Boulder, Colorado\",\n \"title\": \"Recruiter - Specializing in Early-Stage, High-Growth Food/Bev & Consumer Goods\",\n \"industry\": \"Staffing & Recruiting\",\n \"functional_area\": [\n \"HR & Recruitment\"\n ],\n \"company\": \"Creative Alignments\",\n \"company_domain\": \"creativealignments.com\",\n \"company_country\": \"United States\",\n \"company_industry\": \"Staffing and Recruiting\",\n \"linkedin_url\": \"https://www.linkedin.com/in/alexisputzelpalmer/\",\n \"company_linkedin_url\": \"https://www.linkedin.com/company/creative-alignments/\"\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "count": { "type": "integer", "example": 39781, "default": 0 }, "next": { "type": "string", "example": "http://contacts.muraena.ai/api/client_api/search/?page=2" }, "previous": {}, "results": { "type": "array", "items": { "type": "object", "properties": { "profile_id": { "type": "integer", "example": 712644402, "default": 0 }, "country": { "type": "string", "example": "United States" }, "first_name": { "type": "string", "example": "Ray" }, "last_name": { "type": "string", "example": "Peraza" }, "location": { "type": "string", "example": "Fort Lauderdale, Florida" }, "title": { "type": "string", "example": "Senior IT Recruiter at ProsourceIT" }, "industry": { "type": "string", "example": "Staffing & Recruiting" }, "functional_area": { "type": "array", "items": { "type": "string", "example": "HR & Recruitment" } }, "company": { "type": "string", "example": "Prosourceit" }, "company_domain": { "type": "string", "example": "prosourceit.net" }, "company_country": { "type": "string", "example": "United States" }, "company_industry": { "type": "string", "example": "Staffing and Recruiting" }, "linkedin_url": { "type": "string", "example": "https://www.linkedin.com/in/rayperaza/" }, "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/prosourceit/" } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "_id": "66743c95409d14003649d829:6673691b565107002a15147b" } ```