Two search modes, one API — how to pick the right one
Every search and enrich operation comes in two modes that share the same request and response shape — switch between them by swapping database ↔ realtime in the path:
POST /search/database/leads/ POST /search/realtime/leads/POST /enrich/database/company/ POST /enrich/realtime/company/
Decision matrix
Database
Real-time
Data source
Generect’s continuously growing database
Live LinkedIn lookup at request time
Response time
Under 1 second
5–60 seconds
Price
Lower
Higher
Lead freshness
Updated within the last 12 months
As of the moment of the request
Filters
Core set (see below)
Full set — keywords, past companies, schools, groups, live signals
Count endpoints
Free, instant
Billable, per request
Nothing found
0 results, $0 — no hidden live fallback
No Data — No Charge
Start with database mode: it answers instantly and costs less. Switch the same request to realtime when you need data fresh as of today or filters database mode doesn’t support.
When to use which
Use database when:
you process volume and care about cost and speed (list building, scoring, backfills)
last-year freshness is acceptable for your workflow
you want free counts to size an audience before paying for results
Use real-time when:
the record must be current right now (job changes, new role verification)
you need advanced targeting: keywords, past_company_names, schools, groups, functions
you need live signals (changed_jobs, posted_on_linkedin, mentioned_in_news) or search_emails
Filters supported in database mode
Leads:job_titles, seniorities, locations, exclude_locations, company_locations, exclude_company_locations, company_industries, exclude_company_industries, company_headcounts, exclude_company_headcounts, company_types, gender, seniority_levels and exact_locations (database mode only) — plus targeting a single company via company_id, company_link, or company_name.Companies:industries, exclude_industries, headcounts, locations, exclude_locations, company_types. The sub_industries toggle is also accepted here and behaves the same as in real-time mode (it modifies industries rather than counting as a filter on its own).Anything outside this set is rejected with 400 and a message pointing to the realtime endpoint, so an unsupported filter is never silently ignored. At least one search filter is always required.
A supported filter given an unknown value is a different matter, and the
behaviour is not uniform:
locations, exact_locations, company_headcounts, company_types, gender and
seniority_levels reject an unknown value with 400, naming the field (the
headcount, gender and seniority level errors also list the valid values).
company_industries / industries and seniorities do not validate.
An unrecognised value simply matches nothing, so the request succeeds, returns
0 results and charges \$0.
So company_industries: ["Fintech"] — not a LinkedIn industry — looks exactly
like a real empty audience. Industry and seniority values are matched
exactly: use the names from
ICP Search, and when a count comes back as zero, re-check
the spelling before concluding the audience does not exist.
Billing
Both modes charge per returned result at their own rate — real-time costs more than database. If nothing is found, nothing is charged. Database lead and company search can also return thin rows for free with "detail": "thin", up to a daily quota per account: see Search database leads. Exact prices for your account are in your billing settings.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Generect","colors":{"primary":"#2d59c8","light":"#5b85e6","dark":"#2d59c8"},"logo":{"light":"https://mintcdn.com/generect/X6p5e4jggJuPFyIO/logo/light.svg?fit=max\u0026auto=format\u0026n=X6p5e4jggJuPFyIO\u0026q=85\u0026s=749751167c04ffe76f0b07e4c1c00c09","dark":"https://mintcdn.com/generect/X6p5e4jggJuPFyIO/logo/dark.svg?fit=max\u0026auto=format\u0026n=X6p5e4jggJuPFyIO\u0026q=85\u0026s=5f67f8a3846d00903ec121cfedef7d2d"},"favicon":{"light":"https://mintcdn.com/generect/MwlP3J5sxV0qPVVI/favicon-black.svg?fit=max\u0026auto=format\u0026n=MwlP3J5sxV0qPVVI\u0026q=85\u0026s=0c5d1ab2f2f0105a0df758267cc5ccb4","dark":"https://mintcdn.com/generect/MwlP3J5sxV0qPVVI/favicon-white.svg?fit=max\u0026auto=format\u0026n=MwlP3J5sxV0qPVVI\u0026q=85\u0026s=34744abec4b538d5c0efada097a3dbfa"},"api":{},"background":{},"navbar":{"links":[{"href":"https://status.generect.com","label":"Status"},{"href":"mailto:support@generect.com","label":"Support"}],"primary":{"type":"button","label":"Website","href":"https://generect.com/"}},"footer":{"socials":{}},"integrations":{"posthog":{"apiKey":"phc_oZ9t9NRDaaMw82GikzAbFGwstRHRyY45U8g5T8sfi6rv","apiHost":"https://eu.i.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"generect","hasAudioNarration":false,"actualSubdomain":"generect","customDomains":["docs.generect.com"],"gitSource":{"type":"github","owner":"generect","repo":"generect-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afd7d5d37566762f1b92b23","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":58},{"language":"default","tag":"Introduction","count":16},{"language":"default","tag":"Use Cases \u0026 Best Practices","count":14},{"language":"default","tag":"Search","count":13},{"language":"default","tag":"Leads","count":11},{"language":"default","tag":"Getting Started","count":11},{"language":"default","tag":"Enrich","count":10},{"language":"default","tag":"Billing \u0026 Pricing","count":10},{"language":"default","tag":"Companies","count":9},{"language":"default","tag":"MCP","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/database-vs-realtime","slug":"/api-reference/database-vs-realtime","pageMetadata":{"title":"Database vs Real-time","icon":"scale-balanced","description":"Two search modes, one API — how to pick the right one","href":"/api-reference/database-vs-realtime"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Two search modes, one API — how to pick the right one\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every search and enrich operation comes in two modes that share the same request and response shape — switch between them by swapping `,_jsx(_components.code,{children:`database`}),` ↔ `,_jsx(_components.code,{children:`realtime`}),` in the path:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST /search/database/leads/ POST /search/realtime/leads/`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST /enrich/database/company/ POST /enrich/realtime/company/`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`decision-matrix`,children:`Decision matrix`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`Database`})}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`Real-time`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Data source`}),_jsx(_components.td,{children:`Generect’s continuously growing database`}),_jsx(_components.td,{children:`Live LinkedIn lookup at request time`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Response time`}),_jsx(_components.td,{children:`Under 1 second`}),_jsx(_components.td,{children:`5–60 seconds`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Price`}),_jsx(_components.td,{children:`Lower`}),_jsx(_components.td,{children:`Higher`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Lead freshness`}),_jsx(_components.td,{children:`Updated within the last 12 months`}),_jsx(_components.td,{children:`As of the moment of the request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Filters`}),_jsx(_components.td,{children:`Core set (see below)`}),_jsx(_components.td,{children:`Full set — keywords, past companies, schools, groups, live signals`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Count endpoints`}),_jsx(_components.td,{children:`Free, instant`}),_jsx(_components.td,{children:`Billable, per request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Nothing found`}),_jsxs(_components.td,{children:[`0 results, $0 — `,_jsx(_components.strong,{children:`no hidden live fallback`})]}),_jsx(_components.td,{children:`No Data — No Charge`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Start with database mode: it answers instantly and costs less. Switch the same request to realtime when you need data fresh as of today or filters database mode doesn’t support.`})}),`\n`,_jsx(Heading,{level:`2`,id:`when-to-use-which`,children:`When to use which`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use database when:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`you process volume and care about cost and speed (list building, scoring, backfills)`}),`\n`,_jsx(_components.li,{children:`last-year freshness is acceptable for your workflow`}),`\n`,_jsx(_components.li,{children:`you want free counts to size an audience before paying for results`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use real-time when:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`the record must be current right now (job changes, new role verification)`}),`\n`,_jsxs(_components.li,{children:[`you need advanced targeting: `,_jsx(_components.code,{children:`keywords`}),`, `,_jsx(_components.code,{children:`past_company_names`}),`, `,_jsx(_components.code,{children:`schools`}),`, `,_jsx(_components.code,{children:`groups`}),`, `,_jsx(_components.code,{children:`functions`})]}),`\n`,_jsxs(_components.li,{children:[`you need live signals (`,_jsx(_components.code,{children:`changed_jobs`}),`, `,_jsx(_components.code,{children:`posted_on_linkedin`}),`, `,_jsx(_components.code,{children:`mentioned_in_news`}),`) or `,_jsx(_components.code,{children:`search_emails`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`filters-supported-in-database-mode`,children:`Filters supported in database mode`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Leads:`}),` `,_jsx(_components.code,{children:`job_titles`}),`, `,_jsx(_components.code,{children:`seniorities`}),`, `,_jsx(_components.code,{children:`locations`}),`, `,_jsx(_components.code,{children:`exclude_locations`}),`, `,_jsx(_components.code,{children:`company_locations`}),`, `,_jsx(_components.code,{children:`exclude_company_locations`}),`, `,_jsx(_components.code,{children:`company_industries`}),`, `,_jsx(_components.code,{children:`exclude_company_industries`}),`, `,_jsx(_components.code,{children:`company_headcounts`}),`, `,_jsx(_components.code,{children:`exclude_company_headcounts`}),`, `,_jsx(_components.code,{children:`company_types`}),`, `,_jsx(_components.code,{children:`gender`}),`, `,_jsx(_components.code,{children:`seniority_levels`}),` and `,_jsx(_components.code,{children:`exact_locations`}),` (database mode only) — plus targeting a single company via `,_jsx(_components.code,{children:`company_id`}),`, `,_jsx(_components.code,{children:`company_link`}),`, or `,_jsx(_components.code,{children:`company_name`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Companies:`}),` `,_jsx(_components.code,{children:`industries`}),`, `,_jsx(_components.code,{children:`exclude_industries`}),`, `,_jsx(_components.code,{children:`headcounts`}),`, `,_jsx(_components.code,{children:`locations`}),`, `,_jsx(_components.code,{children:`exclude_locations`}),`, `,_jsx(_components.code,{children:`company_types`}),`. The `,_jsx(_components.code,{children:`sub_industries`}),` toggle is also accepted here and behaves the same as in real-time mode (it modifies `,_jsx(_components.code,{children:`industries`}),` rather than counting as a filter on its own).`]}),`\n`,_jsxs(_components.p,{children:[`Anything outside this set is rejected with `,_jsx(_components.code,{children:`400`}),` and a message pointing to the realtime endpoint, so an unsupported `,_jsx(_components.em,{children:`filter`}),` is never silently ignored. At least one search filter is always required.`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`A supported filter given an `,_jsx(_components.strong,{children:`unknown value`}),` is a different matter, and the\nbehaviour is not uniform:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`locations`}),`, `,_jsx(_components.code,{children:`exact_locations`}),`, `,_jsx(_components.code,{children:`company_headcounts`}),`, `,_jsx(_components.code,{children:`company_types`}),`, `,_jsx(_components.code,{children:`gender`}),` and\n`,_jsx(_components.code,{children:`seniority_levels`}),` reject an unknown value with `,_jsx(_components.code,{children:`400`}),`, naming the field (the\nheadcount, gender and seniority level errors also list the valid values).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`company_industries`}),` / `,_jsx(_components.code,{children:`industries`}),` and `,_jsx(_components.code,{children:`seniorities`}),` do `,_jsx(_components.strong,{children:`not`}),` validate.\nAn unrecognised value simply matches nothing, so the request succeeds, returns\n`,_jsx(_components.code,{children:`0`}),` results and charges `,_jsx(_components.code,{children:`\\\\$0`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`So `,_jsx(_components.code,{children:`company_industries: [\"Fintech\"]`}),` — not a LinkedIn industry — looks exactly\nlike a real empty audience. Industry and seniority values are matched\n`,_jsx(_components.strong,{children:`exactly`}),`: use the names from\n`,_jsx(_components.a,{href:`/docs/icp-search`,children:`ICP Search`}),`, and when a count comes back as zero, re-check\nthe spelling before concluding the audience does not exist.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`billing`,children:`Billing`}),`\n`,_jsxs(_components.p,{children:[`Both modes charge per returned result at their own rate — real-time costs more than database. If nothing is found, nothing is charged. Database lead and company search can also return thin rows for free with `,_jsx(_components.code,{children:`\"detail\": \"thin\"`}),`, up to a daily quota per account: see `,_jsx(_components.a,{href:`/api-reference/endpoint/search/database-leads#free-thin-rows`,children:`Search database leads`}),`. Exact prices for your account are in your `,_jsx(_components.a,{href:`https://app.generect.com/settings/billing`,children:`billing settings`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Database vs Real-time","icon":"scale-balanced","description":"Two search modes, one API — how to pick the right one","href":"/api-reference/database-vs-realtime"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Decision matrix","slug":"decision-matrix","depth":2,"children":[]},{"title":"When to use which","slug":"when-to-use-which","depth":2,"children":[]},{"title":"Filters supported in database mode","slug":"filters-supported-in-database-mode","depth":2,"children":[]},{"title":"Billing","slug":"billing","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/generect/aa350f9581328dbf/brand/logo-version.test.js"],"subdomain":"generect","siteName":"Generect","title":"Database vs Real-time - Generect","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T10:26:46.146Z","originalFileLocation":"api-reference/database-vs-realtime.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Two search modes, one API — how to pick the right one\">\u003cmeta data-mint-head name=\"application-name\" content=\"Generect\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Database vs Real-time - Generect\">\u003cmeta data-mint-head property=\"og:description\" content=\"Two search modes, one API — how to pick the right one\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Generect\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.generect.com/api-reference/database-vs-realtime\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://generect.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Database+vs+Real-time\u0026amp;description=Two+search+modes%2C+one+API+%E2%80%94+how+to+pick+the+right+one\u0026amp;theme=6ca42c67ba0b93527cc1a62e\u0026amp;signature=28eff6703fe2de81760fdf8a0617cbb50f717bfea63a815d9286fc31b84e2085\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Database vs Real-time - Generect\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Two search modes, one API — how to pick the right one\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://generect.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Database+vs+Real-time\u0026amp;description=Two+search+modes%2C+one+API+%E2%80%94+how+to+pick+the+right+one\u0026amp;theme=6ca42c67ba0b93527cc1a62e\u0026amp;signature=28eff6703fe2de81760fdf8a0617cbb50f717bfea63a815d9286fc31b84e2085\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/generect/a6AHBlxtST4jsqP0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Generect\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2d59c8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.generect.com/api-reference/database-vs-realtime\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/database-vs-realtime.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.generect.com/#organization\",\"name\":\"Generect\",\"url\":\"https://docs.generect.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/generect/X6p5e4jggJuPFyIO/logo/light.svg?fit=max\u0026auto=format\u0026n=X6p5e4jggJuPFyIO\u0026q=85\u0026s=749751167c04ffe76f0b07e4c1c00c09\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.generect.com#website\",\"name\":\"Generect\",\"url\":\"https://docs.generect.com\",\"publisher\":{\"@id\":\"https://docs.generect.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.generect.com/api-reference/database-vs-realtime#webpage\",\"url\":\"https://docs.generect.com/api-reference/database-vs-realtime\",\"name\":\"Database vs Real-time\",\"description\":\"Two search modes, one API — how to pick the right one\",\"dateModified\":\"2026-11-18T10:26:46.146Z\",\"isPartOf\":{\"@id\":\"https://docs.generect.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.generect.com/api-reference/database-vs-realtime#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.generect.com/api-reference/database-vs-realtime#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.generect.com/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Database vs Real-time\",\"item\":\"https://docs.generect.com/api-reference/database-vs-realtime\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.generect.com/api-reference/database-vs-realtime#article\",\"headline\":\"Database vs Real-time\",\"name\":\"Database vs Real-time\",\"description\":\"Two search modes, one API — how to pick the right one\",\"url\":\"https://docs.generect.com/api-reference/database-vs-realtime\",\"mainEntityOfPage\":{\"@id\":\"https://docs.generect.com/api-reference/database-vs-realtime#webpage\"},\"dateModified\":\"2026-11-18T10:26:46.146Z\",\"publisher\":{\"@id\":\"https://docs.generect.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.generect.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Generect\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Generect\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/database-vs-realtime.md","siteName":"Generect","nav":{"global":null,"tabs":[{"tab":"Introduction","pages":[{"title":"Introduction","href":"/docs/what-is-generect"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Introduction","icon":"book-open","href":"/api-reference/introduction"},{"title":"Quickstart","icon":"rocket","href":"/api-reference/quickstart"},{"title":"Test mode","icon":"flask","description":"Build and rehearse an integration without spending anything","href":"/api-reference/test-mode"},{"title":"Database vs Real-time","icon":"scale-balanced","href":"/api-reference/database-vs-realtime"},{"title":"Limits","icon":"gauge","description":"Rate limits, parallel requests and recommended timeouts","href":"/api-reference/limits"},{"title":"Reliability","icon":"heart-pulse","href":"/api-reference/reliability"},{"title":"Errors","icon":"triangle-exclamation","href":"/api-reference/errors"},{"title":"Migration Guide","icon":"right-left","href":"/api-reference/migration-guide"}]},{"group":"Auth","pages":[{"title":"Authentication","icon":"key","href":"/api-reference/authentication"}]},{"group":"Enrich","pages":[{"group":"Companies","icon":"building","pages":[{"sidebarTitle":"Real-time","openapi":"post /api/v1/enrich/realtime/company/","title":"Enrich company in realtime","href":"/api-reference/endpoint/enrich/enrich-realtime-company"},{"sidebarTitle":"Database","openapi":"post /api/v1/enrich/database/company/","title":"Enrich company from database","href":"/api-reference/endpoint/enrich/enrich-database-company"},{"sidebarTitle":"Bulk (realtime)","openapi":"post /api/v1/enrich/realtime/companies/bulk/","title":"Start bulk company enrich (realtime)","href":"/api-reference/endpoint/enrich/enrich-realtime-companies-bulk"},{"sidebarTitle":"Bulk (database)","openapi":"post /api/v1/enrich/database/companies/bulk/","title":"Start bulk company enrich (database)","href":"/api-reference/endpoint/enrich/enrich-database-companies-bulk"},{"sidebarTitle":"Get bulk job","openapi":"get /api/v1/enrich/companies/bulk/{job_id}/","title":"Get bulk company enrich job","href":"/api-reference/endpoint/enrich/get-companies-bulk"}]},{"group":"Leads","icon":"user","pages":[{"sidebarTitle":"Real-time","openapi":"post /api/v1/enrich/realtime/lead/","title":"Enrich lead in realtime","href":"/api-reference/endpoint/enrich/enrich-realtime-lead"},{"sidebarTitle":"Database","openapi":"post /api/v1/enrich/database/lead/","title":"Enrich lead from database","href":"/api-reference/endpoint/enrich/enrich-database-lead"},{"sidebarTitle":"Bulk (realtime)","openapi":"post /api/v1/enrich/realtime/leads/bulk/","title":"Start bulk lead enrich (realtime)","href":"/api-reference/endpoint/enrich/enrich-realtime-leads-bulk"},{"sidebarTitle":"Bulk (database)","openapi":"post /api/v1/enrich/database/leads/bulk/","title":"Start bulk lead enrich (database)","href":"/api-reference/endpoint/enrich/enrich-database-leads-bulk"},{"sidebarTitle":"Get bulk job","openapi":"get /api/v1/enrich/leads/bulk/{job_id}/","title":"Get bulk lead enrich job","href":"/api-reference/endpoint/enrich/get-leads-bulk"}]}]},{"group":"Search","pages":[{"group":"Companies","icon":"building","pages":[{"sidebarTitle":"Real-time","openapi":"post /api/v1/search/realtime/companies/","title":"Search realtime companies","href":"/api-reference/endpoint/search/realtime-companies"},{"sidebarTitle":"Database","openapi":"post /api/v1/search/database/companies/","title":"Search database companies","href":"/api-reference/endpoint/search/database-companies"},{"sidebarTitle":"Real-time count","openapi":"post /api/v1/search/realtime/companies/count/","title":"Count realtime companies","href":"/api-reference/endpoint/search/count-realtime-companies"},{"sidebarTitle":"Database count","openapi":"post /api/v1/search/database/companies/count/","title":"Count database companies","href":"/api-reference/endpoint/search/count-database-companies"}]},{"group":"Leads","icon":"user","pages":[{"sidebarTitle":"Real-time","openapi":"post /api/v1/search/realtime/leads/","title":"Search realtime leads","href":"/api-reference/endpoint/search/realtime-leads"},{"sidebarTitle":"Database","openapi":"post /api/v1/search/database/leads/","title":"Search database leads","href":"/api-reference/endpoint/search/database-leads"},{"sidebarTitle":"Real-time count","openapi":"post /api/v1/search/realtime/leads/count/","title":"Count realtime leads","href":"/api-reference/endpoint/search/count-realtime-leads"},{"sidebarTitle":"Database count","openapi":"post /api/v1/search/database/leads/count/","title":"Count database leads","href":"/api-reference/endpoint/search/count-database-leads"},{"group":"Preview","icon":"eye","pages":[{"sidebarTitle":"Leads","openapi":"post /api/v1/preview/leads/","title":"Preview leads","href":"/api-reference/endpoint/preview/preview-leads"},{"sidebarTitle":"Count Leads","openapi":"post /api/v1/preview/leads/count/","title":"Count preview leads","href":"/api-reference/endpoint/preview/count-preview-leads"}]}]},{"group":"Company-Leads","icon":"building-user","pages":[{"sidebarTitle":"Real-time","openapi":"post /api/v1/search/realtime/company-leads/","title":"Search realtime company leads","href":"/api-reference/endpoint/search/realtime-company-leads"},{"sidebarTitle":"Database","openapi":"post /api/v1/search/database/company-leads/","title":"Search database company leads","href":"/api-reference/endpoint/search/database-company-leads"},{"sidebarTitle":"Database count","openapi":"post /api/v1/search/database/company-leads/count/","title":"Count database company leads","href":"/api-reference/endpoint/search/count-database-company-leads"}]}]},{"group":"Contacts","pages":[{"group":"Email","icon":"envelope","pages":[{"sidebarTitle":"Single find","openapi":"post /api/v1/email/find/","title":"Find email","href":"/api-reference/endpoint/emails/email-finder"},{"sidebarTitle":"Start bulk job","openapi":"post /api/v1/email/find/bulk/","title":"Start bulk email find","href":"/api-reference/endpoint/emails/email-finder-bulk"},{"sidebarTitle":"Get bulk job","openapi":"get /api/v1/email/find/bulk/{job_id}/","title":"Get bulk email find job","href":"/api-reference/endpoint/emails/get-email-finder-bulk"},{"sidebarTitle":"Validate","openapi":"post /api/v1/email/validate/","title":"Validate emails","href":"/api-reference/endpoint/emails/email-validation"}]},{"group":"Phone","icon":"phone","pages":[{"sidebarTitle":"Find","openapi":"post /api/v1/phone/find/","title":"Find phone","href":"/api-reference/endpoint/phone/phone-finder"},{"sidebarTitle":"Start bulk job","openapi":"post /api/v1/phone/find/bulk/","title":"Start bulk phone find","href":"/api-reference/endpoint/phone/phone-finder-bulk"},{"sidebarTitle":"Get bulk job","openapi":"get /api/v1/phone/find/bulk/{job_id}/","title":"Get bulk phone find job","href":"/api-reference/endpoint/phone/get-phone-finder-bulk"}]}]},{"group":"Account","icon":"user-gear","pages":[{"openapi":"get /api/v1/accounts/me/","title":"Get account profile","href":"/api-reference/endpoint/accounts/get-account-me"},{"openapi":"get /api/v1/accounts/usage/","title":"Get account usage","href":"/api-reference/endpoint/accounts/get-account-usage"},{"openapi":"get /api/v1/accounts/transactions/","title":"Get account transactions","href":"/api-reference/endpoint/accounts/get-account-transactions"},{"openapi":"get /api/v1/accounts/tokens/analytics/","title":"Usage by token","href":"/api-reference/endpoint/accounts/get-account-token-analytics"}]},{"group":"Webhooks","icon":"bell","pages":[{"title":"Webhooks","sidebarTitle":"Overview","href":"/api-reference/endpoint/webhooks/overview"},{"openapi":"get /api/v1/webhooks/","title":"List webhooks","href":"/api-reference/endpoint/webhooks/list-webhooks"},{"openapi":"post /api/v1/webhooks/","title":"Register webhook","href":"/api-reference/endpoint/webhooks/create-webhook"},{"openapi":"get /api/v1/webhooks/{id}/","title":"Retrieve webhook","href":"/api-reference/endpoint/webhooks/get-webhook"},{"openapi":"put /api/v1/webhooks/{id}/","title":"Update webhook","href":"/api-reference/endpoint/webhooks/update-webhook"},{"openapi":"delete /api/v1/webhooks/{id}/","title":"Delete webhook","href":"/api-reference/endpoint/webhooks/delete-webhook"},{"openapi":"post /api/v1/webhooks/{id}/test/","title":"Test webhook","href":"/api-reference/endpoint/webhooks/test-webhook"}]}]},{"tab":"Billing \u0026 Pricing","pages":[{"title":"Billing \u0026 Pricing","href":"/billing/pay-as-you-go"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/hubspot/hubspot"}]},{"tab":"Use Cases \u0026 Best Practices","pages":[{"title":"Use Cases \u0026 Best Practices","href":"/use-cases/saas/introduction"}]}]},"basePath":"","title":"Database vs Real-time - Generect","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}