{
  "service": "coresignal",
  "displayName": "Coresignal",
  "categories": [
    "Data"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "coresignal_api_key",
      "description": "Coresignal API key sent with the apikey header. Copy it from the API keys section in the Coresignal self-service dashboard: https://dashboard.coresignal.com/sign-in."
    }
  ],
  "homepageUrl": "https://coresignal.com",
  "actions": [
    {
      "id": "coresignal.collect_base_company",
      "service": "coresignal",
      "name": "collect_base_company",
      "description": "Collect a Coresignal Base Company record by company ID, profile URL, or shorthand name, optionally selecting specific fields.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "companyIdentifier": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1,
                "description": "Coresignal company ID returned by search endpoints."
              },
              {
                "type": "string",
                "minLength": 1,
                "description": "Coresignal profile URL or shorthand name."
              }
            ],
            "description": "Company ID, profile URL, or shorthand name to collect."
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "A Base Company field name to request."
            },
            "description": "Optional list of fields to return from the Base Company record.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "companyIdentifier"
        ],
        "description": "Request parameters for collecting a Base Company record."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "company": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw Base Company record returned by Coresignal."
          }
        },
        "additionalProperties": false,
        "required": [
          "company"
        ],
        "description": "Coresignal Base Company collect result."
      }
    },
    {
      "id": "coresignal.preview_base_companies",
      "service": "coresignal",
      "name": "preview_base_companies",
      "description": "Preview top Coresignal Base Company matches with compact company profile fields using documented search filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Company name or name expression to search for using Coresignal search filters."
          },
          "website": {
            "type": "string",
            "minLength": 1,
            "description": "Company website value to search for, such as example.com or https://www.example.com."
          },
          "exact_website": {
            "type": "string",
            "minLength": 1,
            "description": "Exact company website value to search for."
          },
          "size": {
            "type": "string",
            "minLength": 1,
            "description": "Company size category based on headcount."
          },
          "industry": {
            "type": "string",
            "minLength": 1,
            "description": "Industry value or expression to search for."
          },
          "country": {
            "type": "string",
            "minLength": 1,
            "description": "Country value or expression to search for."
          },
          "location": {
            "type": "string",
            "minLength": 1,
            "description": "Location value or expression to search for."
          },
          "created_at_gte": {
            "type": "string",
            "minLength": 1,
            "description": "Record creation timestamp lower bound using the Coresignal format."
          },
          "created_at_lte": {
            "type": "string",
            "minLength": 1,
            "description": "Record creation timestamp upper bound using the Coresignal format."
          },
          "last_updated_gte": {
            "type": "string",
            "minLength": 1,
            "description": "Record last-updated timestamp lower bound using the Coresignal format."
          },
          "last_updated_lte": {
            "type": "string",
            "minLength": 1,
            "description": "Record last-updated timestamp upper bound using the Coresignal format."
          },
          "deleted": {
            "type": "boolean",
            "description": "Whether to include deleted or private company records."
          },
          "employees_count_gte": {
            "type": "integer",
            "minimum": 0,
            "description": "Minimum visible employee count."
          },
          "employees_count_lte": {
            "type": "integer",
            "minimum": 0,
            "description": "Maximum visible employee count."
          },
          "source_id": {
            "type": "integer",
            "minimum": 0,
            "description": "Company identifier assigned by the source."
          },
          "founded_year_gte": {
            "type": "integer",
            "minimum": 0,
            "description": "Minimum company founding year."
          },
          "founded_year_lte": {
            "type": "integer",
            "minimum": 0,
            "description": "Maximum company founding year."
          },
          "funding_total_rounds_count_gte": {
            "type": "integer",
            "minimum": 0,
            "description": "Minimum total funding round count."
          },
          "funding_total_rounds_count_lte": {
            "type": "integer",
            "minimum": 0,
            "description": "Maximum total funding round count."
          },
          "funding_last_round_type": {
            "type": "string",
            "minLength": 1,
            "description": "Last funding round type."
          },
          "funding_last_round_date_gte": {
            "type": "string",
            "minLength": 1,
            "description": "Last funding round date lower bound using the yyyy-mm-dd format."
          },
          "funding_last_round_date_lte": {
            "type": "string",
            "minLength": 1,
            "description": "Last funding round date upper bound using the yyyy-mm-dd format."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "Preview result page number."
          }
        },
        "additionalProperties": false,
        "description": "Coresignal Base Company search preview request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "records": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "Coresignal company ID."
                },
                "name": {
                  "type": "string",
                  "description": "Company name."
                },
                "canonical_url": {
                  "type": "string",
                  "description": "Most recent company profile URL."
                },
                "website": {
                  "type": "string",
                  "description": "Company website."
                },
                "size": {
                  "type": "string",
                  "description": "Company size category."
                },
                "industry": {
                  "type": "string",
                  "description": "Company industry."
                },
                "headquarters_country_parsed": {
                  "type": "string",
                  "description": "Parsed headquarters country."
                },
                "_score": {
                  "type": "number",
                  "description": "Search relevance score."
                }
              },
              "additionalProperties": true,
              "description": "A Base Company preview record."
            },
            "description": "Preview records matching the search filters."
          }
        },
        "additionalProperties": false,
        "required": [
          "records"
        ],
        "description": "Coresignal Base Company preview result."
      }
    },
    {
      "id": "coresignal.search_base_companies",
      "service": "coresignal",
      "name": "search_base_companies",
      "description": "Search Coresignal Base Company records with documented search filters and return matching company IDs for follow-up collection.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Company name or name expression to search for using Coresignal search filters."
          },
          "website": {
            "type": "string",
            "minLength": 1,
            "description": "Company website value to search for, such as example.com or https://www.example.com."
          },
          "exact_website": {
            "type": "string",
            "minLength": 1,
            "description": "Exact company website value to search for."
          },
          "size": {
            "type": "string",
            "minLength": 1,
            "description": "Company size category based on headcount."
          },
          "industry": {
            "type": "string",
            "minLength": 1,
            "description": "Industry value or expression to search for."
          },
          "country": {
            "type": "string",
            "minLength": 1,
            "description": "Country value or expression to search for."
          },
          "location": {
            "type": "string",
            "minLength": 1,
            "description": "Location value or expression to search for."
          },
          "created_at_gte": {
            "type": "string",
            "minLength": 1,
            "description": "Record creation timestamp lower bound using the Coresignal format."
          },
          "created_at_lte": {
            "type": "string",
            "minLength": 1,
            "description": "Record creation timestamp upper bound using the Coresignal format."
          },
          "last_updated_gte": {
            "type": "string",
            "minLength": 1,
            "description": "Record last-updated timestamp lower bound using the Coresignal format."
          },
          "last_updated_lte": {
            "type": "string",
            "minLength": 1,
            "description": "Record last-updated timestamp upper bound using the Coresignal format."
          },
          "deleted": {
            "type": "boolean",
            "description": "Whether to include deleted or private company records."
          },
          "employees_count_gte": {
            "type": "integer",
            "minimum": 0,
            "description": "Minimum visible employee count."
          },
          "employees_count_lte": {
            "type": "integer",
            "minimum": 0,
            "description": "Maximum visible employee count."
          },
          "source_id": {
            "type": "integer",
            "minimum": 0,
            "description": "Company identifier assigned by the source."
          },
          "founded_year_gte": {
            "type": "integer",
            "minimum": 0,
            "description": "Minimum company founding year."
          },
          "founded_year_lte": {
            "type": "integer",
            "minimum": 0,
            "description": "Maximum company founding year."
          },
          "funding_total_rounds_count_gte": {
            "type": "integer",
            "minimum": 0,
            "description": "Minimum total funding round count."
          },
          "funding_total_rounds_count_lte": {
            "type": "integer",
            "minimum": 0,
            "description": "Maximum total funding round count."
          },
          "funding_last_round_type": {
            "type": "string",
            "minLength": 1,
            "description": "Last funding round type."
          },
          "funding_last_round_date_gte": {
            "type": "string",
            "minLength": 1,
            "description": "Last funding round date lower bound using the yyyy-mm-dd format."
          },
          "funding_last_round_date_lte": {
            "type": "string",
            "minLength": 1,
            "description": "Last funding round date upper bound using the yyyy-mm-dd format."
          }
        },
        "additionalProperties": false,
        "description": "Coresignal Base Company search filter request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 1,
              "description": "Company ID."
            },
            "description": "Company IDs matching the search filters."
          }
        },
        "additionalProperties": false,
        "required": [
          "ids"
        ],
        "description": "Coresignal Base Company search ID result."
      },
      "followUpActions": [
        "coresignal.collect_base_company"
      ]
    }
  ]
}