Endpoints
Every Cognism API operation, what it returns, and what it costs in rate-limit, search-token and credit terms.
All endpoints are relative to https://api.cognism.com and require a bearer token (see Authentication). The tables below list every operation, link to its reference page, and show which quota each one draws on — see Rate limits and Credits and search tokens for how those quotas work.
Search and count
| Method | Endpoint | Purpose | Rate-limit operation | Search tokens | Credits |
|---|---|---|---|---|---|
POST | /persons/filter | Search people. Returns one page of person records. | search | 1 per record returned | 1 per record when view includes contacts |
POST | /persons/filter/count | Count people matching a filter. Returns { "total": n } only. | count | — | — |
POST | /companies/filter | Search companies. Returns one page of company records. | search | 1 per record returned | — |
POST | /companies/filter/count | Count companies matching a filter. Returns { "total": n } only. | count | — | — |
Search and count endpoints accept the same filter body, so you can count first and search only when the result set is the size you expect.
Dictionaries
Dictionaries return the exact values that filters accept. Resolve free-text input (an industry name, a country, a seniority) against a dictionary before you put it in a filter.
| Method | Endpoint | Returns | Query parameters |
|---|---|---|---|
GET | /dictionaries/industries | Industry taxonomy (three levels, parentId links a child to its parent). | id, name, level, parentId |
GET | /dictionaries/industry_codes | SIC, NAICS and ISIC codes mapped to industries. Paginated. | classification (sic | naics | isic), code, industryId, limit, cursor, offset |
GET | /dictionaries/regions | Geographic regions (Africa, Americas, Asia, Europe, Oceania). | — |
GET | /dictionaries/countries | Countries with their region. | name, regionId |
GET | /dictionaries/departments | Departments used in person and hiring-event filters. | — |
GET | /dictionaries/seniorities | Seniority levels: C-Suite, Vice President, Director, Manager, Individual Contributor. | — |
GET | /dictionaries/technologies | Technologies detected on company records. Paginated. | name, limit, cursor, offset |
GET | /dictionaries/intent-topics | Intent topic catalogue. Returns an empty list in v1; parameters are accepted for forward compatibility. | name, limit, cursor, offset |
Dictionary requests count against the dictionary rate-limit operation and cost no search tokens or credits.
Account settings
| Method | Endpoint | Returns |
|---|---|---|
GET | /intent/topics | The intent topic IDs selected for your account and the maximum number of topics the account may configure. |
GET | /settings/compliance | Countries where phone numbers are masked (do-not-call) and geo-restrictions excluded from your search results. |
GET | /settings/personalization | Your account's selected intent topics and watched technologies. |
GET | /settings/billing | Search tokens remaining, allotment and reset time; credit allotment and reset time. |
Settings requests cost no search tokens or credits.
Health
| Method | Endpoint | Returns |
|---|---|---|
GET | /health | Service health probe. Never rate limited. |
Updated 2 days ago