ParseAPI

parseapi-mcp

公式 ParseAPI MCP サーバーです。AI エージェントから、場所、住所、企業番号、メール、電話番号、天気、タイムゾーン、日付などを検索できます。

ホスト型

URL 1 つで利用でき、インストールは不要です。サーバーを追加し、ブラウザーで一度サインインするだけです。無料プランでも利用できます。

{
  "mcpServers": {
    "parseAPI": { "url": "https://mcp.parseapi.com" }
  }
}

Cursor： Cursor に追加

リポジトリルートの .mcp.json にキーがないのは意図的です。cursor.directory は、掲載情報を送信または更新すると自動検出します。

CI やヘッドレス環境では、ブラウザーを使わずに parseapi.com のキーを使用できます。

{
  "mcpServers": {
    "parseAPI": {
      "url": "https://mcp.parseapi.com",
      "headers": { "X-API-Key": "your-api-key" }
    }
  }
}

ローカル

{
  "mcpServers": {
    "parseAPI": {
      "command": "npx",
      "args": ["-y", "parseapi-mcp"],
      "env": { "PARSEAPI_KEY": "your-api-key" }
    }
  }
}

API バージョン

バージョン 1.0.0 以降、このパッケージは、この MCP パッケージがサポートする API コントラクトを明示的に選択します。すべての API ツールリクエストで Parse-Version: 2.0.0 を送信します。これは、このリリースのツールの説明と SDK のレスポンス型に対応しています。リトライを含め、ローカルの stdio とホスト型 HTTP の両方でコントラクトは固定されます。キー、OAuth ID、チームに保存されているデフォルト設定は変わりません。

ローカルの stdio では、アプリケーションの設定で MCP パッケージのバージョンを固定し、デプロイ前に新しいリリースをテストしてください。将来のメジャー MCP アップグレードで、より新しい API コントラクトが選択される場合があります。個々のツール呼び出しにバージョン引数を追加する必要はありません。ホスト型サービスでは、デプロイ済みの MCP リリースがサポートする API コントラクトが使用されます。

1.0.0 より前の MCP パッケージは従来の動作を維持し、チームのデフォルト設定を使用します。古いアプリケーションが依存している間は、そのデフォルト設定を変更しないでください。バージョンヘッダーのないパッケージにロールバックすると、チームのデフォルト設定が再び使用されます。そのため、デフォルト設定が変更されていない場合に限り、ロールバックで以前のコントラクトが復元されます。API バージョンと移行を参照してください。

ツール

フルモードでは、ローカル向けに 68 個、ホスト型向けに 67 個の検索ツールを提供し、さらにローカルメタデータ用の discover と、認証済みタスクの見積もり用の preflight を提供します。ip_self はローカル専用です。time は現在の現地時刻と Unix 秒を返します。タイムゾーンまたは座標を受け取り、どちらも省略された場合は UTC がデフォルトになります。date は指定された日付を解析し、省略された場合は UTC の今日の日付を返します。既存の timezone 呼び出しは、元の引数のまま引き続きサポートされます。各検索結果は、API が返す JSON をそのまま返します。

ツール名は検索対象に対応しています。country_states、city_search、postal_nearby、address、address_search、company、company_id、company_search、company_coverage、email、bank_us_ach、card、industry、industry_search、dns、asn、mac、currency_rate などです。テキスト検索では query を指定します。企業ディレクトリの検索では、名前、ドメイン、ティッカー、識別子のいずれか 1 つを選択するか、国や完全一致 SIC の検索フィルターを指定できます。

既存の naics ツールと naics_search ツールは、Industry の互換用の名前として引き続き利用できます。

Industry の有料ディープレコードには、説明と関連コードを含む分類 deep.exclusions が含まれます。一般的な除外項目には、関連コードがない場合があります。古いレスポンスで除外項目が省略されている、または null の場合、その情報は不明のままです。検索結果には match も含まれます。これは、マッチした field（name、term、naics）と text、および誤字のフォールバックで修正されたトークンの from と to を含む corrections です。完全一致、複数形、前方一致の場合、corrections は空です。コードを直接検索した場合、match は省略されます。古いレスポンスでは、これが省略されている場合があります。

ツール引数の例：

Tool	Arguments
stack	{"domain":"example.com"}（カテゴリ別のウェブサイト技術とバージョン）
domain	{"domain":"example.com"}（登録状況）
domain	{"domain":"example.com","deep":true}（有料プランでの登録詳細）
dns	{"domain":"example.com","type":"TXT"}
mx	{"domain":"example.com"}
asn	{"asn":"AS13335"}
card	{"bin":"424242"}
country_states	{"code":"US"}
address_search	{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}
company	{"number":"552100554","country":"FR"}
company_search	{"query":"Cloudflare","country":"US"}
company_id	{"id":"co_xw3f22es6cjq","deep":true}
company_coverage	{}
time	{}（現在の UTC 時刻）
time	{"timezone":"America/New_York","at":"2026-09-05T09:00:00","to":"Asia/Tokyo"}
time	{"lat":40.71,"lon":-74.01}
time	{"timezone":"UTC","targets":["America/New_York","Asia/Tokyo"]}
time_zones	{"query":"New York"}
time	{"timezone":"America/New_York","at":"2026-11-01T01:30:00","to":"UTC","disambiguation":"later"}
date	{"date":"03/04/2026","format":"dmy"}
elevation	{"lat":35.2271,"lon":-80.8431}
elevation	`{"points":"35.2271,-80.8431
elevation	`{"path":"35.2271,-80.8431

disambiguation が使用されるのは、to または targets が指定され、at にオフセットがない場合のみです。デフォルトの compatible は、重複する時刻では早い方を選択し、存在しない時刻では時刻を先に進めます。earlier と later はそれぞれ該当する時点を選択します。reject は、重複する時刻では ambiguous_time を、存在しない時刻では nonexistent_time を返します。ユーザーが入力した予定には、この設定を使用してください。ローカル時刻の再試行を拒否する前に、明示的なオフセットを指定するか、ユーザーにどちらを選ぶか確認してください。明示的なオフセットは時点を直接指定します。すべてのプランで、Time Deep は同じプールされたリクエストで利用できます。

Time Deep には、null 許容の resolution が含まれます。Resolution は、kind（unique、overlap、gap）、policy、符号付きの adjustment_seconds、および正確なローカル時刻 at、Unix 秒、UTC オフセットを含む時系列順の alternatives を示します。一意な壁時計時刻には alternatives がありません。明示的なオフセット付きタイムスタンプ、現在の時刻、変換を伴わない照会、ソースのタイムゾーンが不明な場合、resolution は null になります。

Elevation では、lat と lon、points、または samples を伴う path のうち、いずれか1つだけを指定できます。ポイントリストでは、lat,lon のペアを | で区切って最大512個の座標を指定するか、Google のエンコード済みポリラインを enc: に続けて指定できます。文字数の上限は12000文字です。points のレスポンス配列は、入力順と重複する座標を保持します。各サンプルには、メートル、フィート、メートル単位のグリッド解像度が含まれます。不明なサンプルは null のままです。リストではプールされたリクエストが1つ使用され、URL が長い場合は JSON POST が自動的に選択されます。

パスには同じ文字列形式を使用し、2～512個の頂点と、2～512の範囲の必須の整数 samples を指定します。レスポンスの points には両端の点が含まれ、パスに沿った累積大円距離に基づいて均等に配置されます。各セグメントは最短の弧に沿います。対蹠点を端点とするセグメントは、一意の弧が定まらないため拒否されます。パスではプールされたリクエストが1つ使用されます。単一の座標またはポイントリストでは samples は無効です。

Australian postal lookup は、サバーブの選択肢（city、state、state_name）を含む主要な localities を返します。null または省略されたフィールドは不明を意味し、[] は確認済みの参照情報に該当する選択肢がないことを意味します。選択肢が1つだけの場合でも、city: null と併存することがあります。サバーブの選択をユーザーに確認し、手動入力も可能な状態にしてください。これらは地理的な選択肢であり、郵送先住所の検証ではありません。AU Postal ツールの結果には、JSON の後に個別の出典に関する通知が含まれます。G-NAF の出典、改変内容、ライセンス。 住所検索では、米国とフランスの標準化された構成要素と登録状況が返されます。deep オブジェクトは現在空です。国内の電話番号による company 検索では、有効性、登録状況、および入手可能な場合は事業の詳細が返されます。address_search では、候補を絞り込んだり順位付けしたりするために、postal と ip も指定できます。フランスを検索するには、country: "FR" と postal または city のいずれかが必要です。

企業ディレクトリを利用するには、company_search に query、 domain、ticker、identifier のうち最大 1 つを指定して呼び出します。ticker には exchange を、 identifier には authority を指定します。候補を確認した後、選択した id を company_id に渡します。次のページを取得するには、返された next を cursor として、同じセレクター、 フィルター、limit とともに指定します。Directory deep はすべてのプランで同じプールされたリクエスト内に詳細情報を追加し、各企業の結果に含まれます。 選択されたウェブサイトの説明、ロゴ、ソーシャルアカウント、設立に関する情報は、入手可能な場合に返されます。ロゴ URL は画像を取得せずに返されます。ディレクトリのツールでは lang を指定できません。company_coverage はエディションの収録レコードを示します。該当する企業が見つからなくても、非公開企業であることの証明にはなりません。既存の company ツールは引き続き、国内の登録番号を解析します。

識別セレクターを使わずに検索する場合は、country、または industry と industry_type の両方を指定します。たとえば、{ "country": "US", "industry": "0700", "industry_type": "sic" } です。対応している名前空間は SIC です。4 桁の正確なコードは文字列のまま指定します。空のリクエスト、不完全な業種ペア、複数のセレクターは拒否されます。country はプロフィールの国を表します。フィルターは AND 条件で適用され、不明な値は一致しません。返されたカーソルを使う場合は、同じフィルターと limit を指定する必要があります。フィルターのみで抽出された候補には、match: { "field": "filters", "value": null } が含まれます。

Paid Deep では、公開順の taxonomies も返されます。これには、タクソノミーコード、専門分野のラベル、主資格のフラグ、プロバイダーから報告されたライセンス番号と州に加え、レコードの日付である enumerated_at、updated_at、reactivated_at が含まれます。報告されたライセンスは、検証済みのライセンスではありません。リストが null の場合は情報を取得できず、空の場合はそのエディションにエントリーがないことを意味します。プロバイダーのレコード日付は、プロバイダーのレコードを示すものであり、リアルタイムの検証を示すものではありません。

通常の検索では、一時的な障害の後、最大 2 回再試行します。有効な Retry-After が指定されており、待機時間が 5 秒以下の場合はこれに従います。5 秒を超える場合は、早めに再試行せず、API エラーをただちに返します。レスポンスにこのヘッダーが含まれる場合、エラーには元の秒数または HTTP 日付の値を示す retry_after が含まれます。従量制の検索と住所の deep チェックは、デフォルトで再試行しません。ツール呼び出しをキャンセルすると、保留中の SDK リクエストもキャンセルされます。

エラーは、機械可読な code を含む JSON として返されます。分岐にはメッセージ文字列ではなく、必ず code を使用してください。該当なしの場合は not_found です。キーがない場合は invalid_api_key です。

エージェントの検出

ルックアップを実行する前に、操作で何を確認できるかを discover に問い合わせます。

{ "operation": "email" }

結果には、実際の入力スキーマと、機能、鮮度、不確実性、課金単位、認証情報の種類、再試行に関する確認済みのポリシーが含まれます。JSON テキストと MCP の structuredContent には、同じ結果が含まれます。Email、Domain、DNS、MX、Country、Time、timezone の検出には、確認済みのポリシーがあります。その他の操作では、policy: null を含む入力スキーマが返されます。フィールドの意味は操作ごとに異なります。不明な結果が、自動的に再試行すべき理由になるわけではありません。

操作を検索するには { "query": "mailbox" } を使用します。検索では、デフォルトで最大5件の概要が返されます。detail: "full" を指定すると、スキーマとポリシーも含まれます。limit と、返された next_offset を使用して、結果をページ分割できます。メタデータの呼び出しでは API リクエストは行われず、ルックアップ単位も消費されません。ホスト型 HTTP では、検出の前に従来どおり認証が必要です。

ポリシーは API の契約を説明するものです。effective_access: "not_evaluated" と pricing: "not_quoted" は、検出時に認証情報の権限、残りの利用可能枠、適用される料金が確認されていないことを示します。アカウント固有の見積もりを確認するには preflight を使用してください。読み取り専用のルックアップでも、有料の単位を消費する場合があります。

使用前に、シークレットキーと操作ごとの件数を指定して preflight を呼び出します。

{
  "operations": [{ "operation": "email", "count": 100, "deep": true }],
  "budget_usd": "2.50"
}

Preflight は Email、Domain、DNS、MX、Country に対応し、最大20行、合計100,000件のルックアップを指定できます。ルックアップ入力や個人データは必要ありません。permitted、cost.status、capacity、budget.within_maximum をまとめて確認してください。金額は10進文字列です。最大額は、Email の付属チェックを使い切った場合を想定しています。予測では、現在割り当てられていない付属チェックを使用します。不明な値は null のままです。どちらの金額にも、認証情報に適用される料金が使われます。

見積もりでは、通常のルックアップは最大3回、Email Deep のルックアップは1回の試行を想定しています。追加の呼び出しや再試行には、新しい見積もりが必要です。同時に処理が行われると、利用可能枠が変化することがあります。Preflight は単位や金額を予約せず、有料チェックも実行せず、指定された予算を強制しません。通常のリクエストレート制限が適用されます。サブスクリプション料金、税金、モデルの費用は含まれません。Preflight は API 契約 2.0.0 と、対応する JavaScript SDK 1.2.0 以降を使用します。

コンパクトなツールカタログを使用するには、MCP プロセスで PARSEAPI_MCP_MODE=compact を設定します。

PARSEAPI_MCP_MODE=compact npx -y [email protected]

ルックアップには、プロセス環境で PARSEAPI_KEY を設定します。コンパクトモードでは、discover、preflight、lookup の3つのツールが公開されます。操作を検出した後、正確な名前と引数を渡します。

{ "operation": "country", "arguments": { "code": "US" } }

lookup は、名前付きツールと同じ入力検証、キャンセル、バージョン固定、SDK、課金の動作を使用します。実行する操作は1つで、任意のコードを実行したり、任意の URL をリクエストしたりすることはできません。フルモードがデフォルトで、既存の名前付きルックアップ呼び出しが維持されます。同じプロセス設定は、セルフホスト型 HTTP にも対応しています。

ポリシーのソースは API の src/route/help/agent-catalog.json です。現在の API ヘルプでは、同じメタデータが agent として公開されています。固定された API 1.0.0 のヘルプは変更されません。ParseAPI ワークスペースで、確認済みのポリシー変更をコピーするには npm run catalog:sync を実行し、その後 npm run catalog:check を実行します。独立したチェックアウトでは、-- --source /path/to/api を指定できます。パッケージのビルドではチェックイン済みのコピーを使用するため、API のチェックアウトやネットワークリクエストは必要ありません。

一括ファイル処理

エージェントは、いずれかのカタログモードで5つのツールを使用して、CSV全体を処理できます。

ツール	操作
bulk_upload	ファイル名と正確なバイト数から、アカウント所有のジョブを作成し、非公開のアップロードURLを取得します。
bulk_preview	アップロードを確認し、検出された列を分析して、チェック項目を選択し、サンプルと見積もりを取得します。
bulk_start	ユーザーが承認した米ドルセント単位の max_cost_cents の範囲内で、現在の見積もりに基づいて処理を開始します。
bulk_status	進行状況と、必要なユーザー操作を確認します。
bulk_result	処理済みファイルの非公開ダウンロードURLを取得します。

エージェントには、ファイルを扱えるランタイムが必要です。HTTP PUTを使用し、upload_headers を指定して、CSVのバイト列を upload_url に直接転送してください。ExcelまたはNumbersのファイルは、まずそのランタイムでCSVに変換してください。ツールの引数にはファイルのメタデータとジョブIDを指定します。ファイルの内容、base64、ソースURL、サーバーのファイルシステムパスは受け付けません。

最初に、アップロードの id を指定し、checks は指定せずに bulk_preview を呼び出して、アップロードの完了を確認し、分析を依頼します。job.status が quoted になるまで bulk_status をポーリングします。次に、検出された列に存在する操作を選択するため、必要に応じて ["email", "phone", "ip"] などの checks を指定して bulk_preview を呼び出します。選択を変更すると、分析が再度依頼されます。応答に最新の quote が含まれるまで、ステータス確認とプレビューを繰り返します。開始する前に、サンプルと必要な設定を確認してください。

bulk_start には、id、quote_id として指定する quote.id、およびユーザーが承認した max_cost_cents が必要です。0を指定すると、追加コストが0の場合のみ許可されます。サーバーは見積もりと上限を検証します。有料ジョブでは必要に応じて支払い手続きへの案内が返されます。このツールが保存済みカードに請求することはありません。開始リクエストを再試行する場合は、同じジョブ、見積もり、上限を使用してください。作成応答が失われても、確認なしに2回目のアップロードを行わないでください。

処理済みの download_url は、APIキーのヘッダーを付けずに直接取得してください。URLは有効期限があり、非公開のアクセス権限を持ちます。ユーザーが別途調査を依頼しない限り、ファイルの内容がモデルのコンテキストに入ることはありません。顧客のフォローアップタスクでは、元の列と不明な回答を保持してください。

既存のBulkジョブURLは引き続き共有できます。ジョブIDとダウンロードURLは、ファイルへのアクセス権限として扱ってください。

既存のAPIキーまたはOAuth接続が、これらのジョブを所有します。ウェブサイトのオリジンは、検索APIのオリジンとは独立して PARSEAPI_WEB_URL で設定できます。

表示言語

このソース候補では、対応ツールに任意の lang が追加されます。たとえば、 country では {"code":"DE","lang":"fr"} を指定できます。これを利用するには、対応するAPIのローカライズ版リリース、データ、JS SDKパッケージが必要です。既存の公開パッケージをインストールしても、この機能は有効になりません。

表示名は、利用可能なソース翻訳に従います。ID、現地語名フィールド、数値、入力解析は変更されません。言語を省略すると、デフォルトの動作が維持されます。HolidayツールとProveツールに、新しい言語引数はありません。

開発

npm install
npm run typecheck
npm test          # builds and tests with mocked fetch and in-memory MCP
npm run eval:agents # offline benchmark self-test, no model or live API calls
npm run smoke     # stdio + http, includes live API authentication checks
npm run serve     # http on :8080

オフラインテストでは、test/public-api.json に記載された公開ツール名と引数スキーマを固定し、すべての操作とクエリオプションを実行して、エラー、再試行、キャンセルを検証します。ベースラインの変更は、公開APIの変更として確認してください。公開前に、まず型チェックとオフラインテストが実行されます。

エージェントベンチマークでは、合成API応答を使用した固定タスクで、完全な検出とコンパクトな検出を比較します。スクリプト化された参照実行で検証されるのは、ハーネスと採点方法であり、エージェントのタスク完了品質ではありません。アダプターが測定済みの使用量を提供するまでは、モデルのトークン数とコストはnullのままです。フィクスチャの請求はシミュレーションであり、実際の請求とは常に別に表示されます。

MITライセンスです。

詳細情報（任意）

まずデフォルトのツール呼び出しを使用してください。より詳細な情報を得るには、同じツールで deep: true を指定します。Time、Date、Language、Emoji、Phone、Point では、すべてのプランで詳細情報が提供されます。Geographic profiles、Name evidence、NAICS definitions には有料プランが必要です。Carrier と HLR の詳細情報は、Free の利用枠を含め、同じ従量制の基本単位に含まれており、追加料金や二重の利用制限はありません。

検索の詳細情報は、返された各エンティティに紐づきます。時刻変換では、変換先の表示に関する詳細情報が to.deep に含まれます。deep.next_dst を返すのは変換元のみです。Name の基本的な解析に辞書検索は必要ありません。有料プランの Name deep では、フラットな short、directory、initials も返されます。任意の name_locale を指定すると CLDR の書式規則が選択されます。デフォルトは en で、解析や性別のコンテキストは変わりません。利用できない書式は null となり、以前のレスポンスではこれらのフィールドが省略される場合があります。Country、State、Postal の税務上の参照情報は、有料プランの deep データに含まれます。

Stack API

stack ツールを呼び出します。

{"domain":"example.com"}

スキーム、パス、ポート、IP アドレスを含まない公開ホスト名を渡してください。Stack は、確認した URL と checked_at の時刻に続いて、scope、pages、partial を返します。scope は homepage または site です。pages は確認に成功した HTML ページの数です。ホームページのみの確認、または範囲を限定したサイト確認が不完全な場合、partial は true になります。false は、対象範囲内で判明している候補の確認が完了したことを意味し、ウェブサイト上のすべてのページを訪問したという意味ではありません。ホームページの結果は scope: "homepage"、pages: 1、partial: true になります。

cms、servers、frameworks、ecommerce、analytics、chat、payments、hosting は、サイトが各カテゴリで複数のテクノロジーを使用できるため、配列になっています。各エントリには technology、name、null 許容の version が含まれます。テクノロジーコードはオープンな文字列です。確認が成功し、該当するものがないカテゴリには空の配列が使われます。確認可能な HTML ページがない場合、checked_at とすべてのカテゴリは null、pages は 0、partial は null になります。不明なバージョンや競合するバージョンは null です。検出されなかったことは、不在の証明にはなりません。

確認に成功した結果は、最大 24 時間再利用される場合があります。pretty を指定すると、ワイヤー JSON を整形できます。Stack はプランのリクエスト枠を使用し、このクライアントが選択する API バージョン 2.0.0 を使用します。

stack ツールでは、初回確認の試行ごとに 35 秒の制限があります。MCP のキャンセルがあった場合、リクエストは引き続き中止されます。

time の targets は、to の代わりに宛先 ID を 1～10 個受け付けます。結果は、1 回のプールされたリクエストで、指定された順序と重複を保ったまま、同一時点の値を返します。送信元の座標が不明な場合、targets: null が返されます。宛先 ID が不明な場合、リクエスト全体に対して not_found が返されます。提供されている ID を検索するには time_zones を使用するか、完全なソート済みリストを取得するにはクエリを省略します。検索結果が空の場合は timezones: [] です。

time は、明示的に指定された IP アドレス、都市、国、IATA 空港、ICAO 空港、港の UN/LOCODE、または住所の入力を 1 つ受け付けます。国／州を指定すると、都市や住所を絞り込めます。住所の地点検索では、現在、米国の国コンテキストが必要です。ホスト型の呼び出しで、サーバーがユーザーの IP アドレスを推測することはありません。入力が曖昧または不足している場合、時計関連のフィールドは null となり、location の候補が返されます。不足しているコンテキストを尋ねるか、候補を黙って選択するのではなく、ユーザーに選んでもらってください。

time_zones は、国、IANA エリア、正確なオフセット、略称、指定時点の DST、または UTC 暦年内の DST 発生で絞り込めます。明示的に指定された false のフィルターは保持されます。details を指定すると、詳細な行と共通の評価時点が追加されます。デフォルトの識別子リストは簡潔なままです。略称を指定すると、候補となるタイムゾーンが返されます。ソースの deep では、標準オフセットと符号付き季節オフセットに加え、実際の DST シーズンの切り替わり境界が公開されます。季節調整の負の値と null の境界は、そのままの意味を保持します。

銀行ツールは、元の IBAN、ルーティング番号、口座番号の文字列を POST JSON ボディで送信するため、口座情報が URL に含まれることはありません。bank では、任意の国指定と deep 制御が引き続き使用できます。deep のディレクトリ証拠では、ディレクトリ検索が実行された場合に、変更されないソース版と実際の照合粒度が特定されます。これは、国全体の網羅性や到達可能性を証明するものではありません。bank_us_ach は、ルーティング番号と口座番号の文字列を受け取り、ABA ルーティングチェックサムと口座フィールドの構文を確認します。deep オプションはなく、口座チェックサム、存在、所有権、ACH 適格性を検証することはできません。口座番号のすべての文字と先頭のゼロを保持してください。bank_requirements は、国と任意の形式（デフォルトは iban、または us_ach）を受け取り、受け付けるフィールド、確認範囲、制限事項を返します。要件はメタデータであり、銀行の網羅状況を示すものではありません。銀行情報を含むツール引数やリクエストボディをログに記録しないでください。

米国の ACH 情報に銀行名が含まれる場合、MCP は変更されていない JSON 結果に加えて、別途ルーティング情報の出典表示を含めます。

絵文字カタログの追加機能

Unicode 絵文字または名前付きショートコードを解決し、範囲を限定したカタログを検索または閲覧し、テキスト内の絵文字の位置を解析して、Unicode と選択したショートコードソース間で変換します。 通常の検索結果は引き続き4つのフィールドで構成されます。

GET /emoji/rocket

{"emoji":"🚀","name":"Rocket","shortcodes":[":rocket:","rocket"],"category":"Travel & Places"}

Unicode の情報、キーワード、トーンファミリー、利用可能なアートワークを取得するには、deep=true を指定してください。 コア値は変更されません。テキスト解析では UTF-16 の positions を含む emojis が返され、変換では text と、位置および理由を含む未解決トークンが返されます。

コンパクトな JSON カタログには、オフラインで利用できる識別情報、適格性フォーム、ショートコードのインデックスが含まれています。アートワークが必要な場合は profile=full を、ローカライズされた名前とキーワードが必要な場合は lang をリクエストしてください。/emoji/metadata には、データセットの網羅範囲と共通のソース通知がまとめて記載されています。アートワークは Google Noto、Twemoji、OpenMoji に対応し、実際に利用可能な SVG/PNG と不変のファーストパーティ URL を提供します。通常の表示には、デバイスの絵文字フォントが引き続き使用されます。

これらの追加機能は、対応する SDK とバックエンドが公開されるまで、ローカル版のリリース候補です。既存の検索および検索結果の仕様は維持されます。

正規 City 操作

従来の検索、検索、最寄り、名前指定の近隣検索メソッドでは、デフォルトのエンベロープと必須フィールドモデルが維持されます。閲覧と座標指定の近隣検索では、正規リストとして object、data、nullable な next_cursor を使用します（Swift/Kotlin では camelCase プロパティ）。ページを続けて取得する場合は、すべてのクエリーオプションを変更せずに指定してください。クライアントがページを自動取得することはありません。

{"operation":"city_search","arguments":{"query":"Viena","format":"list","match":"fuzzy","max_distance":1}}

単一の City には format=resource を、コレクションには format=list を選択してください。コレクションでは、国の包含／除外セット、タイムゾーンセット、両端を含む人口およびメートル単位の標高範囲、保存済み中心点の bbox、複数キーによる符号付きソートを利用できます。不明な数値情報は範囲フィルターに一致しません。

検索はデフォルトで前方一致です。完全一致とあいまい一致は明示的に指定します。あいまい一致では最大編集距離として 1 または 2 を指定でき、match の証拠情報（type、source、value、language、edit_distance）が返されます。あいまい一致の候補は、ID を保存する前に確認してください。

確認済みの子、祖先、兄弟姉妹は、部分的な関係情報の網羅範囲を持つ正規リストで返されます。データが空でも、地理的な親族が存在しないことの証明にはなりません。子と兄弟姉妹ではページ制御を使用できますが、祖先では使用できません。距離では、保存済みの中心点間の大圏距離をキロメートルとマイルで返します。ゼロは既知のゼロ、null は不明を表し、移動時間や包含関係を示すものではありません。

厳密な ambiguity=error では、最大2件の安全な候補 ID を含む HTTP 409 ambiguous_city が返されることがあります。既存のエラー生成処理と無関係なエラーメタデータは維持されます。候補が保持されるのはそのステータス／コードの場合のみで、Deep を含むことはありません。GeoJSON は HTTP 経由で利用できますが、これらの型付き City リストメソッドは GeoJSON を返しません。

国ごとの網羅範囲と利用可能なフィールドについては、https://parseapi.com/city#coverage を参照してください。

romanized=true を指定すると、確認済みの公式名称形式が name_romanized と romanization_language としてリクエストされます（Swift/Kotlin では camelCase）。現在、確認済みの形式では、ja-Latn の日本の市全体に対応するエイリアスを20件扱っています。形式が存在しない場合や競合する場合は null のままとなり、公式形式の代わりに ASCII の折りたたみが使われることはありません。

条件付きの If-None-Match 読み取りと GeoJSON は、現在 HTTP を直接使用します。一致する City ETag がある場合、本文なしで 304 が返されます。通常の課金とレート制限が適用されます。これらの JSON クライアントメソッドは、条件付きキャッシュ処理を提供しません。