# 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独自が調査した情報を加えて作成しています。
