検索、保存、エクスポート
すべての検索に共通するフィルター、保存済みのリスト、CSVエクスポート、電話番号、データ補完と、それぞれの料金を説明します。
フィルター
件数確認、検索、表示、リスト、エクスポート、キャンペーンは、すべて同じフィルターを使います。語句リスト(英語)では、業界、国、キーワード、テクノロジー、役職の正確な名称と、それぞれに該当する人数を確認できます。
| フィルター | 例 | 仕組み |
|---|---|---|
q | software companies selling to restaurants | 名前、役職、企業、説明を対象にした普段の言葉での検索 |
title | CFO, Finance Director | カンマは「または」を意味します。略称にも対応します。exclude_titleで役職を除外します |
seniority | C-Level,VP | Owner、Founder、Partner、C-Level、VP、Director(Head ofにも一致)、Manager、Senior、Entry、Intern |
departments | Finance | |
industries | Software Development | 業界リストにある正確な名称。パイプは「または」を意味します |
keywords | logistics, freight | 企業の事業内容を表す語句。企業名、タグ、業界、説明が対象です。ニッチな領域に最も幅広く使えるフィルターです。keyword_scope=peopleは代わりに人物自身のスキルを、keyword_scope=anyはその両方を対象にします |
technologies | Shopify | 企業が使っているもの |
employee_range | 11-50,51-200 | 企業規模 |
country, state, city | GermanyまたはDACH | 名称、またはEurope、DACH、Nordicsなどの地域 |
company_domain, company_name | stripe.com | 1社 |
has_phone, has_linkedin | true | 電話番号またはプロフィールがある人物のみ |
business_email_only | true | メールアドレスが自社のドメインにある人物のみ。設定しない限りオフのため、個人のアドレスが除外されるのは指定した場合だけです |
exclude_assistants | false | 既定でオンです。役職で検索すると、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は、ヨーロッパ、中東、アフリカを合わせた地域です。
保存済みのリスト
リストには検索が保存されるため、あとでエクスポートしたり、キャンペーンに追加したりできます。
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を作成します。
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クレジットかかり、見つからなかった場合は無料で、同じ人物の再取得も無料です。企業ドメインだけを指定すると、企業のプロフィールを無料で返します。