ReplySparrow Directory
Search leads (free preview)
Search the lead pool with filters. Needs the contacts:read scope. Free for you: it uses the platform's people database, not your credits. Results are cached for 7 days per filter set, so the same filters and page return the same results.
Results are masked: only id, first_name, job_title, location and industry are filled — all other fields are returned as empty strings. Use POST /api/v1/directory/leads/reveal with the returned ids to get the full lead data (1 credit per lead).
At least one filter is required. company_identifier takes website domains (acme.com) or exact company names. has_recently_changed_job means started at the current company in the last 3 months; is_company_hiring means the company's headcount grew 20% or more in 6 months. company_url, company_last_funding_round_since, has_recent_funding_round and has_recent_activity are accepted but not supported yet (400 filter_not_supported): the people database has no LinkedIn company page, funding or activity data.
Pages are read in order: ask for page N after the pages before it (or a 400 page_too_deep may come back for very deep pages).
https://app.replysparrow.com/api/v1/directory/leads/searchAuthorizations
Body
application/jsonCurrent job titles. A single string is accepted as a one-item list.
Example: ["Head of Sales"]
Where the people are, as in List suggested locations. A single string is accepted as a one-item list.
Industries of their companies, as in List suggested industries. A single string is accepted as a one-item list.
Company headcount brackets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. A single string is accepted as a one-item list.
Example: ["51-200"]
Person's name: first name, or first and last name
Current company name
Website domains or exact names of their current companies. A single string is accepted as a one-item list.
Started at their current company in the last 3 months
Their company's headcount grew 20%+ in 6 months
LinkedIn company URLs to restrict the search to. Not supported yet (400 filter_not_supported): use company_identifier. A single string is accepted as a one-item list.
Only companies with a funding round since this date (YYYY-MM-DD). Not supported yet (400 filter_not_supported)
Only companies with a funding round in the last 6 months. Not supported yet (400 filter_not_supported)
Only people active on LinkedIn in the last 90 days. Not supported yet (400 filter_not_supported)
Response
application/jsoncurl --request POST \ --url https://app.replysparrow.com/api/v1/directory/leads/search \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "job_title": [ "Head of Sales", "VP Sales" ], "location": "Germany", "company_size": [ "51-200" ], "limit": 10, "page": 1}'{ "leads": [ { "id": "string", "first_name": "string", "last_name": "string", "full_name": "string", "job_title": "string", "headline": "string", "location": "string", "industry": "string", "company": "string", "company_size": "string", "linkedin_url": "string" } ], "total": 0, "page": 0, "limit": 0, "has_more": true}