# CompanyResearchAPI

***

## 📘 法人番号情報取得API ドキュメント

### 📌 概要

このAPIは、日本の法人番号を入力すると、様々な情報を一元的にを取得し、法人の基本情報を返すサービスです。取得された情報はキャッシュされ、次回以降は高速に応答されます。

***

### 💰 利用料金

* **1リクエスト：5円（税込）**

***

### 🔗 エンドポイント

```
GET https://events-front.mixeder.net/v2/companyapi/?company={法人番号}
```

***

### 🔐 認証（オプション）

#### 認証

認証には、以下の方法でAPIキーを提供する必要があります。

1. **クエリパラメータ**: `?key=YOUR_API_KEY`
2. **POSTデータ**: `api-key=YOUR_API_KEY`
3. **ヘッダー**: `api-key: YOUR_API_KEY`

***

### 🧾 パラメータ

| パラメータ名 | 型      | 必須 | 説明       |
| ------ | ------ | -- | -------- |
| number | string | ✅  | 13桁の法人番号 |

***

### 📤 レスポンス例（JSON）

```
※JSONとして返答されるデータは
https://console.mixeder.net/studio/?category=enterdata&company=法人番号
こちらのURLでコンソールから確認することができます。
```

```json
{
  "status": "success",
  "cached": true,
  "last_updated": "2024-09-01",
  "number": "1234567890123",
  "name": "株式会社テスト",
  "address": "東京都千代田区丸の内１丁目",
  "kind": "株式会社",
  "google_results": [
    {
      "title": "株式会社テスト｜会社概要",
      "url": "https://www.example.com/about",
      "description": "株式会社テストの公式サイト。企業概要、サービス紹介、採用情報など。"
    },
    ...
  ]
}
```

***

***

### 🔄 ステータスコード

| ステータスコード | 内容         |
| -------- | ---------- |
| 200      | 正常取得成功     |
| 400      | リクエスト形式エラー |
| 404      | 該当する法人番号なし |
| 500      | サーバー内部エラー  |

***

### 🛠️ サンプルコード

#### 📌 JavaScript (fetch)

```javascript
async function getCorporateInfo(number) {
  const res = await fetch(`https://events-front.mixeder.net/v2/companyapi/?company=${number}`);
  const data = await res.json();
  console.log(data);
}
getCorporateInfo("1234567890123");
```

***

#### 🐍 Python (requests)

```python
import requests

number = "1234567890123"
res = requests.get(f"https://events-front.mixeder.net/v2/companyapi/?company={number}")
data = res.json()
print(data)
```

***

### 💡 ユースケース

#### ✅ 1. 顧客企業の正確な情報取得に

* 営業リストの整備
* クライアント情報の自動確認

#### ✅ 2. Webサービスの登録審査時に

* 登録時に法人番号を照合
* Google結果から不正・詐欺の兆候チェック

#### ✅ 3. 自社サービスへの連携

* データベース構築やBIツールへの連動
* 法人データの統一管理

***

### 🧾 利用上の注意

* 法人番号は必ず13桁で指定してください。

***

#### 掲載情報の修正・削除依頼

当サイトの掲載情報に関する修正・削除依頼はお願いいたします。

#### 掲載情報について

掲載情報は、以下の出典元の情報をもとに、EnterData独自が調査した情報を加えて作成しています。

<figure><img src="/files/EX0H9ReoE5LJDchVaNCH" alt=""><figcaption></figcaption></figure>

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.mixeder.net/mixederpublicapis/apirifarensu/companyresearchapi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.