ArgorantDocs

検索、保存、エクスポート

すべての検索に共通するフィルター、保存済みのリスト、CSVエクスポート、電話番号、データ補完と、それぞれの料金を説明します。

フィルター

件数確認、検索、表示、リスト、エクスポート、キャンペーンは、すべて同じフィルターを使います。語句リスト(英語)では、業界、国、キーワード、テクノロジー、役職の正確な名称と、それぞれに該当する人数を確認できます。

フィルター例仕組み
qsoftware companies selling to restaurants名前、役職、企業、説明を対象にした普段の言葉での検索
titleCFO, Finance Directorカンマは「または」を意味します。略称にも対応します。exclude_titleで役職を除外します
seniorityC-Level,VPOwner、Founder、Partner、C-Level、VP、Director(Head ofにも一致)、Manager、Senior、Entry、Intern
departmentsFinance
industriesSoftware Development業界リストにある正確な名称。パイプは「または」を意味します
keywordslogistics, freight企業の事業内容を表す語句。企業名、タグ、業界、説明が対象です。ニッチな領域に最も幅広く使えるフィルターです。keyword_scope=peopleは代わりに人物自身のスキルを、keyword_scope=anyはその両方を対象にします
technologiesShopify企業が使っているもの
employee_range11-50,51-200企業規模
country, state, cityGermanyまたはDACH名称、またはEurope、DACH、Nordicsなどの地域
company_domain, company_namestripe.com1社
has_phone, has_linkedintrue電話番号またはプロフィールがある人物のみ
business_email_onlytrueメールアドレスが自社のドメインにある人物のみ。設定しない限りオフのため、個人のアドレスが除外されるのは指定した場合だけです
exclude_assistantsfalse既定でオンです。役職で検索すると、executive assistantやassistant toなどのアシスタント職を除外します。含めるにはfalseに設定します

件数確認、検索、リスト、エクスポートの応答には、指定したフィルター以外に何が適用されたかが示されます。applied_filtersには、オンにした場合にbusiness_email_onlyが示され、applied_defaultsには、アシスタント職が除外されたかどうかと、どの役職が除外されたかが示されます。保存済みのリストには、送ったとおりのリクエスト(filters.request)と並んで、その両方が保存されます。

地域は重なることがあります。エジプトはMiddle EastとAfricaの両方に、メキシコはNorth AmericaとLATAMの両方に含まれ、トルコはEuropeではなくMiddle Eastとして扱われます。指定した複数の地域にその人の国が含まれていても、1人は1回だけ数えられます。EMEAは、ヨーロッパ、中東、アフリカを合わせた地域です。

保存済みのリスト

リストには検索が保存されるため、あとでエクスポートしたり、キャンペーンに追加したりできます。

Shell
curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: uk-finance-list" -H "Content-Type: application/json" \
  -d '{"name":"UK finance leaders","filters":{"title":"CFO, Finance Director","country":"United Kingdom"}}'

検索の保存にはすぐに応答が返ります。件数の確認が時間内に終われば、snapshot_totalにその人数が入ります。終わらなかった場合はnullとなり、count_statusはpendingで、status_urlが返ります。GET /api/v1/lists/{id}/fillは、ステータス、件数、progress_percent、eta_secondsを示します。verbose=trueを付けると、保存された検索も確認できます。

filtersの代わりにrecord_idsを送ると、選んだ人物だけをそのまま保存できます。GET /api/v1/listsはすべてのリストを表示し、GET /api/v1/lists/{id}/peopleは1つのリスト内の人物をページ単位で表示し、POST /api/v1/lists/{id}/itemsは人物を追加し、PATCHは名前を変更し、DELETEはリストを削除します。list_idはそのままPOST /api/v1/campaigns/{id}/leadsに使えます。

エクスポート

エクスポートは、バックグラウンドでCSVを作成します。

Shell
curl -X POST "https://app.argorant.com/api/v1/exports" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: uk-finance-export" -H "Content-Type: application/json" \
  -d '{"filters":{"title":"CFO, Finance Director","country":"United Kingdom"},"limit":500}'

statusがdoneになるまでstatus_urlを確認し、その後download_urlからダウンロードします。ファイルの作成中にすべてのメールがチェックされ、料金はメールがチェックに通過した人1人につき1クレジットです。以前にエクスポートした人物は、"exclude_previously_exported": falseを設定しない限り除外されるため、同じ人物に二重に支払うことはありません。50,000行を超えると、エクスポートは複数のファイルのバッチになります。GET /api/v1/export-batches/{batch_id}で確認してください。POST /api/v1/lists/{id}/exportは、保存済みのリストを同じ方法でエクスポートします。

電話番号

エクスポートに"include_phones": trueを追加するか、POST /api/v1/people/phonesに最大100人分のrecord_idsを指定して電話番号を求めます。電話番号は、取得できた場合にのみ10クレジットかかり、すでに取得済みの番号は無料です。電話番号はProプランから利用できます。GET /api/v1/people/phones/pricingで、料金とプランに含まれているかどうかを確認できます。

1件のレコードを補完する

メールアドレス、または名前と企業ドメインがすでにわかっている場合は、POST /api/v1/enrichでその人物の情報を補完できます。メールがチェックに通過した一致には1クレジットかかり、見つからなかった場合は無料で、同じ人物の再取得も無料です。企業ドメインだけを指定すると、企業のプロフィールを無料で返します。

このページの内容