JavaScript SDK: swarmhit.database.companies.enrich(params)
Full database record for one company (headcount and growth, funding, revenue estimate, the number of open job listings) from its website domain (preferred), LinkedIn URL or name; when several are sent, the first in that order is used. Consumes workspace AI credits on a match, at the Company enrichment price (Settings → Credits usage, for owners and admins); a 404 (no match) is not charged. Out of credits is a 400 with code: warning-no-credits.
Authorization
bearerAuth An API key created on the Access tokens page.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/database/companies/enrich" \ -H "Content-Type: application/json" \ -d '{ "domain": "stripe.com" }'{ "data": { "id": 0, "name": "string", "domain": "string", "website": "string", "linkedinUrl": "string", "description": "string", "companyType": "string", "yearFounded": 0, "industry": "string", "industries": [ "string" ], "headcount": 0, "headcountRange": "string", "headcountGrowth12m": 0, "country": "string", "headquarters": "string", "funding": { "totalUsd": 0, "lastRoundUsd": 0, "lastRoundType": "string", "lastRoundDate": "string", "investors": [ "string" ] }, "followers": 0, "openings": 0, "estimatedRevenue": { "minUsd": 0, "maxUsd": 0 } }}List valid filter values POST
**JavaScript SDK:** [`swarmhit.database.suggestions(params)`](/smart-api/sdk/methods#database) Suggest valid values for a search filter (free, no credits). People fields: `title`, `keyword`, `seniority`, `department`, `function`, `company`, `industry`, `companyType`, `hqCountry`, `country`, `city`, `state`, `continent`, `language`, `skill`, `school`, `degree`, `fieldOfStudy`, `headcountRange`. Company fields: `industry`, `country`, `headcountRange`, `lastRoundType`, `investor`, `technology`, `name`. `headcountRange` returns a closed eight-value set on both entities.
Enrich a person POST
**JavaScript SDK:** [`swarmhit.database.people.enrich(params)`](/smart-api/sdk/methods#database.people) Full database profile for one person, from their LinkedIn URL: experience, education, skills, follower counts, and with `includeEmail` their verified work email. Consumes workspace AI credits on a match, at the Person enrichment price, plus the Email finder price when `includeEmail` finds an email (Settings → Credits usage, for owners and admins); a 404 (no match) is not charged. When the person is already a workspace lead with an email, `includeEmail` returns that email without a new lookup, and a newly found email is stored on the lead. Without `includeEmail` the response omits the `contact` availability flags. For the email alone, `POST /database/people/find-email` is cheaper. Out of credits is a 400 with `code: warning-no-credits`.