ネットワーク・インフラAPI

Scraper

URLのメタ情報・OGP情報を取得します。

MCPツール名: get_page_meta

GET /v1/scraper/meta

パラメータ:

パラメータ	型	必須	説明
url	string	✓	情報を取得するURL（http/httpsのみ）

リクエスト例:

curl "https://api.thousand-api.com/v1/scraper/meta?url=https://example.com" \
  -H "x-api-key: YOUR_API_KEY"

レスポンス例:

{
  "url": "https://example.com",
  "title": "Example Domain",
  "description": "This domain is for use in illustrative examples.",
  "favicon": "https://example.com/favicon.ico",
  "ogp": {
    "title": null,
    "description": null,
    "image": null,
    "url": null,
    "site_name": null,
    "type": null
  },
  "canonical": "https://example.com/"
}

ExchangeRate

リアルタイムの為替レートと金額換算を返します。

MCPツール名: get_exchange_rate

GET /v1/exchangerate

パラメータ:

パラメータ	型	必須	説明
from	string	✓	変換元通貨コード（例: JPY）
to	string	✓	変換先通貨コード（例: USD）
amount	number	-	換算する金額（省略時は1）

リクエスト例:

curl "https://api.thousand-api.com/v1/exchangerate?from=JPY&to=USD&amount=1000" \
  -H "x-api-key: YOUR_API_KEY"

レスポンス例:

{
  "from": "JPY",
  "to": "USD",
  "rate": 0.0067,
  "amount": 1000,
  "converted": 6.7,
  "timestamp": "2026-05-20T00:00:00.000Z"
}

郵便番号検索

日本の郵便番号と住所を双方向に検索します。正引き（郵便番号→住所）・逆引き（住所キーワード→郵便番号候補）の両方に対応します。日本郵便の公式データ（約12万件）を使用しているため、LLMが知らない新設・廃止された郵便番号にも対応します。

MCPツール名: lookup_postal_code

country パラメータは将来の海外対応のために設計されています。現在は JP（日本）のみ対応しています。

GET /v1/postal/lookup

パラメータ:

パラメータ	型	必須	説明
code	string	-	郵便番号（正引き）。7桁数字または XXX-XXXX 形式（例: 358-0001）
address	string	-	住所キーワード（逆引き）。都道府県・市区町村・町域・カナの中間一致（例: 向陽台、入間）
country	string	-	国コード（デフォルト: JP）。現在 JP のみ対応
limit	integer	-	逆引き時の最大件数（デフォルト: 10、最大: 50）

レスポンスフィールド:

パラメータ	説明
query	リクエスト内容（code / address / country）
results	一致した郵便番号レコードの配列
results[].code	郵便番号（ハイフンなし7桁）
results[].code_formatted	郵便番号（ハイフンあり）
results[].prefecture	都道府県名
results[].prefecture_kana	都道府県名カナ
results[].city	市区町村名
results[].city_kana	市区町村名カナ
results[].town	町域名
results[].town_kana	町域名カナ
results[].full_address	都道府県+市区町村+町域の結合
results[].country	国コード
count	返却件数
truncated	limit により件数が制限されたか（逆引き時）

リクエスト例:

例1: 正引き（郵便番号→住所）

curl "https://api.thousand-api.com/v1/postal/lookup?code=358-0001" \
  -H "x-api-key: YOUR_API_KEY"

{
  "query": { "code": "358-0001", "country": "JP" },
  "results": [
    {
      "code": "3580001",
      "code_formatted": "358-0001",
      "prefecture": "埼玉県",
      "prefecture_kana": "サイタマケン",
      "city": "入間市",
      "city_kana": "イルマシ",
      "town": "向陽台",
      "town_kana": "コウヨウダイ",
      "full_address": "埼玉県入間市向陽台",
      "country": "JP"
    }
  ],
  "count": 1,
  "truncated": false
}

例2: 逆引き・市区町村（複数候補）

curl "https://api.thousand-api.com/v1/postal/lookup?address=%E5%85%A5%E9%96%93%E5%B8%82" \
  -H "x-api-key: YOUR_API_KEY"

{
  "query": { "address": "入間市", "country": "JP" },
  "results": [
    {
      "code": "3580001",
      "code_formatted": "358-0001",
      "prefecture": "埼玉県",
      "city": "入間市",
      "town": "向陽台",
      "full_address": "埼玉県入間市向陽台",
      "country": "JP"
    }
  ],
  "count": 10,
  "truncated": true
}

例3: 逆引き・町域（中間一致）

curl "https://api.thousand-api.com/v1/postal/lookup?address=%E5%90%91%E9%99%BD%E5%8F%B0" \
  -H "x-api-key: YOUR_API_KEY"

{
  "query": { "address": "向陽台", "country": "JP" },
  "results": [
    {
      "code": "3580001",
      "code_formatted": "358-0001",
      "prefecture": "埼玉県",
      "city": "入間市",
      "town": "向陽台",
      "full_address": "埼玉県入間市向陽台",
      "country": "JP"
    }
  ],
  "count": 1,
  "truncated": false
}

IPLookup

IPアドレスの地理情報（国・地域・都市・緯度経度）を取得します。

MCPツール名: get_ip_info

GET /v1/iplookup

パラメータ:

パラメータ	型	必須	説明
address	string	-	検索するIPアドレス（省略時はリクエスト元のIP）

リクエスト例:

curl "https://api.thousand-api.com/v1/iplookup?address=8.8.8.8" \
  -H "x-api-key: YOUR_API_KEY"

レスポンス例:

{
  "is_valid": true,
  "address": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "city": "Mountain View",
  "zip": "94043",
  "lat": 37.4223,
  "lon": -122.0847
}

URLリダイレクト追跡

URLの最終リダイレクト先を追跡します。短縮URL・アフィリエイトURLの実体確認やリンクの安全性チェックに使えます。Scraperツールと組み合わせることで短縮URLの先のページ情報も取得できます。

MCPツール名: resolve_url

GET /v1/url/resolve

パラメータ:

パラメータ	型	必須	説明
url	string	✓	追跡するURL（http/httpsのみ）

url パラメータは URL エンコードが必要です（例: https://bit.ly/xxxxx → https%3A%2F%2Fbit.ly%2Fxxxxx）。

リクエスト例:

curl "https://api.thousand-api.com/v1/url/resolve?url=https%3A%2F%2Fbit.ly%2Fxxxxx" \
  -H "x-api-key: YOUR_API_KEY"

レスポンス例:

{
  "original": "https://bit.ly/xxxxx",
  "final": "https://example.com/product/123",
  "redirects": [
    "https://bit.ly/xxxxx",
    "https://example.com/product/123"
  ],
  "redirect_count": 1,
  "has_redirect": true
}

レスポンスフィールド:

パラメータ	説明
original	リクエストしたURL
final	リダイレクト追跡後の最終URL
redirects	通過したURLの配列（original から final まで）
redirect_count	リダイレクト回数（redirects.length - 1）
has_redirect	リダイレクトが1回以上あった場合 true
truncated	最大10ホップに達した場合のみ true

レスポンス:

http/https のみ追跡。各ホップのタイムアウトは5秒。最大10回のリダイレクトまで追跡し、超過時は truncated: true を返します。

URLヘルスチェック

URLのステータスコード・レスポンスタイム・SSL証明書情報を確認します。resolve_urlと組み合わせることで短縮URLの最終リダイレクト先のヘルスも確認できます。

MCPツール名: inspect_url

GET /v1/url/inspect

パラメータ:

パラメータ	型	必須	説明
url	string	✓	検査するURL（http/httpsのみ）

リクエスト例:

curl "https://api.thousand-api.com/v1/url/inspect?url=https%3A%2F%2Fwww.thousand-api.com" \
  -H "x-api-key: YOUR_API_KEY"

レスポンス例:

{
  "url": "https://www.thousand-api.com",
  "status_code": 200,
  "response_time_ms": 234,
  "reachable": true,
  "headers": {
    "content-type": "text/html",
    "x-frame-options": "DENY"
  },
  "ssl": {
    "valid": true,
    "expires_at": "2027-01-01T00:00:00.000Z",
    "days_remaining": 220,
    "issuer": "Amazon"
  }
}

DNSルックアップ

ドメインのDNSレコードを取得します。A / AAAA / CNAME / MX / TXT / NS に対応。Node.js標準dns使用・外部依存なし。

MCPツール名: dns_lookup

GET /v1/dns/lookup

パラメータ:

パラメータ	型	必須	説明
domain	string	✓	検索するドメイン名
type	string	-	A / AAAA / CNAME / MX / TXT / NS / all（デフォルト: all）

リクエスト例:

curl "https://api.thousand-api.com/v1/dns/lookup?domain=example.com&type=all" \
  -H "x-api-key: YOUR_API_KEY"

レスポンス例:

{
  "domain": "example.com",
  "type": "all",
  "records": {
    "A": ["93.184.216.34"],
    "NS": ["a.iana-servers.net", "b.iana-servers.net"],
    "TXT": ["v=spf1 -all"]
  }
}