[{"data":1,"prerenderedAt":757},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fendpoints\u002Fsearch-people-auto-suggestion":239},[4,11,16,21,29,35,42,47,53,59,64,69,74,79,84,91,97,102,107,113,118,123,128,132,137,142,146,151,156,160,164,168,171,175,180,184,187,190,194,198,202,206,209,213,217,221,225,229,232,236],{"path":5,"title":6,"category":7,"order":8,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fagents","Agent brief","mcp",40,null,"new",{"path":12,"title":13,"category":14,"order":15,"family":9,"subfamily":9,"status":9,"endpointId":9},"\u002Fapi-reference","API reference","introduction",30,{"path":17,"title":18,"category":14,"order":19,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fauthentication","Authentication",20,"updated",{"path":22,"title":23,"category":24,"order":25,"family":26,"subfamily":27,"status":20,"endpointId":28},"\u002Fendpoints\u002Fcheck-company","Company profile status","endpoints",220,"Fetch","Company","check-company",{"path":30,"title":31,"category":24,"order":32,"family":26,"subfamily":33,"status":20,"endpointId":34},"\u002Fendpoints\u002Fcheck-person","Person profile status",120,"Person","check-person",{"path":36,"title":37,"category":24,"order":38,"family":39,"subfamily":40,"status":9,"endpointId":41},"\u002Fendpoints\u002Fcontact-email","Find Email",600,"Contact","Email","contact-email",{"path":43,"title":44,"category":24,"order":45,"family":39,"subfamily":40,"status":9,"endpointId":46},"\u002Fendpoints\u002Fcontact-email-verify","Verify Email",605,"contact-email-verify",{"path":48,"title":49,"category":24,"order":50,"family":39,"subfamily":51,"status":9,"endpointId":52},"\u002Fendpoints\u002Fcontact-phone","Find Phone",610,"Phone","contact-phone",{"path":54,"title":55,"category":24,"order":56,"family":57,"subfamily":27,"status":20,"endpointId":58},"\u002Fendpoints\u002Fenrich-company","Enrich company",90,"Enrichment","enrich-company",{"path":60,"title":61,"category":24,"order":62,"family":57,"subfamily":33,"status":20,"endpointId":63},"\u002Fendpoints\u002Fenrich-person","Enrich profile",80,"enrich-person",{"path":65,"title":66,"category":24,"order":67,"family":26,"subfamily":27,"status":20,"endpointId":68},"\u002Fendpoints\u002Ffetch-company","Company profile",200,"fetch-company",{"path":70,"title":71,"category":24,"order":72,"family":26,"subfamily":27,"status":20,"endpointId":73},"\u002Fendpoints\u002Ffetch-company-live","Company profile live",210,"fetch-company-live",{"path":75,"title":76,"category":24,"order":77,"family":26,"subfamily":33,"status":20,"endpointId":78},"\u002Fendpoints\u002Ffetch-profile","Person profile",100,"fetch-profile",{"path":80,"title":81,"category":24,"order":82,"family":26,"subfamily":33,"status":20,"endpointId":83},"\u002Fendpoints\u002Ffetch-profile-live","Person profile live",110,"fetch-profile-live",{"path":85,"title":86,"category":24,"order":87,"family":88,"subfamily":89,"status":10,"endpointId":90},"\u002Fendpoints\u002Fsearch-companies","Company search",94,"Search","Companies","search-organizations",{"path":92,"title":93,"category":24,"order":94,"family":95,"subfamily":9,"status":10,"endpointId":96},"\u002Fendpoints\u002Fsearch-companies-available-fields","Company search available fields",720,"Utility","search-organizations-available-fields",{"path":98,"title":99,"category":24,"order":100,"family":88,"subfamily":89,"status":10,"endpointId":101},"\u002Fendpoints\u002Fsearch-companies-count","Company search count",95,"search-organizations-count",{"path":103,"title":104,"category":24,"order":105,"family":88,"subfamily":89,"status":10,"endpointId":106},"\u002Fendpoints\u002Fsearch-companies-prompt","Agentic Company Search",97,"search-organizations-prompt",{"path":108,"title":109,"category":24,"order":110,"family":88,"subfamily":111,"status":10,"endpointId":112},"\u002Fendpoints\u002Fsearch-people","People search",92,"People","search-people",{"path":114,"title":115,"category":24,"order":116,"family":95,"subfamily":9,"status":10,"endpointId":117},"\u002Fendpoints\u002Fsearch-people-auto-suggestion","People auto-suggestion",730,"search-people-auto-suggestion",{"path":119,"title":120,"category":24,"order":121,"family":95,"subfamily":9,"status":10,"endpointId":122},"\u002Fendpoints\u002Fsearch-people-available-fields","People search available fields",710,"search-people-available-fields",{"path":124,"title":125,"category":24,"order":126,"family":88,"subfamily":111,"status":10,"endpointId":127},"\u002Fendpoints\u002Fsearch-people-count","People search count",93,"search-people-count",{"path":129,"title":130,"category":24,"order":100,"family":88,"subfamily":111,"status":10,"endpointId":131},"\u002Fendpoints\u002Fsearch-people-lookalike","People lookalike","search-people-lookalike",{"path":133,"title":134,"category":24,"order":135,"family":88,"subfamily":111,"status":10,"endpointId":136},"\u002Fendpoints\u002Fsearch-people-prompt","Agentic Search",96,"search-people-prompt",{"path":138,"title":139,"category":24,"order":140,"family":95,"subfamily":9,"status":20,"endpointId":141},"\u002Fendpoints\u002Fusage","Usage",700,"usage",{"path":143,"title":144,"category":14,"order":145,"family":9,"subfamily":9,"status":9,"endpointId":9},"\u002Fgetting-started","Getting started",10,{"path":147,"title":148,"category":149,"order":150,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fagent-skills","Agent skills","cli",70,{"path":152,"title":153,"category":154,"order":155,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fapi-key-management","API key management","guides",12,{"path":157,"title":158,"category":149,"order":159,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fcli","Command line interface (CLI)",60,{"path":161,"title":162,"category":154,"order":163,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fcredits","Credits",24,{"path":165,"title":166,"category":154,"order":167,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fcurrent-position-resolution","Current position and work history ordering",35,{"path":169,"title":170,"category":154,"order":8,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fdata-freshness","Data freshness",{"path":172,"title":173,"category":154,"order":174,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fdata-quality","Data quality",18,{"path":176,"title":177,"category":178,"order":179,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fendpoint-transition-october-2026","Endpoint transition on October 13, 2026","migrations",1,{"path":181,"title":182,"category":154,"order":183,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fenrich-a-csv-file","Enrich a CSV file",16,{"path":185,"title":186,"category":154,"order":19,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Ferrors-retries","Error handling & retries",{"path":188,"title":189,"category":154,"order":145,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Ffirst-api-call","Your first API call",{"path":191,"title":192,"category":7,"order":193,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fmcp","Connect AI agents (MCP)",50,{"path":195,"title":196,"category":178,"order":197,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fmigrating-search-companies-to-organizations","Migrating company search to the new endpoint",2,{"path":199,"title":200,"category":178,"order":201,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fmigrating-search-persons-to-people","Migrating people search from persons to people",51,{"path":203,"title":204,"category":154,"order":205,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Fmissing-and-empty-fields","Missing and empty profile fields",42,{"path":207,"title":208,"category":154,"order":15,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fpolling","Polling for async results",{"path":210,"title":211,"category":154,"order":212,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fproduction-checklist","Production checklist",45,{"path":214,"title":215,"category":154,"order":216,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fguides\u002Frate-limits","Rate limits",25,{"path":218,"title":219,"category":154,"order":220,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fwebhooks","Webhooks",31,{"path":222,"title":223,"category":154,"order":224,"family":9,"subfamily":9,"status":20,"endpointId":9},"\u002Fguides\u002Fwhich-endpoint-should-i-use","Which endpoint should I use?",15,{"path":226,"title":227,"category":228,"order":201,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Freference\u002Fareas","Area values","reference",{"path":230,"title":231,"category":228,"order":193,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Freference\u002Findustries","Industry values",{"path":233,"title":234,"category":235,"order":145,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fsdk\u002Fjavascript","TypeScript and JavaScript SDK","sdk",{"path":237,"title":238,"category":235,"order":19,"family":9,"subfamily":9,"status":10,"endpointId":9},"\u002Fsdk\u002Fpython","Python SDK",{"id":240,"title":115,"audience":9,"badgeColor":9,"badgeLabel":9,"body":241,"category":24,"description":748,"endpointId":117,"extension":749,"family":95,"lastVerified":750,"links":9,"meta":751,"navigation":752,"order":116,"path":114,"relatedArticles":753,"requiresFlag":9,"seo":754,"status":10,"stem":755,"subfamily":9,"__hash__":756},"docs\u002Fendpoints\u002Fsearch-people-auto-suggestion.md",{"type":242,"value":243,"toc":738},"minimark",[244,248,252,269,280,284,330,334,397,421,437,441,490,572,612,618,622,625,686,690,722,726],[245,246,247],"h2",{"id":14},"Introduction",[249,250,251],"p",{},"The People Auto-suggestion endpoint returns the skills that start with what someone has typed, most common first. It returns values only, never a profile.",[249,253,254,255,259,260,264,265,268],{},"It is made for products: use it to offer auto-suggestion in a search box of your own interface, then send the value your user picks to the ",[256,257,258],"code",{},"skills"," filter of ",[261,262,109],"a",{"href":263},"\u002Fendpoints\u002Fsearch-people#skills"," or of its ",[261,266,267],{"href":124},"free count",".",[249,270,271,272,276,277,268],{},"This endpoint ",[273,274,275],"strong",{},"costs 0 credits"," and has its own rate limit: 1,000 calls per minute per workspace, or 500 on the free trial. Its calls never use up your workspace's ",[261,278,279],{"href":214},"requests per minute",[245,281,283],{"id":282},"authorization","Authorization",[285,286,287,306],"table",{},[288,289,290],"thead",{},[291,292,293,297,300,303],"tr",{},[294,295,296],"th",{},"Name",[294,298,299],{},"Type",[294,301,302],{},"Required",[294,304,305],{},"Description",[307,308,309],"tbody",{},[291,310,311,317,320,323],{},[312,313,314],"td",{},[256,315,316],{},"apikey",[312,318,319],{},"string",[312,321,322],{},"Yes",[312,324,325,326,329],{},"Your API key from the developer dashboard. Pass it via ",[256,327,328],{},"Authorization: Bearer YOUR_API_KEY"," header.",[245,331,333],{"id":332},"request-body","Request body",[285,335,336,348],{},[288,337,338],{},[291,339,340,342,344,346],{},[294,341,296],{},[294,343,299],{},[294,345,302],{},[294,347,305],{},[307,349,350,367,381],{},[291,351,352,357,359,361],{},[312,353,354],{},[256,355,356],{},"field",[312,358,319],{},[312,360,322],{},[312,362,363,364,366],{},"The filter to complete. ",[256,365,258],{}," is the only value today",[291,368,369,374,376,378],{},[312,370,371],{},[256,372,373],{},"query",[312,375,319],{},[312,377,322],{},[312,379,380],{},"What has been typed so far, 1 to 100 characters. Case and accents are ignored",[291,382,383,388,391,394],{},[312,384,385],{},[256,386,387],{},"limit",[312,389,390],{},"number",[312,392,393],{},"No",[312,395,396],{},"Maximum values returned, from 1 to 25. Defaults to 10",[249,398,399,400,402,403,406,407,410,411,406,414,417,418,268],{},"A value matches when it starts with ",[256,401,373],{},", spaces included: ",[256,404,405],{},"machine l"," returns ",[256,408,409],{},"machine learning",", and ",[256,412,413],{},"script",[256,415,416],{},"scripting"," but not ",[256,419,420],{},"javascript",[249,422,423,424,426,427,429,430,432,433,436],{},"Any other ",[256,425,356],{},", an empty ",[256,428,373],{}," or a ",[256,431,387],{}," out of range returns HTTP ",[256,434,435],{},"422"," and names the expected value.",[245,438,440],{"id":439},"response-structure","Response structure",[285,442,443,454],{},[288,444,445],{},[291,446,447,450,452],{},[294,448,449],{},"Field",[294,451,299],{},[294,453,305],{},[307,455,456,472],{},[291,457,458,463,466],{},[312,459,460],{},[256,461,462],{},"success",[312,464,465],{},"boolean",[312,467,468,471],{},[256,469,470],{},"true"," if the request was processed successfully",[291,473,474,479,484],{},[312,475,476],{},[256,477,478],{},"error",[312,480,481],{},[256,482,483],{},"null",[312,485,486,487,489],{},"Always ",[256,488,483],{}," on success",[491,492,495,501],"docs-object",{"field":493,"type":494},"data","SearchAutoSuggestion",[496,497,498],"docs-object-description",{},[249,499,500],{},"Values that start with the query",[502,503,504],"docs-object-children",{},[285,505,506,516],{},[288,507,508],{},[291,509,510,512,514],{},[294,511,449],{},[294,513,299],{},[294,515,305],{},[307,517,518,532,546,557],{},[291,519,520,525,527],{},[312,521,522],{},[256,523,524],{},"object",[312,526,319],{},[312,528,486,529],{},[256,530,531],{},"search_auto_suggestions",[291,533,534,539,541],{},[312,535,536],{},[256,537,538],{},"entity",[312,540,319],{},[312,542,486,543],{},[256,544,545],{},"person",[291,547,548,552,554],{},[312,549,550],{},[256,551,356],{},[312,553,319],{},[312,555,556],{},"The filter completed",[291,558,559,564,569],{},[312,560,561],{},[256,562,563],{},"suggestions",[312,565,524,566],{},[567,568],"span",{},[312,570,571],{},"The values, most common first. Empty when no value starts with the query",[491,573,576,581],{"field":574,"type":575},"suggestions[]","AutoSuggestionValue",[496,577,578],{},[249,579,580],{},"One value",[502,582,583],{},[285,584,585,595],{},[288,586,587],{},[291,588,589,591,593],{},[294,590,449],{},[294,592,299],{},[294,594,305],{},[307,596,597],{},[291,598,599,604,606],{},[312,600,601],{},[256,602,603],{},"value",[312,605,319],{},[312,607,608,609,611],{},"The value to show, and to send as it is in the ",[256,610,258],{}," filter",[249,613,614,615,617],{},"Values come in lowercase and without accents, as they are held for matching. The ",[256,616,258],{}," filter ignores case, so you can restyle a value for display and still send it.",[245,619,621],{"id":620},"build-a-search-box","Build a search box",[249,623,624],{},"A few habits keep the box fast and within its limit:",[626,627,628,635,641,647,653,659,665],"ul",{},[629,630,631,634],"li",{},[273,632,633],{},"Call from your server."," The call needs your API key, which must never reach a browser.",[629,636,637,640],{},[273,638,639],{},"Wait for a pause in the typing."," Calling about 200 ms after the last key sends one request for a burst of keys.",[629,642,643,646],{},[273,644,645],{},"Start at two characters."," One letter matches too much to help.",[629,648,649,652],{},[273,650,651],{},"Cancel the previous request"," when a new one starts, so a late answer never replaces a newer one.",[629,654,655,658],{},[273,656,657],{},"Keep the answers"," for the session: the same prefix returns the same values.",[629,660,661,664],{},[273,662,663],{},"Let people add what they typed."," An empty list only means that no value starts this way, so a person can still search on their own wording.",[629,666,667,674,675,677,678,681,682,685],{},[273,668,669,670,673],{},"Treat a ",[256,671,672],{},"429"," like an empty list."," The call returns ",[256,676,672],{}," with the code ",[256,679,680],{},"RATE_LIMIT_EXCEEDED"," past its limit, and also at times of very high demand, with a ",[256,683,684],{},"Retry-After"," header. Show no list, keep accepting what the person types, and try again on the next key.",[245,687,689],{"id":688},"code-examples","Code examples",[691,692,694,705,714],"code-group",{"title":693},"Code Examples",[695,696,703],"pre",{"className":697,"code":699,"filename":700,"language":701,"meta":702},[698],"language-bash","curl -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Fsearch\u002Fpeople\u002Fauto-suggestion \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"field\": \"skills\",\n    \"query\": \"pyth\",\n    \"limit\": 5\n  }'\n","cURL","bash","",[256,704,699],{"__ignoreMap":702},[695,706,712],{"className":707,"code":709,"filename":710,"language":711,"meta":702},[708],"language-typescript","import ReverseContact from \"@reverse-contact\u002Fsdk\";\n\nconst client = new ReverseContact({ apiKey: process.env.RC_API_KEY });\n\nconst result = await client.search.peopleAutoSuggestion({\n  field: \"skills\",\n  query: \"pyth\",\n  limit: 5\n});\nconsole.log(result.data.suggestions?.map((suggestion) => suggestion.value));\n","TypeScript SDK","typescript",[256,713,709],{"__ignoreMap":702},[695,715,720],{"className":716,"code":718,"filename":238,"language":719,"meta":702},[717],"language-python","import os\n\nfrom reversecontact import ReverseContact\n\nwith ReverseContact(api_key=os.environ[\"RC_API_KEY\"]) as client:\n    result = client.search.people_auto_suggestion(\n        field=\"skills\",\n        query=\"pyth\",\n        limit=5,\n    )\n    if result.data is not None and result.data.suggestions is not None:\n        print([suggestion.value for suggestion in result.data.suggestions])\n","python",[256,721,718],{"__ignoreMap":702},[245,723,725],{"id":724},"example-response","Example response",[691,727,729],{"title":728},"Example Response",[695,730,736],{"className":731,"code":733,"filename":734,"language":735,"meta":702},[732],"language-json","{\n  \"success\": true,\n  \"data\": {\n    \"object\": \"search_auto_suggestions\",\n    \"entity\": \"person\",\n    \"field\": \"skills\",\n    \"suggestions\": [\n      { \"value\": \"python programming language\" },\n      { \"value\": \"python\" },\n      { \"value\": \"python langage de programmation\" },\n      { \"value\": \"python programmiersprache\" }\n    ]\n  },\n  \"error\": null,\n  \"quotas\": {\n    \"creditsConsumed\": 0,\n    \"workspace\": {\n      \"id\": \"ws_abc123\",\n      \"credits\": { \"total\": 10000, \"used\": 4521, \"left\": 5479 }\n    }\n  },\n  \"metadata\": {\n    \"requestId\": \"req_a1u2t3o4\",\n    \"executionTimeMs\": 170\n  }\n}\n","200 - Success","json",[256,737,733],{"__ignoreMap":702},{"title":702,"searchDepth":739,"depth":739,"links":740},3,[741,742,743,744,745,746,747],{"id":14,"depth":197,"text":247},{"id":282,"depth":197,"text":283},{"id":332,"depth":197,"text":333},{"id":439,"depth":197,"text":440},{"id":620,"depth":197,"text":621},{"id":688,"depth":197,"text":689},{"id":724,"depth":197,"text":725},"Complete a skill as someone types, for free, to build a people search box in your own product.","md","2026-11-03",{},true,"\u002Fdocs\u002Fendpoints\u002Fsearch-people,\u002Fdocs\u002Fendpoints\u002Fsearch-people-count",{"title":115,"description":748},"endpoints\u002Fsearch-people-auto-suggestion","5p3YgbfDBoPtqsCiLYrx4oIiulUorcVcBcI0BqQ5oqo",1793748783240]