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.com기업 하나
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로 집계됩니다. 지정한 여러 지역에 한 사람의 국가가 함께 포함되더라도 그 사람은 한 번만 집계됩니다. 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은 한 리스트의 인물을 페이지 단위로 보여 줍니다. 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와 record_ids로 최대 100명의 번호를 요청하세요. 전화번호는 번호가 나올 때만 10크레딧이 들고, 이미 가진 번호는 무료입니다. 전화번호는 Pro 플랜부터 제공됩니다. GET /api/v1/people/phones/pricing은 가격과 내 플랜에 포함되는지를 보여 줍니다.

레코드 하나 보강하기

이미 이메일이나 이름과 회사 도메인을 가지고 있다면 POST /api/v1/enrich가 그 인물의 정보를 채웁니다. 이메일이 검증을 통과한 일치 결과는 1크레딧, 찾지 못하면 무료이고, 같은 인물을 다시 보강하는 것도 무료입니다. 회사 도메인만 보내면 기업 프로필을 무료로 돌려줍니다.

이 페이지의 내용