[{"data":1,"prerenderedAt":437},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fguides\u002Fdata-freshness":186},[4,10,15,23,28,35,41,47,52,57,62,66,70,77,83,90,95,100,105,110,115,119,124,128,132,136,141,144,147,151,155,159,163,167,170,174,178,182],{"path":5,"title":6,"category":7,"order":8,"family":9,"subfamily":9,"status":9,"endpointId":9},"\u002Fapi-reference","API reference","introduction",30,null,{"path":11,"title":12,"category":7,"order":13,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fauthentication","Authentication",20,"updated",{"path":16,"title":17,"category":18,"order":19,"family":20,"subfamily":21,"status":14,"endpointId":22},"\u002Fendpoints\u002Fcheck-company","Profile status","endpoints",220,"Fetch","Company","check-company",{"path":24,"title":17,"category":18,"order":25,"family":20,"subfamily":26,"status":14,"endpointId":27},"\u002Fendpoints\u002Fcheck-person",120,"Person","check-person",{"path":29,"title":30,"category":18,"order":31,"family":32,"subfamily":33,"status":9,"endpointId":34},"\u002Fendpoints\u002Fcontact-email","Find Email",600,"Contact","Email","contact-email",{"path":36,"title":37,"category":18,"order":38,"family":32,"subfamily":39,"status":9,"endpointId":40},"\u002Fendpoints\u002Fcontact-phone","Find Phone",610,"Phone","contact-phone",{"path":42,"title":43,"category":18,"order":44,"family":45,"subfamily":21,"status":14,"endpointId":46},"\u002Fendpoints\u002Fenrich-company","Enrich company",90,"Enrichment","enrich-company",{"path":48,"title":49,"category":18,"order":50,"family":45,"subfamily":26,"status":14,"endpointId":51},"\u002Fendpoints\u002Fenrich-person","Enrich profile",80,"enrich-person",{"path":53,"title":54,"category":18,"order":55,"family":20,"subfamily":21,"status":14,"endpointId":56},"\u002Fendpoints\u002Ffetch-company","Profile",200,"fetch-company",{"path":58,"title":59,"category":18,"order":60,"family":20,"subfamily":21,"status":14,"endpointId":61},"\u002Fendpoints\u002Ffetch-company-live","Profile live",210,"fetch-company-live",{"path":63,"title":54,"category":18,"order":64,"family":20,"subfamily":26,"status":14,"endpointId":65},"\u002Fendpoints\u002Ffetch-profile",100,"fetch-profile",{"path":67,"title":59,"category":18,"order":68,"family":20,"subfamily":26,"status":14,"endpointId":69},"\u002Fendpoints\u002Ffetch-profile-live",110,"fetch-profile-live",{"path":71,"title":72,"category":18,"order":73,"family":74,"subfamily":75,"status":14,"endpointId":76},"\u002Fendpoints\u002Fsearch-companies","Company search",94,"Search","Companies","search-companies",{"path":78,"title":79,"category":18,"order":80,"family":81,"subfamily":9,"status":14,"endpointId":82},"\u002Fendpoints\u002Fsearch-companies-available-fields","Company search available fields",720,"Utility","search-companies-available-fields",{"path":84,"title":85,"category":18,"order":86,"family":74,"subfamily":87,"status":88,"endpointId":89},"\u002Fendpoints\u002Fsearch-people","People search",92,"People","new","search-people",{"path":91,"title":92,"category":18,"order":93,"family":81,"subfamily":9,"status":88,"endpointId":94},"\u002Fendpoints\u002Fsearch-people-available-fields","People search available fields",710,"search-people-available-fields",{"path":96,"title":97,"category":18,"order":98,"family":74,"subfamily":87,"status":88,"endpointId":99},"\u002Fendpoints\u002Fsearch-people-count","People search count",93,"search-people-count",{"path":101,"title":102,"category":18,"order":103,"family":74,"subfamily":87,"status":88,"endpointId":104},"\u002Fendpoints\u002Fsearch-people-lookalike","People lookalike",95,"search-people-lookalike",{"path":106,"title":107,"category":18,"order":108,"family":74,"subfamily":87,"status":88,"endpointId":109},"\u002Fendpoints\u002Fsearch-people-prompt","Agentic Search",96,"search-people-prompt",{"path":111,"title":112,"category":18,"order":113,"family":81,"subfamily":9,"status":14,"endpointId":114},"\u002Fendpoints\u002Fusage","Usage",700,"usage",{"path":116,"title":117,"category":7,"order":118,"family":9,"subfamily":9,"status":9,"endpointId":9},"\u002Fgetting-started","Getting started",10,{"path":120,"title":121,"category":122,"order":123,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Fapi-key-management","API key management","guides",12,{"path":125,"title":126,"category":122,"order":127,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Fcurrent-position-resolution","Current position and work history ordering",35,{"path":129,"title":130,"category":122,"order":131,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Fdata-freshness","Data freshness",40,{"path":133,"title":134,"category":122,"order":135,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Fdata-quality","Data quality",18,{"path":137,"title":138,"category":139,"order":140,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Fendpoint-transition-october-2026","Endpoint transition on October 13, 2026","migrations",1,{"path":142,"title":143,"category":122,"order":13,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Ferrors-retries","Error handling & retries",{"path":145,"title":146,"category":122,"order":118,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Ffirst-api-call","Your first API call",{"path":148,"title":149,"category":122,"order":150,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Findustries","Industry values",50,{"path":152,"title":153,"category":154,"order":150,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Fmcp","Connect AI agents (MCP)","mcp",{"path":156,"title":157,"category":139,"order":158,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Fmigrating-resolve-to-enrich","Migrating from Resolve to Enrich",52,{"path":160,"title":161,"category":139,"order":162,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Fmigrating-search-persons-to-people","Migrating people search from persons to people",51,{"path":164,"title":165,"category":122,"order":166,"family":9,"subfamily":9,"status":88,"endpointId":9},"\u002Fguides\u002Fmissing-and-empty-fields","Missing and empty profile fields",42,{"path":168,"title":169,"category":122,"order":8,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Fpolling","Polling, zero setup",{"path":171,"title":172,"category":122,"order":173,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Fproduction-checklist","Production checklist",45,{"path":175,"title":176,"category":122,"order":177,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Frate-limits-credits","Rate limits & credits",25,{"path":179,"title":180,"category":122,"order":181,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Fwebhooks","Webhooks",31,{"path":183,"title":184,"category":122,"order":185,"family":9,"subfamily":9,"status":14,"endpointId":9},"\u002Fguides\u002Fwhich-endpoint-should-i-use","Which endpoint should I use?",15,{"id":187,"title":130,"audience":9,"badgeColor":9,"badgeLabel":9,"body":188,"category":122,"description":429,"endpointId":9,"extension":430,"family":9,"links":9,"meta":431,"navigation":432,"order":131,"path":129,"relatedArticles":433,"requiresFlag":9,"seo":434,"status":14,"stem":435,"subfamily":9,"__hash__":436},"docs\u002Fguides\u002Fdata-freshness.md",{"type":189,"value":190,"toc":417},"minimark",[191,195,200,300,304,307,322,329,333,338,351,355,366,370,384,388,391,400,403],[192,193,194],"p",{},"You control the balance between data freshness and cost. The API offers three modes. Pick the one that fits your use case.",[196,197,199],"h2",{"id":198},"three-modes","Three modes",[201,202,203,226],"table",{},[204,205,206],"thead",{},[207,208,209,213,216,219,223],"tr",{},[210,211,212],"th",{},"Mode",[210,214,215],{},"Endpoint pattern",[210,217,218],{},"What you get",[210,220,222],{"align":221},"center","Credits",[210,224,225],{"align":221},"Speed",[227,228,229,256,277],"tbody",{},[207,230,231,238,247,250,253],{},[232,233,234],"td",{},[235,236,237],"strong",{},"Check",[232,239,240],{},[241,242,243],"a",{"href":24},[244,245,246],"code",{},"*\u002Fcheck",[232,248,249],{},"Whether the profile exists and when it was last updated",[232,251,252],{"align":221},"0",[232,254,255],{"align":221},"Instant",[207,257,258,262,269,272,275],{},[232,259,260],{},[235,261,20],{},[232,263,264],{},[241,265,266],{"href":63},[244,267,268],{},"\u002Fv2\u002Ffetch\u002F*",[232,270,271],{},"Cached profile data",[232,273,274],{"align":221},"1",[232,276,255],{"align":221},[207,278,279,284,291,294,297],{},[232,280,281],{},[235,282,283],{},"Live",[232,285,286],{},[241,287,288],{"href":67},[244,289,290],{},"*\u002Flive",[232,292,293],{},"Fresh data delivered via webhook",[232,295,296],{"align":221},"2",[232,298,299],{"align":221},"Async",[196,301,303],{"id":302},"optimize-your-requests","Optimize your requests",[192,305,306],{},"Use Check → Fetch → Live to optimize every request:",[308,309,311],"code-group",{"title":310},"Decision tree",[312,313,320],"pre",{"className":314,"code":316,"filename":317,"language":318,"meta":319},[315],"language-bash","1. Call CHECK (free)\n   │\n   ├─ Profile not found?\n   │  └─ Call LIVE (2 credits) → fresh data via webhook\n   │\n   └─ Profile found\n      │\n      ├─ Updated recently (\u003C your threshold)?\n      │  └─ Call FETCH (1 credit) → instant cached data\n      │\n      └─ Data is stale?\n         └─ Call LIVE (2 credits) → fresh data via webhook\n","Text","bash","",[244,321,316],{"__ignoreMap":319},[192,323,324,325,328],{},"This pattern can ",[235,326,327],{},"cut your costs by up to 50%"," if many of the profiles you query are already fresh in our database.",[196,330,332],{"id":331},"when-to-use-each-mode","When to use each mode",[334,335,337],"h3",{"id":336},"check-0-credits","Check (0 credits)",[339,340,341,345,348],"ul",{},[342,343,344],"li",{},"Before every fetch\u002Flive call in a batch pipeline",[342,346,347],{},"To monitor data freshness across your lead list",[342,349,350],{},"To build a smart queue that prioritizes stale profiles for live refresh",[334,352,354],{"id":353},"fetch-1-credit","Fetch (1 credit)",[339,356,357,360,363],{},[342,358,359],{},"When the profile exists and was updated within your acceptable freshness window",[342,361,362],{},"For high-volume pipelines where real-time accuracy isn't critical",[342,364,365],{},"As the default mode. Fall back to Live only when Check shows stale data",[334,367,369],{"id":368},"live-2-credits","Live (2 credits)",[339,371,372,375,378,381],{},[342,373,374],{},"When the profile doesn't exist in our database yet",[342,376,377],{},"When cached data is too old for your use case",[342,379,380],{},"For high-stakes enrichment (e.g. before a sales call or outreach campaign)",[342,382,383],{},"For activity endpoints (posts, comments, reactions) which are always live",[196,385,387],{"id":386},"example-batch-pipeline","Example: batch pipeline",[192,389,390],{},"Here's a pipeline that enriches 1,000 profiles at minimum cost:",[308,392,394],{"title":393},"Batch pipeline",[312,395,398],{"className":396,"code":397,"filename":317,"language":318,"meta":319},[315],"For each profile URL:\n  1. POST \u002Fv2\u002Ffetch\u002Fpersons\u002Fcheck  (free)\n  2. If exists + updated \u003C 30 days:\n       POST \u002Fv2\u002Ffetch\u002Fpersons       (1 credit)\n  3. Else:\n       POST \u002Fv2\u002Ffetch\u002Fpersons\u002Flive  (2 credits, webhook)\n",[244,399,397],{"__ignoreMap":319},[192,401,402],{},"If 60% of profiles are fresh in our database, the cost for 1,000 profiles is:",[339,404,405,408,411],{},[342,406,407],{},"600 × 1 credit (Fetch) = 600",[342,409,410],{},"400 × 2 credits (Live) = 800",[342,412,413,416],{},[235,414,415],{},"Total: 1,400 credits"," (vs 2,000 if using Live for all)",{"title":319,"searchDepth":418,"depth":418,"links":419},3,[420,422,423,428],{"id":198,"depth":421,"text":199},2,{"id":302,"depth":421,"text":303},{"id":331,"depth":421,"text":332,"children":424},[425,426,427],{"id":336,"depth":418,"text":337},{"id":353,"depth":418,"text":354},{"id":368,"depth":418,"text":369},{"id":386,"depth":421,"text":387},"Choose the right endpoint mode for your freshness and cost requirements.","md",{},true,"\u002Fdocs\u002Fguides\u002Frate-limits-credits,\u002Fdocs\u002Fguides\u002Fwhich-endpoint-should-i-use,\u002Fdocs\u002Fguides\u002Fwebhooks,\u002Fdocs\u002Fguides\u002Fproduction-checklist",{"title":130,"description":429},"guides\u002Fdata-freshness","TMPI09ldHn_QXEmFO_zTr6W1pxeS1H0PMMgjH_gdPvI",1791900212071]