Enterprise Search API

1. This interface is only available for entities located in mainland China. Users must ensure that this service is not used for any illegal purposes. Overseas users should choose other interface services.
2. By using this service, you agree to comply with all applicable laws and regulations and assume all responsibilities arising from improper use. We reserve the right to terminate services for users who violate the rules.

Interface Description

The Enterprise Search API allows users to obtain detailed enterprise information through company name keywords. The returned information includes basic enterprise information, business scope, key personnel, shareholder information, and industry information. The API provides structured metadata and Markdown format data, aimed at providing LLM (Large Language Model) friendly information content for AI applications to enhance intelligence and real-time capabilities.

API Protocol

End Point

GEThttps://huntwiz.com/v1/enterprise-search

params

Code Example

curl -X GET 'https://huntwiz.com/v1/enterprise-search'
--header 'Authorization: Bearer {api_key}'
--header 'Content-Type: application/json'
--data-urlencode 'ent_name=Baidu'

Note: Although our AI model will try to match the enterprise information you most want to know about, the ent_name should still be as complete as possible to avoid model hallucinations. A complete name can significantly improve accuracy.

Response Format

The API returns a JSON object containing the following main fields:

• status: Request status, "success" for success, "error" for failure
• markdown: Markdown format text containing enterprise information, easy for AI models to understand and process
• metadata: Contains structured detailed enterprise information and API usage data

Successful Response Example

{
  "status": "success",
  "markdown": "# Beijing Baidu Netcom Science and Technology Co., Ltd.\n\n## Basic Information\n\n- **Listed:** Yes\n- **Legal Representative:** Liang Zhixiang (Legal Representative)\n- **Establishment Date:** 2001-06-05\n- **Registration Number:** 110108002734659\n- **Unified Social Credit Code:** 91110000802100433B\n- **Enterprise Type:** Limited Liability Company (Invested or Controlled by Natural Person) (Code: Unknown)\n- **Registered Capital:** 13,421.28 million CNY\n- **Operating Period:** 2001-06-05 to 9999-12-31T00:00:00.000Z\n- **Registration Authority:** Beijing Haidian District Market Supervision Administration\n- **Approval Date:** 2023-06-25\n- **Operating Status:** In Business\n- **Address:** 2nd Floor, Baidu Building, 10 Shangdi 10th Street, Haidian District, Beijing\n\n## Business Scope\n\nGeneral items: Technical services, technology development, technology consulting, technology exchange, technology transfer, technology promotion; retail of computer hardware and software and auxiliary equipment; software development; computer system services; information system integration services; data processing services; digital content production services (excluding publishing); software sales; wholesale of computer hardware and software and auxiliary equipment; sales of electronic products; wholesale of electronic components; retail of electronic components; machinery and equipment leasing; advertising production; advertising publishing; advertising design and agency; professional design services; marketing planning; conference and exhibition services; information technology consulting services; enterprise management consulting; socioeconomic consulting services; household appliance sales; machinery equipment sales; hardware product retail; hardware product wholesale; toys, animation and amusement products sales; amusement products and indoor amusement equipment sales; textile products sales; camera and equipment sales; cosmetics wholesale; cosmetics retail; personal hygiene products sales; sports goods and equipment wholesale; sports goods and equipment retail; clothing and apparel retail; clothing and apparel wholesale; footwear and headwear retail; footwear and headwear wholesale; daily necessities sales; daily necessities wholesale; jewelry wholesale; jewelry retail; arts and crafts and ceremonial items sales (excluding ivory and its products); arts and crafts and collectibles wholesale (excluding ivory and its products); watch sales; eyewear sales (excluding contact lenses); toy sales; office supplies sales; motorcycle and parts retail; motorcycle and parts wholesale; instrument and meter sales; furniture sales; plastic products sales; building materials sales; communication equipment sales; food sales (pre-packaged food only); health food (pre-packaged) sales; cargo import and export; technology import and export; import and export agency; auto parts wholesale; auto parts retail; auto parts and accessories manufacturing; automobile sales; health consulting services (excluding medical services); ticket agency services; translation services; Class I medical device sales; Class II medical device sales; education consulting services (excluding education and training activities subject to approval); human resource services (excluding job intermediary activities and labor dispatch services). (Except for projects that must be approved according to law, independently carry out business activities in accordance with the business license) Licensed items: Value-added telecommunications business of Type I; Value-added telecommunications business of Type II; Internet culture operations; retail of publications; wholesale of publications; performance brokerage; job intermediary activities; production and operation of radio and television programs; information network dissemination of audio-visual programs; Internet news information service; surveying and mapping services. (For projects that must be approved according to law, business activities can be carried out after approval by relevant departments, and specific business projects are subject to approval documents or licenses from relevant departments) (Not allowed to engage in projects prohibited and restricted by national and municipal industrial policies.)\n\n## Key Personnel\n\n- **Liang Zhixiang:** Manager\n- **Cui Shanshan:** Supervisor\n- **Li Yanhong:** Executive Director\n\n## Shareholder Information\n\n- **Li Yanhong:** Natural Person Shareholder\n- **Cui Shanshan:** Natural Person Shareholder\n\n## Industry Information\n\n- **Industry Category:** M\n- **Industry Class:** 7, 5\n- **Industry Subclass:** Unknown\n\n## Number of Insured Employees\n\nUnknown\n",
  "metadata": {
    "usage": {
      "credits": 3,
      "remark": "api used for /v1/enterprise-search"
    },
    "content": {
      "ENTNAME": "Beijing Baidu Netcom Science and Technology Co., Ltd.",
      "HISTORYNAME": "",
      "LEGALPERSON": "Liang Zhixiang",
      "LEGALPERSONDESC": "Legal Representative",
      "ESDATE": "2001-06-05T00:00:00.000Z",
      "REGNO": "110108002734659",
      "PROVINCE": 11,
      "UNCID": "91110000802100433B",
      "ENTTYPE": "Limited Liability Company (Invested or Controlled by Natural Person)",
      "REGCAP": 1342128,
      "REGCAPCUR": "million CNY",
      "OPFROM": "2001-06-05T00:00:00.000Z",
      "OPTO": "9999-12-31T00:00:00.000Z",
      "REGORG": "Beijing Haidian District Market Supervision Administration",
      "APPRDATE": "2023-06-25T00:00:00.000Z",
      "REVOKEDATE": "",
      "ENTSTATUS": "In Business",
      "INDUSTRYPHY": "M",
      "INDUSTRYBIG": "75",
      "OPLOC": "2nd Floor, Baidu Building, 10 Shangdi 10th Street, Haidian District, Beijing",
      "OPSCOPE": "General items: Technical services, technology development, technology consulting, technology exchange, technology transfer, technology promotion; retail of computer hardware and software and auxiliary equipment; software development; computer system services; information system integration services; data processing services; ... (content omitted here)",
      "PERSONS": [
        {
          "NAME": "Liang Zhixiang",
          "POSITION": "Manager"
        },
        {
          "NAME": "Cui Shanshan",
          "POSITION": "Supervisor"
        },
        {
          "NAME": "Li Yanhong",
          "POSITION": "Executive Director"
        }
      ],
      "BE_INVEST": [
        {
          "INV": "Li Yanhong",
          "INVTYPE": "Natural Person Shareholder"
        },
        {
          "INV": "Cui Shanshan",
          "INVTYPE": "Natural Person Shareholder"
        }
      ],
      "CLEARINGINFO": []
    }
  }
}

Markdown Content Example

The content of the markdown field returned by the API is clearly structured, facilitating AI model parsing and response generation. Below is a preview of the returned content.

Beijing Baidu Netcom Science and Technology Co., Ltd.

Basic Information

• Legal Representative: Liang Zhixiang
• Establishment Date: 2001-06-05
• Registration Number: 110108002734659
• Unified Social Credit Code: 91110000802100433B
• Enterprise Type: Limited Liability Company (Invested or Controlled by Natural Person)
• Registered Capital: 13,421.28 million CNY
• Operating Status: In Business
• Address: 2nd Floor, Baidu Building, 10 Shangdi 10th Street, Haidian District, Beijing

Business Scope

General items: Technical services, technology development, technology consulting, technology exchange, technology transfer, technology promotion; retail of computer hardware and software and auxiliary equipment; software development; computer system services; information system integration services; data processing services; ... (content omitted here)

Key Personnel

• Liang Zhixiang: Manager
• Cui Shanshan: Supervisor
• Li Yanhong: Executive Director

Shareholder Information

• Li Yanhong: Natural Person Shareholder
• Cui Shanshan: Natural Person Shareholder

Industry Information

• Industry Category: M
• Industry Class: 75

Note: We may update the return format at any time to improve user experience.

Structured Data Field Description

The metadata.content field contains detailed structured information for precise data extraction and analysis:

Error Response Example

{
  "status": "error",
  "error": {
    "code": "invalid_parameter",
    "message": "Please provide a valid enterprise name keyword"
  }
}

AI-Friendly Data Design

The API provides two formats of data to support AI applications:

1. Markdown Format: The markdown field contains easy-to-read and parse text, suitable for directly generating replies or further natural language processing.

2. Structured Metadata: The metadata.content field provides detailed structured information, facilitating precise information extraction and analysis by AI models.

This dual data format design aims to enhance the intelligence and real-time response capabilities of AI applications, enabling them to better understand and utilize enterprise information.

Error Codes

Usage Restrictions

• Maximum 100 requests allowed per minute
• Maximum length of enterprise name keyword is 100 characters
• Daily API call limit may apply, specific to account settings

Billing Information

• Each query consumes 3 Credits
• Each query is considered a complete request regardless of the number of results returned
• The system checks the account Credits balance before the query
• Credits are deducted in one go after content processing is completed
• You can view the Credits consumed for this request in the metadata.usage field of the response

Data Update Frequency

Enterprise information is updated daily at 3:00 AM (Beijing Time). For real-time data, please contact our customer service team.

Best Practices

1. Provide the most complete and accurate enterprise name keyword possible to get the most relevant results.
2. Flexibly utilize Markdown and structured metadata according to the specific needs of the AI application.
3. Implement intelligent error tolerance and fuzzy matching functions in AI applications to handle possible spelling errors or incomplete enterprise names.
4. Reasonably control query frequency to avoid triggering frequency limits.
5. Regularly check account Credits balance to ensure normal API usage.
6. Consider caching information of frequently used enterprises in the application to reduce API calls and improve response speed.

Contact Us

If you have any questions or need further assistance, please contact our technical support team:

• Email: support@huntwiz.com
• Working Hours: Monday to Friday 9:00-18:00 (Beijing Time)

We are committed to providing you with quality service and support to ensure you can fully utilize our API to meet your business needs.