--- updatedAt: 2026-05-14T06:28:46.000Z agentTools: projectIndex: https://docs.a-leads.co/llms.txt --- # Advanced Search ### Available Values Reference The possible values for the following filters can be referred from the json file attached below. * `experimental_member_department` * `excluded_experimental_department` * `sic_codes` * `naics_codes` * `experimental_industries` * `excluded_experimental_industries` * `technologies_used` * `excluded_technologies_used` * `job_title` * `excluded_job_title` These values can be used for filtering and refining results in your application.\ Please refer to the JSON file for the complete list. [https://storage.a-leads.co/public/filters/filter\_possible\_values.json](https://storage.a-leads.co/public/filters/filter-possible-values.json) ## Rate Limits * **200requests per minute** * **600 requests per hour** * **6,000 requests per day** # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Advanced Search API", "version": "1.0.0", "description": "API for performing advanced searches using multiple filters." }, "servers": [ { "url": "https://api.a-leads.co/gateway/v1/search", "description": "Production server" }, { "url": "https://api.a-leads.co/gateway/v1/search", "description": "Staging server" } ], "paths": { "/advanced-search": { "post": { "summary": "Advanced Search", "tags": [ "Search" ], "security": [ { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "advanced_filters": { "type": "object", "description": "Filters to refine the search", "properties": { "member_full_name": { "type": "string", "description": "Free-text search query to look for matching individuals by name.", "example": "John Doe", "x-readme-id": "1.0" }, "job_title": { "type": "array", "items": { "type": "string" }, "description": "Filter by specific job titles of potential leads (e.g., Marketing Manager, CTO)", "example": [ "Marketing Manager", "CTO" ], "x-readme-id": "1.1" }, "excluded_job_title": { "type": "array", "items": { "type": "string" }, "description": "Filter by specific job titles to be excluded of potential leads (e.g., Marketing Manager, CTO)", "example": [ "Marketing Manager", "CTO" ], "x-readme-id": "1.2" }, "member_skills": { "type": "array", "items": { "type": "string" }, "description": "Find leads with specific professional skills listed on their profiles.", "example": [ "C++", "Python" ], "x-readme-id": "1.3" }, "excluded_member_skills": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads who have specific professional skills listed on their profiles.", "example": [ "C++", "Python" ], "x-readme-id": "1.4" }, "member_linkedin_username": { "type": "array", "items": { "type": "string" }, "description": "Filter by specific linkedin profile usernames or linkedin url", "example": [ "https://www.linkedin.com/in/john-doe-15", "john-doe-15" ], "x-readme-id": "1.9" }, "excluded_member_linkedin_username": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by specific linkedin profile usernames or linkedin url", "example": [ "https://www.linkedin.com/in/john-doe-15", "john-doe-15" ], "x-readme-id": "1.10" }, "member_location_raw_address": { "type": "array", "items": { "type": "string" }, "description": "Filter leads by their listed geographic location.", "example": [ "India", "Seattle" ], "x-readme-id": "1.11" }, "excluded_member_location_raw_address": { "type": "array", "items": { "type": "string" }, "description": "Excluded leads by their listed geographic location.", "example": [ "India", "Seattle" ], "x-readme-id": "1.12" }, "member_description": { "type": "array", "items": { "type": "string" }, "description": "Filter by keywords found in profile summaries or descriptions.", "example": [ "Machine Learning", "Software Engineering" ], "x-readme-id": "1.13" }, "excluded_member_description": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by keywords found in profile summaries or descriptions.", "example": [ "Machine Learning", "Software Engineering" ], "x-readme-id": "1.14" }, "member_management_level": { "type": "array", "items": { "type": "string" }, "description": "Filter by seniority or management level.\n\nPossible values:\n- Specialist\n- Manager\n- Owner\n- Founder\n- President/Vice President\n- Director\n- Senior\n- Head\n- C-Level\n- Partner\n- Intern", "example": [ "Manager", "Founder" ], "x-readme-id": "1.15" }, "excluded_member_management_level": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by seniority or management level.\n\nPossible values:\n- Specialist\n- Manager\n- Owner\n- Founder\n- President/Vice President\n- Director\n- Senior\n- Head\n- C-Level\n- Partner\n- Intern", "example": [ "Manager", "Founder" ], "x-readme-id": "1.16" }, "organizations": { "type": "array", "items": { "type": "string" }, "description": "Filter for specific organizations by entering the organizations names", "example": [ "Google", "AWS" ], "x-readme-id": "1.21" }, "bulk_domains": { "type": "string", "description": "Filter leads based on company domain. Provide one or more domains separated by commas or new lines.\n\nExample input:\nwww.google.com, www.amazon.com\nor\nwww.google.com\nwww.amazon.com", "example": "www.google.com, www.amazon.com", "x-readme-id": "1.23" }, "excluded_bulk_domains": { "type": "string", "description": "Exclude leads based on company domain. Provide one or more domains separated by commas or new lines.\n\nExample input:\nwww.google.com, www.amazon.com\nor\nwww.google.com\nwww.amazon.com", "example": "www.google.com, www.amazon.com", "x-readme-id": "1.24" }, "company_linkedin_username": { "type": "array", "items": { "type": "string" }, "description": "Filter by specific company linkedin profile usernames or url", "example": [ "https://www.linkedin.com/company/google/", "google" ], "x-readme-id": "1.25" }, "excluded_company_linkedin_username": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by specific company linkedin profile usernames or url", "example": [ "https://www.linkedin.com/company/google/", "google" ], "x-readme-id": "1.26" }, "company_type": { "type": "array", "items": { "type": "string" }, "description": "Filter leads by company type.\n\nPossible values:\n- Privately Held\n- Public Company\n- Self-Owned\n- Partnership\n- Self-Employed\n- Nonprofit\n- Educational\n- Government Agency", "example": [ "Privately Held" ], "x-readme-id": "1.27" }, "excluded_company_type": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by company type.\n\nPossible values:\n- Privately Held\n- Public Company\n- Self-Owned\n- Partnership\n- Self-Employed\n- Nonprofit\n- Educational\n- Government Agency", "example": [ "Privately Held" ], "x-readme-id": "1.28" }, "sic_codes": { "type": "array", "items": { "type": "string" }, "description": "Filter by Standard Industrial Classification codes (SIC).", "example": [ "35", "42" ], "x-readme-id": "1.29" }, "excluded_sic_codes": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by Standard Industrial Classification codes (SIC).", "example": [ "35", "42" ], "x-readme-id": "1.30" }, "naics_codes": { "type": "array", "items": { "type": "string" }, "description": "Filter by North American Industry Classification System codes (NAICS).", "example": [ "1111", "111339" ], "x-readme-id": "1.31" }, "excluded_naics_codes": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by North American Industry Classification System codes (NAICS).", "example": [ "1111", "111339" ], "x-readme-id": "1.32" }, "categories_and_keywords": { "type": "array", "items": { "type": "string" }, "description": "Filter by keywords found in company descriptions or specialties.", "example": [ "machine learning", "google analytics" ], "x-readme-id": "1.33" }, "excluded_categories_and_keywords": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by keywords found in company descriptions or specialties.", "example": [ "machine learning", "google analytics" ], "x-readme-id": "1.34" }, "hq_location": { "type": "array", "items": { "type": "string" }, "description": "Filter leads by company headquarters location.", "example": [ "Canada", "Seattle" ], "x-readme-id": "1.35" }, "excluded_hq_location": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by company headquarters location.", "example": [ "Canada", "Seattle" ], "x-readme-id": "1.36" }, "experimental_industries": { "type": "array", "items": { "type": "string" }, "description": "Filter by industry sectors (e.g., \"Technology\", \"Healthcare\").", "example": [ "information technology" ], "x-readme-id": "1.39" }, "excluded_experimental_industries": { "type": "array", "items": { "type": "string" }, "description": "Filter by excluded industry sectors (e.g., \"Technology\", \"Healthcare\").", "example": [ "information technology" ], "x-readme-id": "1.40" }, "mapped_company_size": { "type": "array", "items": { "type": "integer" }, "description": "Filter leads by company size. Use the mapped integer values listed below to represent the company size ranges.\n\nTo filter by a size range like '2-10', send the value [2].\n\nPossible values:\n- '1': 1\n- '2-10': 2\n- '11-50': 3\n- '51-200': 4\n- '201-500': 5\n- '501-1000': 6\n- '1001-5000': 7\n- '5001-10,000': 8\n- '10,001+': 9", "example": [ 2, 4, 5 ], "x-readme-id": "1.41" }, "excluded_mapped_company_size": { "type": "array", "items": { "type": "integer" }, "description": "Exclude leads based on company size. Use the mapped integer values listed below to represent the company size ranges.\n\nTo filter by a size range like '2-10', send the value [2].\n\nPossible values:\n- '1': 1\n- '2-10': 2\n- '11-50': 3\n- '51-200': 4\n- '201-500': 5\n- '501-1000': 6\n- '1001-5000': 7\n- '5001-10,000': 8\n- '10,001+': 9", "example": [ 2, 4, 5 ], "x-readme-id": "1.42" }, "last_funding_round_name": { "type": "array", "items": { "type": "string" }, "description": "Filter companies by the name of their most recent funding round.\n\nPossible values:\n- Seed Round\n- Pre Seed Round\n- Venture Round\n- Series A\n- Grant\n- Non Equity Assistance\n- Private Equity Round\n- Series B\n- Angel Round\n- Debt Financing\n- Post-IPO Equity\n- Series C\n- Corporate Round\n- Equity Crowdfunding\n- Funding Round\n- Convertible Note\n- Post-IPO Debt\n- Series D\n- Secondary Market\n- Post-IPO Secondary\n- Initial Coin Offering\n- Product Crowdfunding\n- Series E\n- Series F\n- Series G\n- Series H", "example": [ "Seed Round", "Series A" ], "x-readme-id": "1.48" }, "ownership_status": { "type": "array", "items": { "type": "string" }, "description": "Filter companies based on their ownership status.\n\nPossible values:\n- Private\n- Public\n- Investment Company\n- NGO/NPO/NFP/Organization/Association\n- Government\n- Product/Brand/Service\n- SPAC", "example": [ "Private", "Public" ], "x-readme-id": "1.49" }, "min_last_funding_round_amount_raised": { "type": "integer", "description": "Filter by minimum amount raised in the company's most recent funding round.", "example": 130000, "x-readme-id": "1.50" }, "max_last_funding_round_amount_raised": { "type": "integer", "description": "Filter by maximum amount raised in the company's most recent funding round.", "example": 130000, "x-readme-id": "1.51" }, "ipo_start_date": { "type": "string", "description": "Filter by IPO start date for public companies. Use the format dd/mm/yyyy (e.g., 15/08/2022).", "example": "15/08/2022", "x-readme-id": "1.52" }, "ipo_end_date": { "type": "string", "description": "Filter by IPO end date for public companies. Use the format dd/mm/yyyy (e.g., 15/08/2022).", "example": "15/08/2022", "x-readme-id": "1.53" }, "acquired_start_date": { "type": "string", "description": "Filter by acquisition start date for acquired companies.Use the format dd/mm/yyyy (e.g., 15/08/2022).", "example": "15/08/2022", "x-readme-id": "1.54" }, "acquired_end_date": { "type": "string", "description": "Filter by acquisition end date for acquired companies.Use the format dd/mm/yyyy (e.g., 15/08/2022).", "example": "15/08/2022", "x-readme-id": "1.55" }, "min_revenue_annual": { "type": "integer", "description": "Filter by minimum annual revenue reported.", "example": 1000000, "x-readme-id": "1.56" }, "max_revenue_annual": { "type": "integer", "description": "Filter by maximum annual revenue reported.", "example": 10000000, "x-readme-id": "1.57" }, "min_total_experience_duration_months": { "type": "integer", "description": "Filter by minimum total work experience in months", "example": 10, "x-readme-id": "1.58" }, "max_total_experience_duration_months": { "type": "integer", "description": "Filter by maximum total work experience in months", "example": "", "x-readme-id": "1.59" }, "min_job_duration_months": { "type": "integer", "description": "Filter by minimum duration at current/previous position in months.", "example": 12, "x-readme-id": "1.60" }, "max_job_duration_months": { "type": "integer", "description": "Filter by maximum duration at current/previous position in months.", "example": 20, "x-readme-id": "1.61" }, "member_certifications": { "type": "array", "items": { "type": "string" }, "description": "Filter by specific professional certifications held", "example": [ "Google Ads Search Certifications" ], "x-readme-id": "1.68" }, "excluded_member_certifications": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by specific professional certifications held", "example": [ "Google Ads Search Certifications" ], "x-readme-id": "1.69" }, "min_total_website_visits_monthly": { "type": "integer", "description": "Filter by minimum company website traffic volume", "example": 1000, "x-readme-id": "1.74" }, "max_total_website_visits_monthly": { "type": "integer", "description": "Filter by maximum company website traffic volume", "example": 1000, "x-readme-id": "1.75" }, "min_rank_global": { "type": "integer", "description": "Filter by minimum global website ranking", "example": 10, "x-readme-id": "1.76" }, "max_rank_global": { "type": "integer", "description": "Filter by maximum global website ranking", "example": 1, "x-readme-id": "1.77" }, "min_rank_country": { "type": "integer", "description": "Filter by website's minimum ranking within a country", "example": 10, "x-readme-id": "1.78" }, "max_rank_country": { "type": "integer", "description": "Filter by website's maximum ranking within a country", "example": 3, "x-readme-id": "1.79" }, "min_rank_category": { "type": "integer", "description": "Filter by website's minimum ranking within its industry category", "example": 1, "x-readme-id": "1.80" }, "max_rank_category": { "type": "integer", "description": "Filter by website's maximum ranking within its industry category", "example": 3, "x-readme-id": "1.81" }, "min_bounce_rate": { "type": "integer", "description": "Filter by website's minimum visitor bounce rate percentage", "example": 10, "x-readme-id": "1.82" }, "max_bounce_rate": { "type": "integer", "description": "Filter by website's maximum visitor bounce rate percentage", "example": 7, "x-readme-id": "1.83" }, "min_pages_per_visit": { "type": "integer", "description": "Filter by minimum average number of pages viewed per visit", "example": 3, "x-readme-id": "1.84" }, "max_pages_per_visit": { "type": "integer", "description": "Filter by maximum average number of pages viewed per visit", "example": 3, "x-readme-id": "1.85" }, "min_average_visit_duration_seconds": { "type": "integer", "description": "Filter by minimum number of secconds visitors stay on the website", "example": 10, "x-readme-id": "1.86" }, "max_average_visit_duration_seconds": { "type": "integer", "description": "Filter by maximum number of secconds visitors stay on the website", "example": 10, "x-readme-id": "1.87" }, "top_topics": { "type": "array", "items": { "type": "string" }, "description": "Filter by main topics covered on the company website", "example": [ "google apps" ], "x-readme-id": "1.88" }, "excluded_top_topics": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by main topics covered on the company website", "example": [ "google apps" ], "x-readme-id": "1.89" }, "min_company_employee_reviews_aggregate_score": { "type": "integer", "description": "Filter by company employee's minimum satisfaction ratings.", "example": 10, "x-readme-id": "1.90" }, "max_company_employee_reviews_aggregate_score": { "type": "integer", "description": "Filter by company employee's maximum satisfaction ratings.", "example": 10, "x-readme-id": "1.91" }, "pricing_available": { "type": "boolean", "description": "Filter companies that provide clear pricing information for their products or services", "example": true, "x-readme-id": "1.92" }, "demo_available": { "type": "boolean", "description": "Filter companies that provide a demo of their product or service", "example": false, "x-readme-id": "1.93" }, "documentation_exist": { "type": "boolean", "description": "Show companies that provide official documentation or user guides", "example": true, "x-readme-id": "1.94" }, "free_trial_available": { "type": "boolean", "description": "Find companies that offer a free trial before requiring payment", "example": false, "x-readme-id": "1.95" }, "is_downloadable": { "type": "boolean", "description": "Show companies that offer downloadable software or resources", "example": true, "x-readme-id": "1.96" }, "mobile_apps_exist": { "type": "boolean", "description": "Find companies that have a mobile application for their services", "example": true, "x-readme-id": "1.97" }, "online_reviews_exist": { "type": "boolean", "description": "Filter companies that have online reviews from users or customers", "example": false, "x-readme-id": "1.98" }, "technologies_used": { "type": "array", "items": { "type": "string" }, "description": "Filter by specific technologies mentioned in profile", "example": [ "machine learning", "aws lambda" ], "x-readme-id": "1.99" }, "excluded_technologies_used": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by specific technologies mentioned in profile", "example": [ "machine learning", "aws lambda" ], "x-readme-id": "1.100" }, "job_posting_title": { "type": "array", "items": { "type": "string" }, "description": "Filter by specific job titles being recruited", "example": [ "Software Engineer", "Product Manager" ], "x-readme-id": "1.101" }, "excluded_job_posting_title": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by specific job titles being recruited", "example": [ "Software Engineer", "Product Manager" ], "x-readme-id": "1.102" }, "job_posting_location": { "type": "array", "items": { "type": "string" }, "description": "Filter by job posting in specific locations", "example": [ "India", "United States" ], "x-readme-id": "1.103" }, "excluded_job_posting_location": { "type": "array", "items": { "type": "string" }, "description": "Exclude leads by job posting in specific locations", "example": [ "India", "United States" ], "x-readme-id": "1.104" }, "job_posting_start_date": { "type": "string", "description": "Filter leads by start date of job posting. Use dd/mm/yyyy format.", "example": "04/04/2025", "x-readme-id": "1.107" }, "job_posting_end_date": { "type": "string", "description": "Filter leads by end date of job posting. Use dd/mm/yyyy format.", "example": "04/04/2025", "x-readme-id": "1.108" }, "job_posting_type": { "type": "array", "items": { "type": "string" }, "description": "Filter leads by job posting employment type.\n\nAccepted values:\n- `Full-time`\n- `Part-time`\n- `Contract`\n- `Internship`\n- `Volunteer`\n- `Temporary`\n- `Other`\n\n**Example:**\n- To find leads related to full-time and internship job postings, send `[\"Full-time\", \"Internship\"]`.", "example": [ "Full-time", "Internship" ], "x-readme-id": "1.109" }, "job_posting_seniority": { "type": "array", "items": { "type": "string" }, "description": "Filter leads by the seniority level of job postings.\n\nAccepted values:\n- `Entry level`\n- `Internship`\n- `Associate`\n- `Mid-Senior level`\n- `Director`\n- `Executive`\n- `Not Applicable`\n\n**Example:**\n- To find leads with entry-level or associate-level job postings, send `[\"Entry level\", \"Associate\"]`.", "example": [ "Entry level", "Associate" ], "x-readme-id": "1.110" }, "experimental_member_department": { "type": "array", "description": "Filter by specific departments (e.g., Marketing, Engineering)", "items": { "type": "string" }, "x-readme-id": "1.17" }, "excluded_experimental_member_department": { "type": "array", "description": "Filter by specific departments (e.g., Marketing, Engineering)", "items": { "type": "string" }, "x-readme-id": "1.18" }, "excluded_organizations": { "type": "array", "description": "Exclude leads for specific organizations by entering the organizations names", "items": { "type": "string" }, "x-readme-id": "1.22" }, "job_title_match_mode": { "type": "string", "description": "\nDetermines how job title filters are matched against lead records. Accepts 'exact' (matches only the precise title entered), 'contains' (matches titles containing the search term as a substring), or 'smart' (uses semantic matching to include related or equivalent titles, e.g. matching abbreviations to full titles). Defaults to 'contains' if not specified.\n\nAccepted values:\n- `exact`\n- `contains`\n- `smart`", "x-readme-id": "1.115" }, "job_title_smart_mode": { "type": "string", "description": "Controls the sensitivity of smart job title matching. Only applies when job_title_match_mode is set to 'smart'. Accepts 'loose' (broadest matching, includes related and adjacent roles), 'normal' (balanced matching for most use cases), or 'strict' (tightest matching, limited to very close title equivalents). Defaults to 'normal'. Only use this filter when `job_title_match_mode` is set to `smart`\n\nAccepted values:\n- `loose`\n- `normal`\n- `strict`" }, "request_uuid": { "type": "string", "description": "A unique ID linked to each search to help identify and keep track of that specific search request." }, "is_mapped_industries_strict": { "type": "boolean", "description": "This field determines how strictly industries are matched during searches. When set to true, only exact industry matches are considered. When set to false (default), the system will also consider other similar or related industries during matching, providing a broader search scope." }, "name": { "type": "string" }, "name1": { "type": "string" } }, "x-readme-id": "0.0" }, "current_page": { "type": "number", "example": 0, "x-readme-id": "0.1" }, "search_type": { "type": "string", "example": "new", "description": "Restrict the search to 'saved', 'new', or 'total' data based on the specified 'search_type'. For example, 'saved' limits the search to previously searched data\n\nPossible Values are: 'new', 'saved', 'total'", "x-readme-id": "0.2" } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "object", "properties": { "status": { "type": "string", "example": "success" }, "statusCode": { "type": "integer", "example": 200 }, "description": { "type": "string", "example": "Advanced search successful" } } }, "data": { "type": "array", "description": "Array of search results", "items": { "type": "object", "properties": { "member_location_raw_address": { "type": "string", "example": "Miami-Fort Lauderdale Area United States" }, "member_id": { "type": "integer", "example": 143165408 }, "member_description": { "type": "string", "example": "With a reach of 15–25 million per month..." }, "member_location_country": { "type": "string", "example": "United States" }, "member_full_name": { "type": "string", "example": "Richard Dipilla" }, "join_field": { "type": "string", "example": "company" }, "member_connections_count": { "type": "integer", "example": 500 }, "member_linkedin_username": { "type": "string", "example": "richard-dipilla-4820177" }, "job_title": { "type": "string", "example": "Google Community Guide" }, "member_name_first": { "type": "string", "example": "Richard" }, "member_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/in/richard-dipilla-4820177" }, "member_name_last": { "type": "string", "example": "Dipilla" }, "phone_number_available": { "type": "boolean", "example": true }, "document_id": { "type": "string", "example": "person_143165408_3252082" }, "categories_and_keywords": { "type": "array", "items": { "type": "string" }, "example": [ "technology/software", "search engine" ] }, "website": { "type": "string", "example": "https://www.google.com" }, "company_logo": { "type": "string", "example": "base64encodedimage..." }, "company_id": { "type": "integer", "example": 3252082 }, "company_name": { "type": "string", "example": "Google" }, "domain": { "type": "string", "example": "google.com" }, "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/google" }, "size_range": { "type": "string", "example": "10,001+ employees" }, "hq_full_address": { "type": "string", "example": "1600 Amphitheatre Parkway; Mountain View, CA 94043, US" }, "description_metadata_raw": { "type": "string", "example": "Find your next job at Google — Careers at Google." } } } }, "meta_data": { "type": "object", "properties": { "total_count": { "type": "integer", "example": 266597 }, "saved_count": { "type": "integer", "example": 0 }, "new_count": { "type": "integer", "example": 266597 }, "viewable_leads_count": { "type": "integer", "example": 500 } } } } } } } }, "400": { "description": "Bad Request" }, "500": { "description": "Internal Server Error" } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key" } } } } ```