--- updatedAt: 2026-05-14T06:31:56.000Z agentTools: projectIndex: https://docs.a-leads.co/llms.txt --- # Company Search ## Rate Limits * **200requests per minute** * **600 requests per hour** * **6,000 requests per day**
**Each call costs 1 credit** # 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/company-search", "description": "Production server" }, { "url": "https://api.a-leads.co/gateway/v1/company-search", "description": "Staging server" } ], "paths": { "/": { "post": { "summary": "Company Search", "tags": [ "Search" ], "security": [ { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_filters": { "type": "object", "description": "Filters to refine the search", "properties": { "organizations": { "type": "array", "items": { "type": "string" }, "description": "Filter for specific organizations by entering the organizations names", "example": [ "Google", "AWS" ] }, "excluded_organizations": { "type": "array", "items": { "type": "string" }, "description": "Filter for specific organizations by entering the organizations names", "example": [ "Google", "AWS" ] }, "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" }, "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" }, "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" }, "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": "EXPERIMENTAL is currently under development, providing more targeted results. As a work in progress, continuous improvements are being made. Disclaimer: You may experience fewer search results.", "example": [ "information technology" ], "x-readme-id": "1.39" }, "excluded_experimental_industries": { "type": "array", "items": { "type": "string" }, "description": "EXPERIMENTAL is currently under development, providing more targeted results. As a work in progress, continuous improvements are being made. Disclaimer: You may experience fewer search results.", "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" }, "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" }, "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_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" }, "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" }, "request_uuid": { "type": "string", "description": "A unique ID linked to each search to help identify and keep track of that specific search request." } }, "x-readme-id": "0.0" }, "current_page": { "type": "number", "example": 0, "x-readme-id": "0.1" } } } } } }, "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": { "categories_and_keywords": { "type": "array", "items": { "type": "string" }, "example": [ "technology/software", "url shortener", "goo.io" ] }, "website": { "type": "string", "example": "https://www.google.com" }, "company_id": { "type": "integer", "example": 3252082 }, "company_headcount": { "type": "integer", "example": 308346 }, "industry": { "type": "string", "example": "Software Development" }, "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/google" }, "mapped_company_size": { "type": "integer", "example": 9 }, "hq_full_address": { "type": "string", "example": "1600 Amphitheatre Parkway; Mountain View, CA 94043, US" }, "domain": { "type": "string", "example": "google.com" }, "company_name": { "type": "string", "example": "Google" }, "size_range": { "type": "string", "example": "10,001+ employees" }, "employees_count": { "type": "integer", "example": 312960 }, "description_metadata_raw": { "type": "string", "example": "Find your next job at Google — Careers at Google." }, "document_id": { "type": "string", "example": "Find your next job at Google — Careers at Google." }, "_score": { "type": "integer", "nullable": true, "example": 100 } } } }, "total_count": { "type": "integer", "example": 100443 } } } } } }, "400": { "description": "Bad Request" }, "500": { "description": "Internal Server Error" } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key" } } } } ```