---
updatedAt: 2026-06-04T10:32:52.000Z
agentTools:
  projectIndex: https://docs.companyenrich.com/llms.txt
---

# Enrich by properties

**Cost:** 1 credit per call

Enriches a company using its properties.

You need to provide at least one of the following properties:
- Name
- LinkedinUrl
- LinkedinId
- TwitterUrl
- FacebookUrl
- InstagramUrl

Best match is used to determine the company in case of ambiguity.

# OpenAPI definition

````json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Enrich API",
    "description": "The Company Enrich API provides programmatic access to a comprehensive database of company and person data for enrichment, search, and lead generation.\n\n## Key Features\n\n- **Company Enrichment** — Enrich company profiles by domain, ID, or matching properties. Supports single lookups, batch requests, and bulk background jobs.\n- **Company Search** — Search and filter companies by industry, location, size, technology usage, keywords, and more. Supports page-based, cursor-based, and async export pagination.\n- **People Search** — Search for professionals by job title, company, location, and other criteria. Export results in CSV or JSON.\n- **Similar Companies** — Find companies similar to a given company based on shared attributes.\n- **Company Lists** — Create and manage saved lists of companies for organizing and exporting your data.\n\n## Authentication\n\nAll API requests require a Bearer token passed in the `Authorization` header:\n\n```\nAuthorization: Bearer YOUR_API_TOKEN\n```\n\nYou can generate API tokens from your [dashboard](https://companyenrich.com/dashboard).\n\n## Credits\n\nMost API calls consume credits. The credit cost for each endpoint is documented in its description. You can check your remaining credit balance using the User endpoint.\n\n## Rate Limiting\n\nThe global API limiter allows **500 requests per minute** per IP address. Authenticated API routes also use a per-user route limiter based on plan capabilities.\nSupplementary lookup endpoints (such as keyword/technology/industry autocompletes) use a separate per-user route-level bucket.",
    "termsOfService": "https://companyenrich.com/terms-and-conditions",
    "contact": {
      "url": "https://companyenrich.com/",
      "email": "support@companyenrich.com"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.companyenrich.com"
    }
  ],
  "paths": {
    "/companies/enrich": {
      "post": {
        "tags": [
          "Company / Enrichment"
        ],
        "summary": "Enrich by properties",
        "description": "**Cost:** 1 credit per call\n\nEnriches a company using its properties.\n\nYou need to provide at least one of the following properties:\n- Name\n- LinkedinUrl\n- LinkedinId\n- TwitterUrl\n- FacebookUrl\n- InstagramUrl\n\nBest match is used to determine the company in case of ambiguity.",
        "parameters": [
          {
            "name": "expand",
            "in": "query",
            "description": "Expandable response fields. Repeat the parameter to request multiple expansions.\n\nSupported values:\n- `workforce`: costs 5 credits per company and adds the `workforce` field to `CompanyInfo`.",
            "schema": {
              "type": "array",
              "items": {
                "enum": [
                  "workforce"
                ],
                "type": "string"
              }
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnrichRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanyInfo"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/HttpValidationProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CityInfo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The ID of the city",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "The name of the city"
          },
          "latitude": {
            "type": "number",
            "description": "The latitude of the city",
            "format": "float",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "description": "The longitude of the city",
            "format": "float",
            "nullable": true
          }
        },
        "description": "The city information of the company",
        "nullable": true
      },
      "CompanyCategory": {
        "enum": [
          "b2b",
          "b2c",
          "b2g",
          "e-commerce",
          "media",
          "service-provider",
          "mobile",
          "saas"
        ]
      },
      "CompanyFinancialInfo": {
        "type": "object",
        "properties": {
          "stock_symbol": {
            "type": "string",
            "nullable": true
          },
          "stock_exchange": {
            "type": "string",
            "nullable": true
          },
          "total_funding": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          },
          "funding_stage": {
            "type": "string",
            "nullable": true
          },
          "funding_date": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "funding": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyFundingInfo"
            },
            "nullable": true
          }
        },
        "description": "The financial information of the company",
        "nullable": true
      },
      "CompanyFundingInfo": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "amount": {
            "type": "string",
            "nullable": true
          },
          "type": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true
          },
          "from": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "CompanyInfo": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The unique identifier of the company",
            "format": "uuid"
          },
          "name": {
            "maxLength": 1024,
            "type": "string",
            "description": "The name of the company",
            "nullable": true
          },
          "domain": {
            "maxLength": 1024,
            "type": "string",
            "description": "The primary domain name of the company",
            "nullable": true
          },
          "website": {
            "type": "string",
            "description": "The website URL of the company",
            "format": "uri",
            "nullable": true
          },
          "type": {
            "$ref": "#/components/schemas/NullableOfCompanyType"
          },
          "legalName": {
            "type": "string",
            "description": "The legal name of the company",
            "nullable": true
          },
          "industry": {
            "type": "string",
            "description": "The main industry of the company",
            "nullable": true
          },
          "industries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The industries associated with the company",
            "nullable": true
          },
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyCategory"
            },
            "description": "The categories of the company from most to least specific.",
            "nullable": true
          },
          "employees": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees"
          },
          "reported_employees": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees2"
          },
          "revenue": {
            "$ref": "#/components/schemas/NullableOfCompanyRevenue"
          },
          "description": {
            "type": "string",
            "description": "The description of the company",
            "nullable": true
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The search keywords of the company",
            "nullable": true
          },
          "technologies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The technologies associated with the company",
            "nullable": true
          },
          "subsidiaries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The subsidiaries associated with the company",
            "nullable": true
          },
          "founded_year": {
            "type": "integer",
            "description": "The year the company was founded",
            "format": "int32",
            "nullable": true
          },
          "naics_codes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The NAICS codes associated with the company",
            "nullable": true
          },
          "location": {
            "$ref": "#/components/schemas/CompanyLocationInfo"
          },
          "financial": {
            "$ref": "#/components/schemas/CompanyFinancialInfo"
          },
          "socials": {
            "$ref": "#/components/schemas/CompanySocialUrls"
          },
          "page_rank": {
            "type": "number",
            "description": "The page rank of the company",
            "format": "float",
            "nullable": true
          },
          "workforce": {
            "$ref": "#/components/schemas/CompanyWorkforceInfo"
          },
          "logo_url": {
            "type": "string",
            "description": "The logo URL of the company",
            "nullable": true
          },
          "seo_description": {
            "type": "string",
            "description": "The SEO description of the company",
            "nullable": true
          },
          "updated_at": {
            "type": "string",
            "description": "The last updated timestamp of the company",
            "format": "date-time"
          }
        }
      },
      "CompanyLocationInfo": {
        "type": "object",
        "properties": {
          "country": {
            "$ref": "#/components/schemas/CountryInfo"
          },
          "state": {
            "$ref": "#/components/schemas/StateInfo"
          },
          "city": {
            "$ref": "#/components/schemas/CityInfo"
          },
          "address": {
            "type": "string",
            "nullable": true
          },
          "postal_code": {
            "type": "string",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "nullable": true
          }
        },
        "description": "The location information of the company",
        "nullable": true
      },
      "CompanySocialUrls": {
        "type": "object",
        "properties": {
          "linkedin_url": {
            "type": "string",
            "description": "The LinkedIn URL of the company",
            "format": "uri",
            "nullable": true
          },
          "linkedin_id": {
            "maxLength": 1024,
            "type": "string",
            "description": "The LinkedIn ID of the company",
            "nullable": true
          },
          "twitter_url": {
            "type": "string",
            "description": "The Twitter URL of the company",
            "format": "uri",
            "nullable": true
          },
          "facebook_url": {
            "type": "string",
            "description": "The Facebook URL of the company",
            "format": "uri",
            "nullable": true
          },
          "instagram_url": {
            "type": "string",
            "description": "The Instagram URL of the company",
            "format": "uri",
            "nullable": true
          },
          "angellist_url": {
            "type": "string",
            "description": "The AngelList URL of the company",
            "format": "uri",
            "nullable": true
          },
          "crunchbase_url": {
            "type": "string",
            "description": "The Crunchbase URL of the company",
            "format": "uri",
            "nullable": true
          },
          "youtube_url": {
            "type": "string",
            "description": "The YouTube URL of the company",
            "format": "uri",
            "nullable": true
          },
          "github_url": {
            "type": "string",
            "description": "The GitHub URL of the company",
            "format": "uri",
            "nullable": true
          },
          "g2_url": {
            "type": "string",
            "description": "The G2 URL of the company",
            "format": "uri",
            "nullable": true
          }
        },
        "description": "The social URLs of the company"
      },
      "CompanyWorkforceDepartmentHeadcount": {
        "type": "object",
        "properties": {
          "c_suite": {
            "type": "integer",
            "description": "Headcount in the c-suite root department.",
            "format": "int32",
            "nullable": true
          },
          "product_management": {
            "type": "integer",
            "description": "Headcount in the product management root department.",
            "format": "int32",
            "nullable": true
          },
          "engineering_technical": {
            "type": "integer",
            "description": "Headcount in the engineering and technical root department.",
            "format": "int32",
            "nullable": true
          },
          "design": {
            "type": "integer",
            "description": "Headcount in the design root department.",
            "format": "int32",
            "nullable": true
          },
          "education": {
            "type": "integer",
            "description": "Headcount in the education root department.",
            "format": "int32",
            "nullable": true
          },
          "finance": {
            "type": "integer",
            "description": "Headcount in the finance root department.",
            "format": "int32",
            "nullable": true
          },
          "human_resources": {
            "type": "integer",
            "description": "Headcount in the human resources root department.",
            "format": "int32",
            "nullable": true
          },
          "information_technology": {
            "type": "integer",
            "description": "Headcount in the information technology root department.",
            "format": "int32",
            "nullable": true
          },
          "legal": {
            "type": "integer",
            "description": "Headcount in the legal root department.",
            "format": "int32",
            "nullable": true
          },
          "marketing": {
            "type": "integer",
            "description": "Headcount in the marketing root department.",
            "format": "int32",
            "nullable": true
          },
          "medical_health": {
            "type": "integer",
            "description": "Headcount in the medical and health root department.",
            "format": "int32",
            "nullable": true
          },
          "operations": {
            "type": "integer",
            "description": "Headcount in the operations root department.",
            "format": "int32",
            "nullable": true
          },
          "sales": {
            "type": "integer",
            "description": "Headcount in the sales root department.",
            "format": "int32",
            "nullable": true
          },
          "consulting": {
            "type": "integer",
            "description": "Headcount in the consulting root department.",
            "format": "int32",
            "nullable": true
          }
        },
        "description": "Headcount grouped by root department name."
      },
      "CompanyWorkforceHistoryEntry": {
        "required": [
          "date",
          "department_headcount"
        ],
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "First day of the month for this snapshot.",
            "format": "date"
          },
          "observed_employee_count": {
            "type": "integer",
            "description": "Observed number of distinct employees in our people dataset for this month.",
            "format": "int32"
          },
          "employee_count_range": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees"
          },
          "department_headcount": {
            "$ref": "#/components/schemas/CompanyWorkforceDepartmentHeadcount"
          },
          "unclassified_headcount": {
            "type": "integer",
            "description": "Headcount where department could not be classified.",
            "format": "int32"
          }
        }
      },
      "CompanyWorkforceInfo": {
        "required": [
          "company_id",
          "domain",
          "department_headcount"
        ],
        "type": "object",
        "properties": {
          "company_id": {
            "type": "string",
            "description": "The CompanyEnrich ID of the company.",
            "format": "uuid"
          },
          "domain": {
            "type": "string",
            "description": "The canonical domain of the company."
          },
          "observed_employee_count": {
            "type": "integer",
            "description": "Observed number of distinct current employees in our people dataset.",
            "format": "int32"
          },
          "employee_count_range": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees"
          },
          "department_headcount": {
            "$ref": "#/components/schemas/CompanyWorkforceDepartmentHeadcount"
          },
          "unclassified_headcount": {
            "type": "integer",
            "description": "Headcount where department could not be classified.",
            "format": "int32"
          },
          "history": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyWorkforceHistoryEntry"
            },
            "description": "Monthly workforce snapshots showing headcount changes over time. Only months where headcount changed are included.",
            "nullable": true
          }
        },
        "description": "Expanded workforce insights for the company. This field is only returned when `expand=workforce` is requested.",
        "nullable": true
      },
      "CountryInfo": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The ISO 3166-1 alpha-2 code of the country"
          },
          "name": {
            "type": "string",
            "description": "The name of the country"
          },
          "latitude": {
            "type": "number",
            "description": "The latitude of the country",
            "format": "float",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "description": "The longitude of the country",
            "format": "float",
            "nullable": true
          }
        },
        "description": "The origin country information of the company",
        "nullable": true
      },
      "EnrichRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the company to enrich",
            "nullable": true
          },
          "linkedinUrl": {
            "type": "string",
            "description": "The LinkedIn URL of the company to enrich",
            "format": "uri",
            "nullable": true
          },
          "linkedinId": {
            "type": "string",
            "description": "The LinkedIn ID of the company to enrich",
            "nullable": true
          },
          "twitterUrl": {
            "type": "string",
            "description": "The Twitter URL of the company to enrich",
            "format": "uri",
            "nullable": true
          },
          "facebookUrl": {
            "type": "string",
            "description": "The Facebook URL of the company to enrich",
            "format": "uri",
            "nullable": true
          },
          "instagramUrl": {
            "type": "string",
            "description": "The Instagram URL of the company to enrich",
            "format": "uri",
            "nullable": true
          },
          "youTubeUrl": {
            "type": "string",
            "description": "The YouTube URL of the company to enrich",
            "format": "uri",
            "nullable": true
          }
        }
      },
      "HttpValidationProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          },
          "errors": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      },
      "NullableOfCompanyEmployees": {
        "enum": [
          "1-10",
          "11-50",
          "51-200",
          "201-500",
          "501-1K",
          "1K-5K",
          "5K-10K",
          "over-10K",
          null
        ],
        "description": "The employee count range.",
        "nullable": true
      },
      "NullableOfCompanyEmployees2": {
        "enum": [
          "1-10",
          "11-50",
          "51-200",
          "201-500",
          "501-1K",
          "1K-5K",
          "5K-10K",
          "over-10K",
          null
        ],
        "description": "The employee count range reported by external data providers.",
        "nullable": true
      },
      "NullableOfCompanyRevenue": {
        "enum": [
          "under-1m",
          "1m-10m",
          "10m-50m",
          "50m-100m",
          "100m-200m",
          "200m-1b",
          "over-1b",
          null
        ],
        "description": "The range of annual revenue of the company in USD",
        "nullable": true
      },
      "NullableOfCompanyType": {
        "enum": [
          "unknown",
          "private",
          "public",
          "self-employed",
          "self-owned",
          "partnership",
          "nonprofit",
          "educational",
          "government",
          null
        ],
        "description": "The type of the company",
        "nullable": true
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "StateInfo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The ID of the state",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "The name of the state"
          },
          "code": {
            "type": "string",
            "description": "The ISO 3166-2 code of the state",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "description": "The latitude of the state",
            "format": "float",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "description": "The longitude of the state",
            "format": "float",
            "nullable": true
          }
        },
        "description": "The state information of the company",
        "nullable": true
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "description": "API Token used for authentication. Example: \"Authorization: Bearer {token}\"",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "tags": [
    {
      "name": "Company / Enrichment",
      "description": "Enrich company data by domain, properties, or in batch. Get company details by ID."
    }
  ]
}
````