Generect · Schema

RealtimeCompanySearchRequest

B2BLead GenerationReal-Time DataSoftware-as-a-Service

Properties

Name Type Description
industries array Industries of the target companies; a company is included if it matches at least one. Values follow LinkedIn's industry taxonomy. Examples: "Software Development", "Financial Services", "Information T
exclude_industries array Industries to exclude.
sub_industries boolean Controls how the `industries` filter maps onto LinkedIn's industry taxonomy. By default (`false`), a selected industry also matches companies in its sub-industries. Set to `true` to match only the ind
headcounts array Company size, as employee-count ranges; a company is included if it falls into at least one. Allowed values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10 000+".
locations array Company headquarters locations — matches across cities, states/regions and countries; a company is included if its HQ matches at least one. Examples: "United States", "San Francisco, California, Unite
exclude_locations array Locations to exclude.
company_types array Company types: "Public Company", "Privately Held", "Non Profit", "Government Agency", "Educational", etc.
exclude_ids array Exclude companies by LinkedIn ID or URN.
exclude_domains array Exclude companies by domain.
limit_by integer Maximum number of companies to return (1-1600).
offset_by integer Number of companies to skip (0-1599, for pagination).
strict array Fields to apply strict matching on (e.g. "company_locations").
apply_domain_blocklist boolean Apply Generect's blocked-domain list, which removes staffing agencies, directories and similar low-signal records that match broad industry filters. Set to `false` to receive them. On by default on th
include_companies_without_website boolean Also return companies that have a LinkedIn page but no website, such as many hospitals, clinics and local businesses. Off by default: the company search endpoints drop every company without a website,
keywords array Free-text keywords matched across company profiles (name, description, specialties); a company is included if it contains at least one. OR logic, max 10 keywords, up to 40 characters each. Examples: "
technologies array Technologies used by the company.
num_of_followers array Follower count ranges: "1-50", "51-100", "101-1000", "1001-5000", "5001+".
company_names array Search by specific company names or domains.
recent_activities array Recent company events to filter on.
department_headcount_growth object Filter by growth of a single department (e.g. {"name": "engineering", "min": 5, "max": 50}).
revenues_range object Revenue filter with min/max (e.g. {"min": 1000000, "max": 50000000}).
department_headcount object Filter by department size (e.g. {"name": "engineering", "min": 10, "max": 100}).
headcount_growth object Filter by headcount growth percentage (e.g. {"min": 5, "max": 50}).
hiring_on_linkedin boolean Filter for companies actively hiring on LinkedIn.
linkedins_links array Filter by specific LinkedIn company URLs.
include_total_count boolean Include `results_count` — how many companies match the filters in total, beyond the page you asked for — in the response. Without it the response carries only the page itself. The companies counterpar
View JSON Schema on GitHub

JSON Schema

generect-com-realtime-company-search-request-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/generect-com/json-schema/generect-com-realtime-company-search-request-schema.json",
  "title": "RealtimeCompanySearchRequest",
  "x-generated": "2026-11-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/generect-com-openapi.yaml#/components/schemas/RealtimeCompanySearchRequest",
  "allOf": [
    {
      "$ref": "#/$defs/CompanySearchRequest"
    },
    {
      "type": "object",
      "properties": {
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Free-text keywords matched across company profiles (name, description, specialties); a company is included if it contains at least one. OR logic, max 10 keywords, up to 40 characters each. Examples: \"platform\", \"marketplace\", \"developer tools\"."
        },
        "technologies": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Technologies used by the company."
        },
        "num_of_followers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Follower count ranges: \"1-50\", \"51-100\", \"101-1000\", \"1001-5000\", \"5001+\"."
        },
        "company_names": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Search by specific company names or domains."
        },
        "recent_activities": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "Funding events in past 12 months",
              "Senior leadership changes in last 3 months"
            ]
          },
          "description": "Recent company events to filter on."
        },
        "department_headcount_growth": {
          "type": "object",
          "description": "Filter by growth of a single department (e.g. {\"name\": \"engineering\", \"min\": 5, \"max\": 50}).",
          "properties": {
            "name": {
              "type": "string"
            },
            "min": {
              "type": "number"
            },
            "max": {
              "type": "number"
            }
          }
        },
        "revenues_range": {
          "type": "object",
          "description": "Revenue filter with min/max (e.g. {\"min\": 1000000, \"max\": 50000000}).",
          "properties": {
            "min": {
              "type": "number"
            },
            "max": {
              "type": "number"
            }
          }
        },
        "department_headcount": {
          "type": "object",
          "description": "Filter by department size (e.g. {\"name\": \"engineering\", \"min\": 10, \"max\": 100}).",
          "properties": {
            "name": {
              "type": "string"
            },
            "min": {
              "type": "number"
            },
            "max": {
              "type": "number"
            }
          }
        },
        "headcount_growth": {
          "type": "object",
          "description": "Filter by headcount growth percentage (e.g. {\"min\": 5, \"max\": 50}).",
          "properties": {
            "min": {
              "type": "number"
            },
            "max": {
              "type": "number"
            }
          }
        },
        "hiring_on_linkedin": {
          "type": "boolean",
          "description": "Filter for companies actively hiring on LinkedIn.",
          "default": false
        },
        "linkedins_links": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Filter by specific LinkedIn company URLs."
        },
        "include_total_count": {
          "type": "boolean",
          "default": false,
          "description": "Include `results_count` — how many companies match the filters in total, beyond the page you asked for — in the response. Without it the response carries only the page itself. The companies counterpart of the lead-search flag of the same name, and likewise an estimate rather than an exact total."
        }
      }
    }
  ],
  "$defs": {
    "CompanySearchRequest": {
      "type": "object",
      "properties": {
        "industries": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Industries of the target companies; a company is included if it matches at least one. Values follow LinkedIn's industry taxonomy. Examples: \"Software Development\", \"Financial Services\", \"Information Technology\"."
        },
        "exclude_industries": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Industries to exclude."
        },
        "sub_industries": {
          "type": "boolean",
          "default": false,
          "description": "Controls how the `industries` filter maps onto LinkedIn's industry taxonomy. By default (`false`), a selected industry also matches companies in its sub-industries. Set to `true` to match only the industries you specify and exclude their sub-industries, for finer sub-category targeting — for example, \"Manufacturing\" without \"Chemicals\"."
        },
        "headcounts": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Company size, as employee-count ranges; a company is included if it falls into at least one. Allowed values: \"1-10\", \"11-50\", \"51-200\", \"201-500\", \"501-1000\", \"1001-5000\", \"5001-10000\", \"10 000+\"."
        },
        "locations": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Company headquarters locations — matches across cities, states/regions and countries; a company is included if its HQ matches at least one. Examples: \"United States\", \"San Francisco, California, United States\", \"Germany\"."
        },
        "exclude_locations": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Locations to exclude."
        },
        "company_types": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Company types: \"Public Company\", \"Privately Held\", \"Non Profit\", \"Government Agency\", \"Educational\", etc."
        },
        "exclude_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Exclude companies by LinkedIn ID or URN."
        },
        "exclude_domains": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Exclude companies by domain."
        },
        "limit_by": {
          "type": "integer",
          "description": "Maximum number of companies to return (1-1600)."
        },
        "offset_by": {
          "type": "integer",
          "description": "Number of companies to skip (0-1599, for pagination)."
        },
        "strict": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Fields to apply strict matching on (e.g. \"company_locations\")."
        },
        "apply_domain_blocklist": {
          "type": "boolean",
          "default": true,
          "description": "Apply Generect's blocked-domain list, which removes staffing agencies, directories and similar low-signal records that match broad industry filters. Set to `false` to receive them. On by default on the company search endpoints, in both database and realtime mode; the company-leads endpoints do not apply it. In database search the exclusion happens before `results_count`, so the count always matches what the pages can deliver; in realtime the records are dropped after retrieval, so a page may hold fewer companies than `results_count` implies."
        },
        "include_companies_without_website": {
          "type": "boolean",
          "default": false,
          "description": "Also return companies that have a LinkedIn page but no website, such as many hospitals, clinics and local businesses. Off by default: the company search endpoints drop every company without a website, in both database and realtime mode. Such a company has no website and no domain, so there are no corporate emails to find for its people and lead matching by domain does not work for it; an `exclude_domains` entry cannot remove it (use `exclude_ids`). Each one is returned and billed as a result like any other, and many of them have few or no leads on LinkedIn. The other quality rules stay: a company with zero employees on LinkedIn is still dropped, and the blocked-domain list still applies to companies that have a website. In database search these companies are counted in `results_count`; the realtime count comes from LinkedIn and always included them. The company-leads endpoints do not read it."
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/generect-com-realtime-company-search-request"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.