Whitepages 住所スクレイパー

住所を入れると、
記録が出てくる。

米国の住所を送信すると、正規化された住所と座標に解決された1行として返り、Whitepages の居住者カラムと物件カラムが並びます。これは人物検索の情報源であるため、適用される規則はポリシーの奥に埋めずこのページに置いています。当社自身のテスト実行が実際に何を返したかも同様です。

初回限定500行無料以降は1行 $0.0021リクエストにつき最大1,000住所カバー範囲は米国中心
許可された用途

これを使ってはならない
用途。

この節を最初に置いているのは意図的です。ある住所に誰が住んでいるかを解決するサービスには、他のスクレイピングにはない義務が伴います。ここに挙げる制限は当社が考えた社内規則ではなく、当社の顧客の多くが事業を行う地域における法律です。

適格性の判断には使えません

雇用、与信、保険、住宅、入居審査の判断に使わないでください。米国ではこれらは FCRA の下で消費者信用情報機関であることを要する規制対象の目的であり、本サービスはそれに該当しません。どのような設定を行ってもそうはなりません。

個人の所在特定や接触には使えません

連絡を望んでいない人物を追跡・訪問・監視・接触する目的で使わないでください。住所を氏名に変えることこそがこの領域を機微にする一歩であり、それを行うアカウントは閉鎖されます。

妥当な用途:すでに保有する住所の整備

乱れた住所カラムを、正規化された住所と座標に解決することは、ごく普通のデータ品質作業です。当社自身の実行でも、動いたのはこの部分でした。必要がそれだけなら、本サービスは1リクエストあたり1,000住所でそれを行います。

妥当な用途:自社の記録と住所を照合する

すでに管理しているアカウントの住所が公開情報と食い違って見えるとき、それを確認するのは調査ではなく防御的な用途です。世帯名簿を作ることとは別物であり、範囲内なのは前者だけです。

次にお読みください

居住者カラムは
で返ってきました。

これがこのページで最も重要な事実であり、機能一覧の下に埋めるのは不誠実です。当社自身の実行が返したものを、そのまま記します。

当社はこのサービスの実エクスポートを4件保有しています。いずれも1住所に対する1行で、対象は公開リファレンスが自らの例として用いている住所 321 California Ave, Palo Alto, CA 94306 です。4件すべてで値が入っていたのは住所解決系のカラム、すなわち addresslatlonmatched_address、そして広い形式では queryfull_address でした。residentsresidents_countbuilding_type、および23個の property_* カラムはすべての実行で空でした。

その理由はエクスポート自身の status カラムに書かれていました。3件は 「residents unavailable on free pool - needs residential proxy」、4件目は 「no public residents」 を返しました。これは別々の結果です。一方はリクエストの経路に関するもの、もう一方は住所そのものに関するものであり、どちらも入力の誤りではありません。各行ではまず status を読んでください。

そのため下のデータ辞書は、エクスポートのヘッダーから一字一句そのまま取った33のカラム名を挙げ、実際に値が入るのを確認できた6つを明示しています。残る27は宣言されているだけで、確認されていません。それらについて的中率を示すことはしません。1住所は標本ではないからです。まず無料枠でご自身のバッチを実行し、ファイルを見てからそれらのカラムを前提に設計してください。

livescraper.app · 確認済みの事項
入力は住所 - ドキュメント記載
1リクエストにつき最大1,000住所 - ドキュメント記載
33のカラム名 - エクスポートのヘッダーより
値が入ったことがあるのは6カラムのみ!
residents は4回中4回とも空!
作り込む前に無料枠で確認してください。
使い方

住所を入れて、
行を得る

入力は住所だけです。設定するフィルターはありません。

  1. ステップ 1プラットフォームにサインインします。
  2. ステップ 2Whitepages Addresses Scraper を開きます。
  3. ステップ 3住所を1行に1件ずつ貼り付けます。
  4. ステップ 4出力形式を選びます。
  5. ステップ 5Get Data をクリックし、まず status カラムを読みます。

検索ボックスに入力するのと同じ書き方で構いません - 321 California Ave, Palo Alto, CA 94306。リファレンスは1リクエストにつき最大1,000件の配列を受け付けます。

データ辞書

33カラムが宣言され、
6カラムが確認済み。

以下の名称はすべて、当社エクスポートのヘッダー行から一字一句そのまま、表計算が出力する順序で写したものです。各項目の注記は、値が入るのを確認できたかどうかを示します。

address
送信したとおりの住所。確認済み - 4回すべてで値あり。
lat
解決された住所の緯度。文字列。確認済み - 4回すべてで値あり。
lon
解決された住所の経度。文字列。確認済み - 4回すべてで値あり。
matched_address
完全な郵便形式に正規化された住所 - 街路、地区、市、郡、州、郵便番号、国。確認済み - 4回すべてで値あり。
residents
その住所に記載されている人物。宣言のみ - 4回すべてで空。理由は status カラムを参照。
status
この照会の結果。確認済み - 4回すべてで値あり。観測された値: no public residentsresidents unavailable on free pool - needs residential proxy
query
送信した住所のそのままの返し。広い形式では確認済み。狭い形式には存在しません。
building_type
その住所にある建物の種別。宣言のみ - 保有するすべての実行で空。
full_address
matched_address と同じ正規化済み住所。広い形式では確認済み - 広い形式のどの実行でも両者は同一の値でした。
residents_count
記載されている人数。宣言のみ - 保有するすべての実行で空。
property_context
物件レコードの @contextproperty_* カラムが表現される語彙。宣言のみ。
property_type
物件レコードの @type。宣言のみ。
property_address_type
物件の住所オブジェクトの型。宣言のみ。
property_address_street_address
物件住所の街路行。宣言のみ。
property_address_postal_code
物件住所の郵便番号。宣言のみ。
property_address_address_locality
物件住所の市区町村。宣言のみ。
property_address_address_country
物件住所の国。宣言のみ。
property_contained_in_place_type
物件が属するより大きな場所の型 - 包含する地区または自治体。宣言のみ。
property_contained_in_place_name
その包含する場所の名称。宣言のみ。
property_contained_in_place_address_type
包含する場所の住所オブジェクトの型。宣言のみ。
property_contained_in_place_address_address_region
包含する場所の地域または州。宣言のみ。
property_contained_in_place_address_postal_code
包含する場所の郵便番号。宣言のみ。
property_contained_in_place_address_address_country
包含する場所の国。宣言のみ。
property_name
物件レコードの名称。宣言のみ。
property_geo_type
物件の geo オブジェクトの型。宣言のみ。
property_geo_latitude
物件レコード側の緯度。最上位の lat とは別物です。宣言のみ。
property_geo_longitude
物件レコード側の経度。最上位の lon とは別物です。宣言のみ。
property_floor_size_type
床面積の計測値の型。宣言のみ。
property_floor_size_value
床面積の数値。宣言のみ。
property_floor_size_unit_code
その数値の単位 - 平方フィートなら FTK、平方メートルなら MTK といった UN/CEFACT コード。2行を比較する前に必ず読んでください。宣言のみ。
property_year_built
建築年。宣言のみ。
property_identifier
物件レコード自身の識別子。宣言のみ。
property_description
物件の自由記述。宣言のみ。

「宣言」とは、エクスポートのヘッダーがそのカラムを名指ししているという意味であり、そのカラムに値が入るという意味ではありません。この33のうち、当社の実行で値が入ったのは6つ - addresslatlonmatched_addressstatus、そして広い形式での queryfull_address です。残りは1住所・4実行を通じて毎回空でした。これは充足率として表現するにはあまりに少ないため、この表ではそうしていません。測定した内容を報告し、そこで止めています。宣言のみと記されたカラムを前提に構築する前に、答えをすでに知っている住所に無料枠の行をいくつか使ってください。

組み込む前に

インポーターを書く方への
4つの注意。

いずれもリファレンスではなくエクスポートを読んで得られたものです。だからこそ紙幅を割く価値があります。

エクスポート形式は1つではなく2つ

4件の実行のうち3件は33カラムを返しました。4件目、つまり最も古いものは6カラムでした - addresslatlonmatched_addressresidentsstatus。インポーターはこの6つを前提に書き、残る27は「あれば使う」として扱ってください。固定ヘッダーを前提とする読み取り側は、狭い形式に出会った時点で壊れます。

JSON と表計算ではカラムの順序が異なる

同じ33フィールドで、順序が2通りあります。表計算は addresslatlonmatched_addressresidentsstatus で始まり query を7番目に置きますが、JSON はその同じ6つを最後、すべての property_* フィールドの後に置きます。カラムは名前で読んでください。位置で参照する処理は、黙って誤ったフィールドを読みます。

空の行はエラーではない - status を読む

居住者が見つからない照会でも行は返り、住所は解決され、人物カラムは空になります。理由は status にあり、観測された2つの値は意味が異なります。no public residents は住所についての結果、residents unavailable on free pool - needs residential proxy はリクエストの経路についての結果です。residents が空かどうかではなく、このカラムで分岐してください。

property_* カラムは公開語彙に従う

その名称は Schema.org の AccommodationPlace のプロパティをアンダースコアで平坦化したものです - containedInPlacevalueunitCode を持つ floorSizeyearBuiltlatitudelongitude を持つ geo。マッピング時に有用です: property_floor_size_unit_code は UN/CEFACT の単位コードを保持するため、床面積は行ごとに同じ単位とは限りません。

よくある使い方

住所カラムが
弱点になる場面。

以下は本サービスが想定する用途です。想定しない用途はページ冒頭にあり、そちらは交渉の余地がありません。

住所の整備

乱れた住所カラムを正規化する

人が入力した住所は、省略され、綴りが誤り、順序も不揃いのまま届きます。ここに送ると matched_address が返り、街路・地区・市・郡・州・郵便番号・国からなる完全な郵便形式が1つ得られます。さらに latlon も付きます。当社自身の実行では、全行で動いたのがこの部分でした。

データエンジニアリング · Ops
大量ジオコーディング

住所リストを座標に変える

解決された各行は緯度と経度を文字列で保持しており、顧客リストの地図化、サービス提供地域のクラスタリング、レコードと担当区域の結合には十分です。1リクエストで最大1,000住所を扱えるため、大きなファイルもレート制限の問題ではなく数回の呼び出しで済みます。

アナリティクス · フィールド業務
レコードの検証

すでに保有する住所を確認する

既存アカウントの住所が公開情報と食い違って見えるとき、解決してみればその差が誤記なのか別の何かなのかが分かります。これは自社データに対する防御的な確認であり、誰かがどこに住んでいるかを突き止める手段ではありません。それは上の許可された用途が扱っています。

リスク · サポート
料金

実際に取得した行の分
だけをお支払い。

サブスクリプションなし、最低利用額なし、席数ライセンスなし。最初の500行は当社負担、以降は従量課金です。

無料枠

500行無料 - $0

新規アカウントごとに初回限定。クレジットカード不要。当社の実行で居住者カラムがどうだったかを踏まえると、答えをすでに知っている住所にいくらか使うのが、最初にすべき最も有益なことです。

永年 $0
従量課金

無料枠のあとは1行 $0.002

1,000住所あたり約 $2、1住所につき1行 - 何も解決しない住所でもきっかり1行返るため、予算は正確に見積もれます。

最も人気
エンタープライズ

個別対応 · 定期チェック

大量の住所ファイルを定期的に再照会するチーム向けに、ボリューム価格、SLA、専用ワーカー、個別オンボーディングをご用意します。数量をお知らせいただければお見積りします。

ご相談ください
初回有料実行が10%オフ。チェックアウト時にコード LIVESCRAPER10 をご利用ください。
登録する
相性のよいサービス

同じレコードを、
別の角度から。

どちらもこのページと同じ制限区分に属し、同じ許可された用途が適用されます。

法的な話

公開記録、
その対象は

このカタログのほとんどのページは企業やソフトウェアに関する事実を扱います。このページは違います。その違いは、ぼかさずはっきり述べる価値があります。

Whitepages は、公開記録から集めた連絡先情報と物件情報を公開している米国のディレクトリです。本サービスが読むのは同サイトが公に表示している掲載内容ですが、その掲載の対象は人であり、それによって変わるのは当社ではなく利用者側の義務です。GDPR のもとでは世帯の氏名と住所は、どれほど容易に見つかるものであっても個人データです。また米国では、それを雇用・与信・保険・住宅の判断に用いることは規制対象の目的であり、本サービスはその許諾を持ちません。

このページ冒頭の許可された用途は要約版です。詳しく言えば、これらの行を保持するための法的根拠、説明できる保存期間、そして本人から「何を保有しているのか」と尋ねられたときの回答が必要です。いずれかが欠けているなら、正しい判断はその処理を実行しないことです。

当社側について: 公開されている情報源のみを利用し、データ層にサードパーティのトラッカーは置かず、エクスポートは30日で自動削除されます。結果の控えを保持することも、それをもとにデータベースを構築することもありません。

livescraper.app · 方針
公開されている情報源のみ
エクスポートは自動削除(30日)
データ層にサードパーティのトラッカーなし
これは個人データです - 法的根拠が必要です!
消費者信用情報機関ではありません - 適格性の判断には使えません!
許可された用途は、登録後ではなく登録前にお読みください。
よくある質問

登録前によく
聞かれること。

最も多く寄せられる質問です。ほかにご不明な点があればご連絡ください - 回答を書くのはボットではなく人間です。

ある住所に誰が住んでいるか分かりますか。+
当社が保有するどの実行でも分かりませんでした。それこそが本サービスの目的でありリファレンスの記載でもありますが、4件の実エクスポートを通じて residentsresidents_count は毎回空で返りました。status は1件が no public residents、残る3件が residents unavailable on free pool - needs residential proxy でした。カラム名を公開しているのはエクスポートのヘッダーがそれを宣言しているからであり、確認していない結果を主張するつもりはありません。これらのカラムを前提に計画を立てる前に、すでに答えを知っている住所に無料枠の行をいくつか使ってください。
では実際には何が返りますか。+
現行の形式では33カラムで、そのうち当社の実行で値が入ったのは6つです。送信したとおりの addresslatlon、完全な郵便形式に正規化された matched_addressstatus、そして広い形式での queryfull_address です。住所解決は全行で機能しました。居住者カラムと物件カラムには値が入りませんでした。
なぜエクスポートが33ではなく6カラムなのですか。+
形式が2つあるためです。古い方は addresslatlonmatched_addressresidentsstatus を返し、現行の方はそれに27を加えて返します。固定ヘッダーを前提とせず、インポーターはこの6つを対象に書き、残りは「あれば使う」として扱ってください。
カラムを位置で読んでもよいですか。+
いいえ、名前で読んでください。JSON と表計算は同じ33フィールドを異なる順序で並べます。表計算は主要6カラムで始まり query を7番目に置きますが、JSON はその同じ6つを最後、すべての property_* フィールドの後に置きます。位置で参照する処理は、2つの形式のいずれかで誤ったフィールドを読みます。
一度に何件の住所を送れますか。+
リファレンスは1リクエストにつき最大1,000住所を配列で送るバッチ処理を記載しています。これはドキュメントに記載された上限であり、そのように引用しています。当社自身の実行は1住所ずつのテストであったため、その規模で実際に試したわけではありません。
入居者や応募者の審査に使えますか。+
使えません。雇用、与信、保険、住宅、入居審査は米国では規制対象の目的であり、FCRA の下で消費者信用情報機関であることを要しますが、本サービスはそれに該当しません。この制限は変更できる設定ではなく、このページ冒頭の許可された用途の第1項目です。
料金はいくらですか。+
新規アカウントの最初の500行は初回限定で無料、以降は1行 $0.002 - 1,000住所あたり約 $2 - の従量課金で、サブスクリプションはありません。1住所につき1行なので、何も解決しない住所も含めて予算を正確に見積もれます。クレジットに有効期限はなく、月次のリセットもありません。

住所ファイル
解決しましょう。

住所を貼り付ければ、正規化・ジオコーディングされ、それぞれのステータスを伴った状態で返ります。最初の500行は無料です - 関心のある住所についてどのカラムが埋まるかを、ご自身で確かめるには十分です。

即時有効 · カード不要

Whitepages Addresses Scraper - 住所照会と居住者インサイトを大規模に

Whitepages は、公開記録から集約した連絡先情報と物件情報を公開する、長い歴史を持つ米国のディレクトリであり、本サービスが読むのはその住所ページです。公開リファレンスはこのエンドポイントを、住所とその居住者に関するインサイトを返すものと説明しており、入力として住所を受け取り - 自らの例は 321 California Ave, Palo Alto, CA 94306 です - 1リクエストにつき最大1,000住所の配列を受け付けます。各住所は1行として返るため、入力ファイルと出力ファイルは、何も解決しない住所も含めて正確に対応します。

その行に何が入っているかという点で、このページは大半の製品ページと異なります。意図ではなく測定結果を報告しているからです。4件の実エクスポートを通じて、ヘッダーは33カラムを宣言し、そのうち6つに値が入りました。送信したとおりの住所、緯度と経度、街路から地区・市・郡・州を経て郵便番号と国に至る正規化済み住所、ステータスのカラム、そして広い形式では返された送信内容と重複した完全住所です。人と物件を記述するカラム - residents、residents_count、building_type、および住所・包含する場所・座標・床面積・建築年・識別子・記述を扱う23の property フィールド - は、すべての実行で空でした。理由はステータス列に記されていました。3件は居住者情報が無料プールでは利用できず residential proxy を要すると報告し、1件はその住所に公開されている居住者がいないと報告しました。当社がカラム名を公開するのはヘッダーがそれを宣言しているからであり、残りを確認済みではなく宣言済みと記すのは、ヘッダーはエクスポートが何を含もうとしているかを示すものであって、そのカラムに実際に値が入る証拠ではないからです。

インポーターを書く方には3点が重要です。エクスポート形式は2つあり、6カラムの古い形式と33カラムの現行形式があります。したがって6つを前提に実装し、残りは任意として扱ってください。JSON と表計算は同じフィールドを異なる順序で並べます。表計算は主要6カラムを先頭に置き、JSON は property フィールドの後、末尾に置きます。そのためカラムは名前で読み、決して位置で読んではなりません。そして property カラムは独自の命名ではなく公開語彙に従います。その名称は Schema.org の Accommodation と Place のプロパティをアンダースコアで平坦化したものであり、床面積が値と UN/CEFACT 単位コードの組で届くのもそのためです。2行を比較する前にその単位コードを読む必要があります。

これは人物検索の情報源であり、それに伴う義務はポリシーの奥ではなくページ冒頭に置いています。雇用・与信・保険・住宅・賃貸の判断に用いてはなりません。米国ではこれらは消費者信用情報機関を要する規制対象の目的です。また、私人の所在を突き止めたり、接触したり、監視したりする目的にも用いてはなりません。すでに保有する住所カラムの整備、顧客リストのジオコーディング、自社記録に対する住所の検証が本サービスの想定用途であり、住所解決は当社が実行したすべての行で機能した部分です。公開されている情報源のみを利用し、データ層にサードパーティのトラッカーはなく、エクスポートは30日で自動削除されます。最初の500行は無料でクレジットカードも不要です - そのいくつかは、答えをすでに知っている住所にお使いください。