\n Person Enrichment API\n

\n Enter information about a person to get enriched data. At least one\n field is required.\n

\n\n \n\n

\n API Information:\n

• At least one field must be filled out
• The API will search for information about the person
\n • Results include professional background, current role, and more\n
• Response format: JSON with structured data

\n \n\n",[105],"4cebc4c093a8e493b87a025dc7ee731bc2a158e7c089dbff12bb49b25fb8d7b7","deno.json",{"_32":116,"_13":114,"_76":117,"_78":-5,"_79":57,"_80":84,"_82":26,"_34":118,"_41":20,"_85":110,"_87":119,"_64":49,"_89":-5,"_90":-7,"_69":120,"_92":121},"4e2a3ddc-4077-11f0-8cf7-76b3cceeab13","4e2a3eea-4077-11f0-8cf7-76b3cceeab13",["D",1748954160502],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\n \"https://www.val.town/types/valtown.d.ts\"\n ],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"files\": {\n \"include\": [\n \"deno:/https/esm.town/**/*\"\n ]\n },\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\"\n ]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[114],"f10b65541e22a5ce4184687567a4c1c2dc1ca6b7748052706fa70ed0d511e4b4",".vtignore",{"_32":124,"_13":122,"_76":125,"_78":-5,"_79":57,"_80":126,"_82":26,"_34":127,"_41":20,"_85":110,"_87":128,"_64":49,"_89":-5,"_90":-7,"_69":129,"_92":130},"4e300f64-4077-11f0-9355-76b3cceeab13","4e301022-4077-11f0-9355-76b3cceeab13",3,["D",1748954160506],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[122],"18f4273e0b959a6002030663e4e449119845617823d38fc9fbbb206c591a8ff5",["D",1748885079132],"legacyEnvVars","httpPrivacy","description","imageUrl","userId","a0bf3b31-15a5-4d5c-880e-4b1e22c9bc18","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_167":163},"org",{"_11":12,"_161":-5,"_162":163,"_136":137,"_164":165,"_166":49},"branch","displayName","avatar","https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg","tier","pro","canRestrictVals","profileImageUrl","","adoptOrgId",{"_32":40,"_13":14,"_34":238,"_47":-5,"_132":49,"_50":51,"_133":51,"_134":-5,"_135":-5,"_136":137,"_138":95,"_139":26,"_140":26,"_141":-5,"_142":20,"_53":54,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":148,"_149":148,"_150":151,"_152":151,"_153":151,"_154":148,"_155":148,"_156":239,"_158":240,"_160":241,"_48":49},"tree",[222,223,224,225,226],"files",[222,223,224,225,226],"counts",{"_212":20,"_213":84,"_214":20,"_215":216,"_217":218},"contents",[192,193,194,195,196],"upstreamProject","upstreamBranch",{"_32":33,"_34":190,"_36":191,"_13":38,"_39":40,"_41":42,"_43":-5,"_44":-5,"_45":46,"_47":-5,"_48":49,"_50":51,"_52":12,"_53":54,"_55":14},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1748885079132],["D",1750961183784],{"_32":124,"_13":122,"_76":125,"_78":-5,"_79":57,"_80":126,"_82":26,"_34":210,"_41":20,"_85":110,"_87":128,"_64":49,"_89":-5,"_69":211},{"_32":203,"_13":204,"_76":205,"_78":-5,"_79":57,"_80":206,"_82":26,"_34":207,"_41":20,"_85":110,"_87":208,"_64":49,"_89":-5,"_69":209},{"_32":116,"_13":114,"_76":117,"_78":-5,"_79":57,"_80":84,"_82":26,"_34":201,"_41":20,"_85":110,"_87":119,"_64":49,"_89":-5,"_69":202},{"_32":107,"_13":105,"_76":108,"_78":-5,"_79":57,"_80":56,"_82":26,"_34":199,"_41":84,"_85":110,"_87":111,"_64":49,"_89":-5,"_69":200},{"_32":75,"_13":70,"_76":77,"_78":-5,"_79":57,"_80":81,"_82":26,"_34":197,"_41":84,"_85":86,"_87":88,"_64":49,"_89":-5,"_69":198},["D",1748954259309],[70],["D",1748954317186],[105],["D",1748954160502],[114],"4a972c02-4077-11f0-8d91-76b3cceeab13","README.md","4b612e82-70ae-4019-8968-6cc050f41b28",1,["D",1748954154510],"# Person Enrichment API\n\nAn HTTP endpoint that enriches person data using OpenAI's web search capabilities. Provide basic information about a person (email, name, etc.) and get back comprehensive research about them.\n\n## Setup\n\n1. Set your OpenAI API key as an environment variable: `OPENAI_API_KEY`\n2. The API uses the `gpt-4o-search-preview` model with web search capabilities\n\n## Usage\n\n### Endpoint\n- **Method**: POST\n- **Content-Type**: multipart/form-data\n\n### Request Body (Form Data)\n\nThe API accepts form data with the following fields:\n\n- `email` (optional): Person's email address\n- `name` (optional): Person's full name\n- `company` (optional): Company name\n- `linkedin` (optional): LinkedIn profile URL\n- `twitter` (optional): Twitter profile URL\n- `website` (optional): Personal or company website URL\n\n**Note**: At least one field is required. You can provide any combination of the above fields as form data.\n\n### Response\n\n#### Success Response (200)\n```json\n{\n \"success\": true,\n \"data\": {\n \"summary\": \"Brief overview of the person\",\n \"professional_background\": \"Career history and education\",\n \"current_role\": \"Current position and responsibilities\",\n \"company_info\": \"Information about their company\",\n \"recent_activities\": \"Recent news and projects\",\n \"social_presence\": \"Online presence and thought leadership\",\n \"achievements\": \"Notable accomplishments\",\n \"sources\": [\"https://example.com\", \"LinkedIn profile\", \"...\"]\n }\n}\n```\n\n#### Error Response (400/405/500)\n```json\n{\n \"success\": false,\n \"error\": \"Error description\"\n}\n```\n\n**Common Error Cases:**\n- `405 Method Not Allowed`: Only POST requests are accepted\n- `400 Bad Request`: No identifiers provided (at least one field required)\n- `500 Internal Server Error`: OpenAI API error or processing failure\n\n## Example Usage\n\n### cURL\n```bash\ncurl -X POST https://your-val-url.web.val.run \\\n -F \"email=elon@tesla.com\" \\\n -F \"name=Elon Musk\"\n```\n\n### JavaScript (using FormData)\n```javascript\nconst formData = new FormData();\nformData.append('email', 'person@example.com');\nformData.append('name', 'John Doe');\n\nconst response = await fetch('https://your-val-url.web.val.run', {\n method: 'POST',\n body: formData\n});\n\nconst data = await response.json();\nconsole.log(data);\n```\n\n### HTML Form\n```html\n\n```\n\n## Features\n\n- **Web Search Integration**: Uses OpenAI's `gpt-4o-search-preview` model with web search capabilities\n- **Form Data Support**: Accepts standard HTML form submissions and FormData objects\n- **Comprehensive Research**: Provides structured information across multiple categories\n- **Flexible Input**: Accepts various identifiers (email, name, social profiles, etc.)\n- **Source Attribution**: Returns sources where information was found\n- **Error Handling**: Graceful error handling with descriptive messages\n- **Method Validation**: Only accepts POST requests for security\n\n## Privacy & Ethics\n\nThis tool is designed for legitimate business purposes such as:\n- Sales prospecting and lead qualification\n- Partnership research\n- Due diligence for business relationships\n- Professional networking\n\nPlease ensure you comply with:\n- GDPR and other privacy regulations\n- Your organization's data handling policies\n- Ethical guidelines for data collection and use\n- Terms of service of the platforms being researched\n\n## Rate Limits\n\nThe API is subject to OpenAI's rate limits for the `gpt-4o-search-preview` model. Consider implementing your own rate limiting if needed for production use.",[204],["D",1748954160506],[122],"pulls","branches","forks","envVars",{"_219":206,"_221":20},"connections",{"_219":20,"_220":20},"count","unfilledCount","emptyCount",{"_32":124,"_13":122,"_76":125,"_78":-5,"_79":57,"_80":126,"_82":26,"_34":127,"_41":20,"_85":110,"_87":128,"_64":49,"_89":-5,"_90":236,"_69":237},{"_32":203,"_13":204,"_76":205,"_78":-5,"_79":57,"_80":206,"_82":26,"_34":233,"_41":20,"_85":110,"_87":208,"_64":49,"_89":-5,"_90":234,"_69":235},{"_32":116,"_13":114,"_76":117,"_78":-5,"_79":57,"_80":84,"_82":26,"_34":118,"_41":20,"_85":110,"_87":119,"_64":49,"_89":-5,"_90":231,"_69":232},{"_32":107,"_13":105,"_76":108,"_78":-5,"_79":57,"_80":56,"_82":26,"_34":109,"_41":84,"_85":110,"_87":111,"_64":49,"_89":-5,"_90":229,"_69":230},{"_32":75,"_13":70,"_76":77,"_78":-5,"_79":57,"_80":81,"_82":26,"_34":83,"_41":84,"_85":86,"_87":88,"_64":49,"_89":-5,"_90":227,"_69":228},[],[70],[],[105],[],[114],["D",1748954154510],[],[204],[],[122],["D",1748885079132],{"_11":12,"_167":163},{"_11":12,"_161":-5,"_162":163,"_136":137,"_164":165,"_166":49},{"_41":56,"_13":16,"_32":57,"_39":40,"_43":33,"_44":58,"_59":51,"_60":40,"_61":54,"_55":14,"_52":12},"ctx",{"_156":-5,"_187":275,"_276":277,"_278":279,"_280":49,"_281":49,"_282":49,"_283":26,"_284":-5,"_285":-7,"_286":-7,"_287":20,"_288":49,"_289":49,"_290":-5,"_291":49,"_292":49,"_293":49,"_294":-5},"ENV",{"_246":247,"_248":249,"_250":38,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270,"_271":272,"_273":274},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","71c1b20804b3232a7e513be260cfffc1932a9e97","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Compare

Mergeadd-uiintomain

Hindex.ts+79-64

.vtignore+6-0

deno.json+37-0

index.html+141-0