ReplySparrow Docs

Directory

Search companies (free preview)

Search the company pool with filters. Companies are found through the people in the directory: people matching the company filters, grouped by their current company. 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, name, company_size, industry and headquarters are filled; website, domain, linkedin_url and description are empty strings. Use POST /api/v1/directory/companies/reveal with the returned ids to get the full company data (1 credit per company).

headquarters matches where the companies' people are located. is_hiring means headcount grew 20% or more in 6 months. total is an upper estimate until the last page has been read. is_b2b and technologies_used are not supported yet (400 filter_not_supported).

posthttps://app.replysparrow.com/api/v1/directory/companies/search

Authorizations

Authorizationstringheaderrequired

Your API key from Settings → API, sent as Bearer <token>.

Body

application/json
limitnumber

Results per page (1-100, default 10)

Default: 10

pagenumber

Page, starting at 1 (default 1)

Default: 1

namestring

Company name

industrystring[]

Industries, as in List suggested industries. A single string is accepted as a one-item list.

company_sizestring[]

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"]

headquartersstring[]

Locations, as in List suggested locations. A single string is accepted as a one-item list.

is_hiringboolean

Headcount grew 20%+ in 6 months

is_b2bboolean

Not supported yet

Not supported yet. A single string is accepted as a one-item list.

Response

application/json

A page of results

companiesobject[]required

Masked companies. Empty fields become available after revealing the company.

totalnumberrequired

Matching results, up to 10000

pagenumberrequired

Page returned

limitnumberrequired

Page size

has_morebooleanrequired

Whether a next page may have results

Search companies (free preview)
curl --request POST \  --url https://app.replysparrow.com/api/v1/directory/companies/search \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{  "industry": [    "Software Development"  ],  "company_size": [    "51-200",    "201-500"  ],  "headquarters": "United Kingdom",  "limit": 10}'
{  "companies": [    {      "id": "string",      "name": "string",      "industry": "string",      "company_size": "string",      "headquarters": "string",      "website": "string",      "domain": "string",      "linkedin_url": "string",      "description": "string"    }  ],  "total": 0,  "page": 0,  "limit": 0,  "has_more": true}