Shareholder and Investment Information API

This interface is only available to 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.

By using this service, you agree to comply with all applicable laws and regulations and assume all responsibility for any misuse. We reserve the right to terminate service for users who violate the rules.

Interface Description

The Shareholder and Investment Information API allows users to obtain detailed shareholder and investment information through company name keywords. The returned information includes basic company information, shareholder information, etc. The API provides structured metadata and Markdown-formatted 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/b2b/invest-info

params

parameter	type	description	default
ent_name	string	Company name keyword

Code Example

curl -X GET 'https://huntwiz.com/v1/b2b/invest-info'
--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 company information you're most interested in, the ent_name should still be as complete as possible to avoid model hallucination. 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-formatted text containing shareholder and investment information, easy for AI models to understand and process
metadata: Contains structured detailed company information and API usage data

Successful Response Example

{
  "status": "success",
  "markdown": "# Beijing Baidu Netcom Science and Technology Co., Ltd. Shareholder and Investment Information\n\n## Basic Company Information\n\n- Unified Social Credit Code: 91110000802100433B\n- Registration Number: 110108002734659\n- Registered Capital: 13,421.28 million CNY\n- Listed: No\n\n## Shareholder Information\n\n| Shareholder Name | Shareholder Type | Subscribed Amount | Paid-in Amount | Contribution Method | Subscription Date | Payment Date | Shareholding Ratio |\n|------------------|------------------|-------------------|----------------|---------------------|-------------------|--------------|--------------------|\n| Robin Li | Natural Person | 13,354.1736 | 13,354.1736 | Currency | 2021-06-02 | 2016-03-28 | 99.500% |\n| Melissa Ma | Natural Person | 67.1064 | 67.1064 | Currency | 2021-06-02 | 2019-12-24 | 0.500% |\n\n---\nNote: The above information is for reference only. Please refer to the registration with the industrial and commercial department for specific details.\n",
  "metadata": {
    "usage": {
      "credits": 3,
      "remark": "API used for shareholder info"
    },
    "content": {
      "PID": "dad88a9938213e50c6472f6b77bf0210",
      "ENTNAME": "Beijing Baidu Netcom Science and Technology Co., Ltd.",
      "UNCID": "91110000802100433B",
      "REGNO": "110108002734659",
      "REGCAP": 13421.28,
      "REGCAPCUR": "Million CNY",
      "IS_LISTED": 0,
      "LISTEDTYPE": "",
      "STOCK": [],
      "BE_INVEST": [
        {
          "INV": "Robin Li",
          "INVTYPE": "Natural Person Shareholder",
          "LISUBCONAM": 13354.1736,
          "LIACCONAM": 13354.1736,
          "SUBCONFORMNAME": "Currency",
          "ACCONFORMNAME": "Currency",
          "SUBCONDATE": 1622649600000,
          "ACCONDATE": 1459180800000,
          "STOCKAMOUNT": "",
          "STOCKTYPE": "",
          "INSTO": "99.500"
        },
        {
          "INV": "Melissa Ma",
          "INVTYPE": "Natural Person Shareholder",
          "LISUBCONAM": 67.1064,
          "LIACCONAM": 67.1064,
          "SUBCONFORMNAME": "Currency",
          "ACCONFORMNAME": "Currency",
          "SUBCONDATE": 1622649600000,
          "ACCONDATE": 1577203200000,
          "STOCKAMOUNT": "",
          "STOCKTYPE": "",
          "INSTO": "0.500"
        }
      ]
    }
  }
}

Markdown Content Example

The content of the markdown field returned by the API has a clear structure, easy for AI models to parse and generate replies. Below is a preview of the returned content.

Beijing Baidu Netcom Science and Technology Co., Ltd. Shareholder and Investment Information
Basic Company Information

Unified Social Credit Code: 91110000802100433B

Registration Number: 110108002734659

Registered Capital: 13,421.28 million CNY

Listed: No

Shareholder Information
Shareholder Name Shareholder Type Subscribed Amount Paid-in Amount Contribution Method Subscription Date Payment Date Shareholding Ratio
Robin Li Natural Person 13,354.1736 13,354.1736 Currency 2021-06-02 2016-03-28 99.500%
Melissa Ma Natural Person 67.1064 67.1064 Currency 2021-06-02 2019-12-24 0.500%
Note: The above information is for reference only. Please refer to the registration with the industrial and commercial department for specific details.

Shareholder Name	Shareholder Type	Subscribed Amount	Paid-in Amount	Contribution Method	Subscription Date	Payment Date	Shareholding Ratio
Robin Li	Natural Person	13,354.1736	13,354.1736	Currency	2021-06-02	2016-03-28	99.500%
Melissa Ma	Natural Person	67.1064	67.1064	Currency	2021-06-02	2019-12-24	0.500%

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:

Field Name	Description
PID	Unique company ID
ENTNAME	Company name
UNCID	Unified Social Credit Code
REGNO	Registration number
REGCAP	Registered capital
REGCAPCUR	Registered capital currency
IS_LISTED	Whether listed (0: No, 1: Yes)
LISTEDTYPE	Listing type
STOCK	Stock information (if applicable)
BE_INVEST	Shareholder investment information

The STOCK field contains the following sub-fields:

Field Name	Description
TOTALSTOCK	Total share capital
STOCKTYPE	Stock type (e.g., A-shares, B-shares)

The BE_INVEST field contains the following sub-fields:

Field Name	Description
INV	Shareholder name
INVTYPE	Shareholder type
LISUBCONAM	Subscribed contribution amount
LIACCONAM	Paid-in contribution amount
SUBCONFORMNAME	Subscribed contribution method
ACCONFORMNAME	Paid-in contribution method
SUBCONDATE	Subscription date (timestamp)
ACCONDATE	Payment date (timestamp)
STOCKAMOUNT	Number of shares held
STOCKTYPE	Share type
INSTO	Shareholding ratio

Error Response Example

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

AI-Friendly Data Design

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

Markdown Format: The markdown field contains easy-to-read and parse text, suitable for direct use in generating replies or for further natural language processing.
Structured Metadata: The metadata.content field provides detailed structured information for 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 shareholder and investment information.

Error Codes

Error Code	Description
invalid_parameter	Provided parameter is invalid
not_found	No matching company information found
insufficient_credits	Insufficient account credits
rate_limit_exceeded	API call frequency limit exceeded

Usage Restrictions

Maximum 100 requests allowed per minute
Maximum length of company 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 lump sum after content processing is complete
You can view the Credits consumed for this request in the metadata.usage field of the response

Data Update Frequency

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

Best Practices

Provide as complete and accurate company name keywords as possible to get the most relevant results.
Flexibly utilize Markdown and structured metadata according to the specific needs of the AI application.
Implement intelligent error tolerance and fuzzy matching functions in AI applications to handle possible spelling errors or incomplete company names.
Reasonably control query frequency to avoid triggering frequency limits.
Regularly check account Credits balance to ensure normal API usage.
Consider caching shareholder information for commonly queried companies 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 that you can fully utilize our API to meet your business needs.