\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","label",[18],"pulls","branches","forks","envVars",{"_181":183,"_184":26},"connections",{"_181":26,"_182":26},"count","unfilledCount",1,"emptyCount",{"_34":217,"_13":218,"_63":219,"_44":-5,"_36":37,"_166":220,"_167":98,"_38":221,"_40":26,"_65":21,"_170":222,"_66":24,"_172":-5,"_197":223,"_17":224},{"_34":210,"_13":211,"_63":212,"_44":-5,"_36":37,"_166":183,"_167":98,"_38":213,"_40":26,"_65":21,"_170":214,"_66":24,"_172":-5,"_197":215,"_17":216},{"_34":203,"_13":204,"_63":205,"_44":-5,"_36":37,"_166":169,"_167":98,"_38":206,"_40":26,"_65":21,"_170":207,"_66":24,"_172":-5,"_197":208,"_17":209},{"_34":165,"_13":18,"_63":64,"_44":-5,"_36":37,"_166":79,"_167":98,"_38":200,"_40":169,"_65":21,"_170":171,"_66":24,"_172":-5,"_197":201,"_17":202},{"_34":190,"_13":191,"_63":192,"_44":-5,"_36":37,"_166":193,"_167":98,"_38":194,"_40":169,"_65":195,"_170":196,"_66":24,"_172":-5,"_197":198,"_17":199},"890ea028-4077-11f0-a89b-76b3cceeab13","index.ts","e1ed7e80-2302-4bba-9d77-2bd5a33dfe98",7,["D",1748954259309],"http","import OpenAI from \"https://esm.sh/openai@4.28.0\";\nimport { serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\ninterface PersonEnrichmentRequest {\n email?: string;\n name?: string;\n company?: string;\n linkedin?: string;\n twitter?: string;\n website?: string;\n}\n\ninterface PersonEnrichmentResponse {\n success: boolean;\n data?: {\n summary: string;\n professional_background: string;\n current_role: string;\n company_info: string;\n recent_activities: string;\n social_presence: string;\n achievements: string;\n sources: string[];\n };\n error?: string;\n}\n\nexport default async function (req: Request): Promise {\n // Only allow POST requests with form data\n if (req.method !== \"POST\") {\n return serveFile(\"/index.html\", import.meta.url);\n }\n\n try {\n // Parse form data\n const formData = await req.formData();\n\n // Extract form fields\n const body: PersonEnrichmentRequest = {\n email: formData.get(\"email\")?.toString() || undefined,\n name: formData.get(\"name\")?.toString() || undefined,\n company: formData.get(\"company\")?.toString() || undefined,\n linkedin: formData.get(\"linkedin\")?.toString() || undefined,\n twitter: formData.get(\"twitter\")?.toString() || undefined,\n website: formData.get(\"website\")?.toString() || undefined,\n };\n\n // Validate that at least one identifier is provided\n if (\n !body.email &&\n !body.name &&\n !body.linkedin &&\n !body.twitter &&\n !body.website\n ) {\n return new Response(\n JSON.stringify({\n success: false,\n error:\n \"At least one identifier is required (email, name, linkedin, twitter, or website)\",\n }),\n {\n status: 400,\n headers: { \"Content-Type\": \"application/json\" },\n }\n );\n }\n\n // Build search query based on available information\n let searchQuery = \"Research and find information about this person: \";\n const identifiers: string[] = [];\n\n if (body.name) identifiers.push(`Name: ${body.name}`);\n if (body.email) identifiers.push(`Email: ${body.email}`);\n if (body.company) identifiers.push(`Company: ${body.company}`);\n if (body.linkedin) identifiers.push(`LinkedIn: ${body.linkedin}`);\n if (body.twitter) identifiers.push(`Twitter: ${body.twitter}`);\n if (body.website) identifiers.push(`Website: ${body.website}`);\n\n searchQuery += identifiers.join(\", \");\n\n searchQuery += `\n\nPlease provide a comprehensive research report with the following sections:\n1. SUMMARY: A brief overview of who this person is\n2. PROFESSIONAL_BACKGROUND: Their career history, education, and expertise\n3. CURRENT_ROLE: Their current position and responsibilities\n4. COMPANY_INFO: Information about their current or most recent company\n5. RECENT_ACTIVITIES: Recent news, projects, or public activities\n6. SOCIAL_PRESENCE: Their online presence and thought leadership\n7. ACHIEVEMENTS: Notable accomplishments, awards, or recognition\n8. SOURCES: List the main sources you found this information from\n\nFormat your response as a structured report. If you cannot find information for any section, please indicate \"No information found\" for that section.`;\n\n // Initialize OpenAI client\n const client = new OpenAI({\n apiKey: Deno.env.get(\"OPENAI_API_KEY\"),\n });\n\n // Make the search request\n const completion = await client.chat.completions.create({\n model: \"gpt-4o-search-preview\",\n web_search_options: {},\n messages: [\n {\n role: \"user\",\n content: searchQuery,\n },\n ],\n max_tokens: 2000,\n });\n\n const content = completion.choices[0].message.content;\n\n if (!content) {\n throw new Error(\"No content returned from OpenAI\");\n }\n\n // Parse the structured response\n const sections = {\n summary: extractSection(content, \"SUMMARY\"),\n professional_background: extractSection(\n content,\n \"PROFESSIONAL_BACKGROUND\"\n ),\n current_role: extractSection(content, \"CURRENT_ROLE\"),\n company_info: extractSection(content, \"COMPANY_INFO\"),\n recent_activities: extractSection(content, \"RECENT_ACTIVITIES\"),\n social_presence: extractSection(content, \"SOCIAL_PRESENCE\"),\n achievements: extractSection(content, \"ACHIEVEMENTS\"),\n sources: extractSources(content),\n };\n\n const response: PersonEnrichmentResponse = {\n success: true,\n data: sections,\n };\n\n return new Response(JSON.stringify(response, null, 2), {\n status: 200,\n headers: { \"Content-Type\": \"application/json\" },\n });\n } catch (error) {\n console.error(\"Error in person enrichment:\", error);\n\n const response: PersonEnrichmentResponse = {\n success: false,\n error: error instanceof Error ? error.message : \"Unknown error occurred\",\n };\n\n return new Response(JSON.stringify(response), {\n status: 500,\n headers: { \"Content-Type\": \"application/json\" },\n });\n }\n}\n\n// Helper function to extract sections from the response\nfunction extractSection(content: string, sectionName: string): string {\n const regex = new RegExp(\n `${sectionName}:?\\\\s*([\\\\s\\\\S]*?)(?=\\\\n\\\\d+\\\\.|\\\\n[A-Z_]+:|$)`,\n \"i\"\n );\n const match = content.match(regex);\n return match ? match[1].trim() : \"No information found\";\n}\n\n// Helper function to extract sources\nfunction extractSources(content: string): string[] {\n const sourcesSection = extractSection(content, \"SOURCES\");\n if (sourcesSection === \"No information found\") {\n return [];\n }\n\n // Try to extract URLs or source names from the sources section\n const urlRegex = /https?:\\/\\/[^\\s]+/g;\n const urls = sourcesSection.match(urlRegex) || [];\n\n // Also try to extract bullet points or numbered items\n const lines = sourcesSection\n .split(\"\\n\")\n .map((line) => line.trim())\n .filter(\n (line) => line.length > 0 && !urls.some((url) => line.includes(url))\n );\n\n return [...urls, ...lines].slice(0, 10); // Limit to 10 sources\n}\n","children",[],[191],["D",1748954317186],[],[18],"4e2a3ddc-4077-11f0-8cf7-76b3cceeab13","deno.json","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}",[],[204],"4a972c02-4077-11f0-8d91-76b3cceeab13","README.md","4b612e82-70ae-4019-8968-6cc050f41b28",["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.",[],[211],"4e300f64-4077-11f0-9355-76b3cceeab13",".vtignore","4e301022-4077-11f0-9355-76b3cceeab13",3,["D",1748954160506],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[],[218],["D",1748885079132],{"_11":12,"_135":69},{"_11":12,"_131":-5,"_68":69,"_30":67,"_132":133,"_134":24},{"_40":79,"_13":16,"_34":37,"_121":86,"_122":123,"_124":125,"_126":91,"_127":86,"_128":43,"_129":14,"_130":12},"ctx",{"_53":-5,"_155":262,"_263":264,"_265":266,"_267":24,"_268":24,"_269":24,"_270":98,"_271":-5,"_272":-7,"_273":-7,"_274":26,"_275":24,"_276":24,"_277":-5,"_278":24,"_279":24,"_280":24,"_281":-5},"ENV",{"_233":234,"_235":236,"_237":161,"_238":239,"_240":241,"_242":243,"_244":245,"_246":247,"_248":249,"_250":251,"_252":253,"_254":255,"_256":257,"_258":259,"_260":261},"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"]

History · index.html