Executive External Positions Information API

1. 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.
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 Executive External Positions Information API allows users to obtain information about external positions of executives through enterprise names, unique enterprise identifiers (PID), or executive names. The returned information includes basic executive information such as name, position, shareholding ratio, as well as their positions in other enterprises. 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/b2b/person-invest

params

Code Example

curl -X GET 'https://huntwiz.com/v1/b2b/person-invest'
--header 'Authorization: Bearer {api_key}'
--header 'Content-Type: application/json'
--data-urlencode 'ent_name=Baidu'
--data-urlencode 'person_name=Robin Li'

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 executive external position information, easy for AI models to understand and process
• metadata: Contains structured detailed information about executive external positions and API usage data

Successful Response Example

{
  "status": "success",
  "markdown": "# He Jingyi Position Information\n\n## Basic Information\n\n- Name: He Jingyi\n- Person ID: 76e491711a55394fa04c9749da2d233e\n- Main Position: Supervisor\n- Shareholding Ratio: 0.4%\n\n## Main Employed Enterprise\n\n- Enterprise Name: Foshan Jinli Hardware Products Co., Ltd.\n- Unified Social Credit Code: 91440605MA4X872L1G\n- Enterprise ID: c168617eba800bf36d7f680c2db1d6d1\n\n## Associated Enterprise Positions\n\n| Enterprise Name | Unified Social Credit Code | Position | Is Legal Representative | Is Key Personnel | Is Shareholder | Is Registered Key Personnel | Is Registered Shareholder | Shareholding Ratio |\n|-----------------|----------------------------|----------|-------------------------|------------------|----------------|-----------------------------|--------------------------|--------------------|
| Foshan Jinli Hardware Products Co., Ltd. | 91440605MA4X872L1G | Supervisor | No | No | No | Yes | Yes | 0.4% |\n\n---\nNote: The above information is for reference only. Please refer to the industrial and commercial department registration for specific situations.\n",
  "metadata": {
    "usage": {
      "credits": 3,
      "remark": "API used for person investment info"
    },
    "content": {
      "person_name": "He Jingyi",
      "person_id": "76e491711a55394fa04c9749da2d233e",
      "person_position": "Supervisor",
      "share_ratio": "0.4",
      "ent_name": "Foshan Jinli Hardware Products Co., Ltd.",
      "uncid": "91440605MA4X872L1G",
      "pid": "c168617eba800bf36d7f680c2db1d6d1",
      "related_ent": [
        {
          "related_ent_name": "Foshan Jinli Hardware Products Co., Ltd.",
          "related_pid": "c168617eba800bf36d7f680c2db1d6d1",
          "related_uncid": "91440605MA4X872L1G",
          "related_position": "Supervisor",
          "is_fr": 0,
          "is_pub_person": 0,
          "is_pub_shareholder": 0,
          "is_reg_person": 1,
          "is_reg_shareholder": 1,
          "related_share_ratio": "0.4"
        }
      ]
    }
  }
}

Markdown Content Example

The content of the markdown field returned by the API has a clear structure, facilitating AI model parsing and response generation. The content includes the executive's basic information, main employed enterprise information, and positions in associated enterprises.

He Jingyi Position Information

Basic Information

• Name: He Jingyi
• Person ID: 76e491711a55394fa04c9749da2d233e
• Main Position: Supervisor
• Shareholding Ratio: 0.4%

Main Employed Enterprise

• Enterprise Name: Foshan Jinli Hardware Products Co., Ltd.
• Unified Social Credit Code: 91440605MA4X872L1G
• Enterprise ID: c168617eba800bf36d7f680c2db1d6d1

Associated Enterprise Positions

| Enterprise Name | Unified Social Credit Code | Position | Is Legal Representative | Is Key Personnel | Is Shareholder | Is Registered Key Personnel | Is Registered Shareholder | Shareholding Ratio | |-----------------|----------------------------|----------|-------------------------|------------------|----------------|-----------------------------|--------------------------|--------------------| | Foshan Jinli Hardware Products Co., Ltd. | 91440605MA4X872L1G | Supervisor | No | No | No | Yes | Yes | 0.4% |

---

Note: The above information is for reference only. Please refer to the industrial and commercial department registration for specific situations.

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, enterprise unique identifier (PID), or executive name"
  }
}

Error Codes

Usage Limitations

• Maximum 100 requests allowed per minute
• Maximum length of enterprise name or executive name is 100 characters
• Daily API call count may be limited, subject to account settings

Billing Description

• Each query consumes 1 Credit
• 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 full after the content is processed
• You can view the Credits consumed for this request in the metadata.usage field of the response

Data Update Frequency

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

Best Practices

1. Provide as complete and accurate enterprise names, enterprise unique identifiers (PID), or executive names as possible to obtain 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 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 executives in the application to reduce API calls and improve response speed.

Contact Us

If you have any questions or need further assistance, please feel free to 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.