Every API here is available over the APIs.io API and to AI agents over MCP.
{
"openapi": "3.0.0",
"info": {
"title": "NeuralVerge API",
"version": "1.0.0",
"description": "NeuralVerge API for AI research workflows, search, extraction, and structured data source execution."
},
"servers": [
{
"url": "https://api.neuralverge.ai",
"description": "NeuralVerge API"
}
],
"components": {
"securitySchemes": {
"BearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "API Key"
}
}
},
"security": [
{
"BearerAuth": []
}
],
"tags": [
{
"name": "AI Research",
"description": "Research workflows and session tracking."
},
{
"name": "AI Extract",
"description": "Schema-driven extraction workflows."
},
{
"name": "AI Agents",
"description": "Reusable saved agents executed through the API."
},
{
"name": "Search",
"description": "Fast, synchronous web search with no session or polling."
},
{
"name": "Data Sources",
"description": "Focused provider lookups for LinkedIn, email, phone, company, and Amazon data."
}
],
"paths": {
"/functions/v1/run-research": {
"post": {
"tags": [
"AI Research"
],
"summary": "Run Research",
"description": "Starts the full research workflow and returns a session id immediately.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"instructions",
"settings"
],
"properties": {
"instructions": {
"type": "string",
"description": "Main research task."
},
"settings": {
"type": "object",
"properties": {
"country_code": {
"type": "string"
},
"search_enabled": {
"type": "boolean"
},
"deepsearch_model": {
"type": "string"
},
"finalizer_model": {
"type": "string"
},
"extract_schema_json": {
"type": "string"
}
}
}
}
},
"example": {
"instructions": "Analyze the company and identify the main risks.",
"settings": {
"country_code": "us",
"search_enabled": true,
"deepsearch_model": "base",
"finalizer_model": "gemini-3.0-pro"
}
}
}
}
},
"responses": {
"200": {
"description": "Session started.",
"content": {
"application/json": {
"example": {
"session_id": "11111111-1111-1111-1111-111111111111"
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"402": {
"description": "Payment Required"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-agent": {
"post": {
"tags": [
"AI Agents"
],
"summary": "Run Agent",
"description": "Runs a saved agent and returns a session id immediately.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"agentId",
"instructions",
"settings"
],
"properties": {
"agentId": {
"type": "string",
"format": "uuid"
},
"instructions": {
"type": "string"
},
"settings": {
"type": "object",
"properties": {
"country_code": {
"type": "string"
},
"search_enabled": {
"type": "boolean"
},
"deepsearch_model": {
"type": "string"
},
"finalizer_model": {
"type": "string"
}
}
}
}
},
"example": {
"agentId": "00000000-0000-0000-0000-000000000001",
"instructions": "Analyze the company, identify key risks, and prepare a concise report.",
"settings": {
"country_code": "us",
"search_enabled": true,
"deepsearch_model": "base",
"finalizer_model": "gemini-3.0-pro"
}
}
}
}
},
"responses": {
"200": {
"description": "Session started.",
"content": {
"application/json": {
"example": {
"session_id": "11111111-1111-1111-1111-111111111111"
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"404": {
"description": "Not Found"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/get-session-status": {
"get": {
"tags": [
"AI Research"
],
"summary": "Get Session Status",
"description": "Returns the current status of a session and the final result when complete.",
"parameters": [
{
"name": "session_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
},
"description": "Session identifier."
}
],
"responses": {
"200": {
"description": "Session status.",
"content": {
"application/json": {
"example": {
"session_id": "11111111-1111-1111-1111-111111111111",
"status": "complete",
"results": {
"kind": "deepsearch",
"human": "# Research summary\n\n- Main takeaway: Example risk is moderate.",
"machine": {
"summary": "Example risk is moderate.",
"risk_level": "medium"
},
"total_points": 50
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"404": {
"description": "Not Found"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-search": {
"post": {
"tags": [
"Search"
],
"summary": "Run Search",
"description": "Runs a web search and returns a structured search payload.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"query",
"settings"
],
"properties": {
"query": {
"type": "string"
},
"settings": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"language": {
"type": "string"
},
"max_results": {
"type": "number"
}
}
}
}
},
"example": {
"query": "OpenAI pricing",
"settings": {
"country": "us",
"language": "en",
"max_results": 10
}
}
}
}
},
"responses": {
"200": {
"description": "Search completed.",
"content": {
"application/json": {
"example": {
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "search",
"query": "OpenAI pricing",
"results": [
{
"rank": 1,
"title": "OpenAI Pricing",
"url": "https://openai.com/pricing",
"snippet": "Simple and flexible pricing."
}
],
"total_points": 5
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"402": {
"description": "Payment Required"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-extract": {
"post": {
"tags": [
"AI Extract"
],
"summary": "Run Extract",
"description": "Loads a page by URL and extracts structured data.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"url",
"instructions",
"settings"
],
"properties": {
"url": {
"type": "string"
},
"instructions": {
"type": "string"
},
"settings": {
"type": "object",
"properties": {
"country_code": {
"type": "string"
},
"extract_schema_json": {
"type": "string"
}
}
}
}
},
"example": {
"url": "https://example.com",
"instructions": "Collect company name and contact details.",
"settings": {
"country_code": "us",
"extract_schema_json": "{ \"type\": \"object\" }"
}
}
}
}
},
"responses": {
"200": {
"description": "Extraction completed.",
"content": {
"application/json": {
"example": {
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "extract",
"url": "https://example.com",
"machine": {
"company_name": "Example Inc.",
"contact_email": "hello@example.com"
},
"total_points": 3
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"402": {
"description": "Payment Required"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-linkedin-email": {
"post": {
"tags": [
"Data Sources"
],
"summary": "Run LinkedIn Email",
"description": "Looks up a LinkedIn profile and returns contact details, including email when available.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"description": "Full LinkedIn profile URL."
}
}
},
"example": {
"username": "https://www.linkedin.com/in/john-doe/"
}
}
}
},
"responses": {
"200": {
"description": "Lookup completed.",
"content": {
"application/json": {
"example": {
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "linkedin_email",
"username": "https://www.linkedin.com/in/sam-altman/",
"includeEmail": true,
"human": "# LinkedIn people profile + Email\n\n- **Profile_url:** https://www.linkedin.com/in/sam-altman/\n- **Fullname:** Sam Altman\n- **Headline:** CEO at OpenAI\n- **Location:** San Francisco Bay Area\n- **About:** CEO of OpenAI and former president of Y Combinator.\n- **Email:** sam@openai.com",
"machine": {
"total_items": 1,
"first_item": {
"basic_info": {
"fullname": "Sam Altman",
"headline": "CEO at OpenAI",
"profile_url": "https://www.linkedin.com/in/sam-altman/",
"location": {
"full": "San Francisco Bay Area"
},
"about": "CEO of OpenAI and former president of Y Combinator."
},
"email": "sam@openai.com"
},
"items": [
{
"basic_info": {
"fullname": "Sam Altman",
"headline": "CEO at OpenAI",
"profile_url": "https://www.linkedin.com/in/sam-altman/"
},
"email": "sam@openai.com"
}
]
},
"total_points": 10
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"402": {
"description": "Payment Required"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-linkedin-domain": {
"post": {
"tags": [
"Data Sources"
],
"summary": "Run LinkedIn Domain",
"description": "Finds a LinkedIn profile by company name or domain and full name.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"company_or_domain",
"full_name"
],
"properties": {
"company_or_domain": {
"type": "string"
},
"full_name": {
"type": "string"
}
}
},
"example": {
"company_or_domain": "openai.com",
"full_name": "John Doe"
}
}
}
},
"responses": {
"200": {
"description": "Lookup completed.",
"content": {
"application/json": {
"example": {
"session_id": "22222222-2222-2222-2222-222222222222",
"kind": "linkedin_domain",
"company_or_domain": "openai.com",
"full_name": "Sam Altman",
"human": "# LinkedIn profile by name and domain\n\n- **Company name / Domain:** openai.com\n- **Full name:** Sam Altman\n- **Matched name:** Sam Altman\n- **Profile URL:** https://www.linkedin.com/in/sam-altman/\n- **Headline:** CEO at OpenAI\n- **Company:** OpenAI\n- **Location:** San Francisco Bay Area\n- **Records returned:** 1\n\n## Summary\n\nCEO at OpenAI and former president of Y Combinator.",
"machine": {
"total_items": 1,
"first_item": {
"fullName": "Sam Altman",
"profileUrl": "https://www.linkedin.com/in/sam-altman/",
"headline": "CEO at OpenAI",
"companyName": "OpenAI",
"location": "San Francisco Bay Area",
"summary": "CEO at OpenAI and former president of Y Combinator."
}
},
"total_points": 10
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"402": {
"description": "Payment Required"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-linkedin-company-search": {
"post": {
"tags": [
"Data Sources"
],
"summary": "Run LinkedIn Company Search",
"description": "Searches LinkedIn companies by query and optional filters.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"searchQuery"
],
"properties": {
"searchQuery": {
"type": "string"
},
"companySize": {
"type": "array",
"items": {
"type": "string"
}
},
"industryIds": {
"type": "array",
"items": {
"type": "string"
}
},
"locations": {
"type": "array",
"items": {
"type": "string"
}
},
"maxItems": {
"type": "number"
},
"scraperMode": {
"type": "string"
},
"startPage": {
"type": "number"
}
}
},
"example": {
"searchQuery": "AI companies",
"companySize": [
"51-200"
],
"industryIds": [
"Software"
],
"locations": [
"Amsterdam"
],
"maxItems": 5,
"scraperMode": "short",
"startPage": 1
}
}
}
},
"responses": {
"200": {
"description": "Search completed.",
"content": {
"application/json": {
"example": {
"session_id": "33333333-3333-3333-3333-333333333333",
"kind": "linkedin_company_search",
"companySize": [
"51-200"
],
"industryIds": [
"Software Development"
],
"locations": [
"San Francisco Bay Area"
],
"maxItems": 2,
"scraperMode": "short",
"searchQuery": "AI safety companies",
"startPage": 1,
"human": "# LinkedIn company search\n\n- **Results returned:** 2\n\n### OpenAI\n\n- **Profile URL:** https://www.linkedin.com/company/openai/\n- **Industry:** Research Services\n- **Location:** San Francisco Bay Area\n- **Followers:** 3200000\n- **Summary:** AI research and deployment company.\n\n### Anthropic\n\n- **Profile URL:** https://www.linkedin.com/company/anthropicresearch/\n- **Industry:** Software Development\n- **Location:** San Francisco, California\n- **Followers:** 450000\n- **Summary:** Building reliable, interpretable, and steerable AI systems.",
"machine": {
"total_items": 2,
"first_item": {
"name": "OpenAI",
"url": "https://www.linkedin.com/company/openai/",
"industry": "Research Services",
"headquarters": "San Francisco Bay Area",
"followers": "3200000",
"description": "AI research and deployment company."
},
"items": [
{
"name": "OpenAI",
"url": "https://www.linkedin.com/company/openai/",
"industry": "Research Services"
},
{
"name": "Anthropic",
"url": "https://www.linkedin.com/company/anthropicresearch/",
"industry": "Software Development"
}
]
},
"points_per_company": 5,
"total_points": 10
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"402": {
"description": "Payment Required"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-linkedin-people-search": {
"post": {
"tags": [
"Data Sources"
],
"summary": "Run LinkedIn People Search",
"description": "Searches LinkedIn people using optional query terms and advanced filters.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"searchQuery": {
"type": "string"
},
"maxResults": {
"type": "number"
},
"startPage": {
"type": "number"
},
"scraperMode": {
"type": "string"
},
"locations": {
"type": "array",
"items": {
"type": "string"
}
},
"currentCompany": {
"type": "array",
"items": {
"type": "string"
}
},
"pastCompany": {
"type": "array",
"items": {
"type": "string"
}
},
"currentJobTitleFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"pastJobTitle": {
"type": "array",
"items": {
"type": "string"
}
},
"yearsOfExperienceFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"yearsAtCurrentCompanyFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"seniorityLevelFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"functionFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"industryIds": {
"type": "array",
"items": {
"type": "string"
}
},
"firstNames": {
"type": "array",
"items": {
"type": "string"
}
},
"lastNames": {
"type": "array",
"items": {
"type": "string"
}
},
"companyHeadcountFilter": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"example": {
"searchQuery": "OpenAI recruiter",
"maxResults": 3,
"startPage": 2,
"scraperMode": "full",
"locations": [
"Amsterdam"
],
"currentCompany": [
"OpenAI"
],
"currentJobTitleFilter": [
"Recruiter"
]
}
}
}
},
"responses": {
"200": {
"description": "Search completed.",
"content": {
"application/json": {
"example": {
"session_id": "44444444-4444-4444-4444-444444444444",
"verification_type": "data_source",
"kind": "linkedin_people_search",
"scraperMode": "full",
"autoQuerySegmentation": false,
"maxItems": 3,
"startPage": 2,
"locations": [
"Amsterdam"
],
"profileScraperMode": "Full",
"recentlyChangedJobs": false,
"recentlyPostedOnLinkedIn": false,
"searchQuery": "OpenAI recruiter",
"currentCompanies": [
"OpenAI"
],
"currentJobTitles": [
"Recruiter"
],
"human": "# LinkedIn people search\n\n- **Results returned:** 3\n\n### Jane Doe\n\n- **Profile URL:** https://www.linkedin.com/in/jane-doe/\n- **First name:** Jane\n- **Last name:** Doe\n- **Title:** Recruiter\n- **Company:** OpenAI\n- **Location:** Amsterdam\n- **Summary:** Technical recruiting across research and engineering roles.",
"machine": {
"total_items": 3,
"first_item": {
"firstName": "Jane",
"lastName": "Doe",
"profileUrl": "https://www.linkedin.com/in/jane-doe/",
"headline": "Recruiter at OpenAI",
"currentCompany": "OpenAI",
"location": "Amsterdam"
},
"items": [
{
"firstName": "Jane",
"lastName": "Doe",
"profileUrl": "https://www.linkedin.com/in/jane-doe/"
}
]
},
"points_per_25_results": 100,
"points_per_profile": 5,
"total_points": 115
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"402": {
"description": "Payment Required"
},
"500": {
"description": "Internal Error"
}
}
}
},
"/functions/v1/run-linkedin-company-employee": {
"post": {
"tags": [
"Data Sources"
],
"summary": "Run LinkedIn Company Employee",
"description": "Searches LinkedIn employees for one or more companies using people-style filters.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"companies"
],
"properties": {
"companies": {
"type": "array",
"items": {
"type": "string"
}
},
"searchQuery": {
"type": "string"
},
"maxResults": {
"type": "number"
},
"startPage": {
"type": "number"
},
"scraperMode": {
"type": "string"
},
"locations": {
"type": "array",
"items": {
"type": "string"
}
},
"currentJobTitleFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"pastJobTitle": {
"type": "array",
"items": {
"type": "string"
}
},
"yearsOfExperienceFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"yearsAtCurrentCompanyFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"seniorityLevelFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"functionFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"industryIds": {
"type": "array",
"items": {
"type": "string"
}
},
"companyHeadcountFilter": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"example": {
"companies": [
"https://www.linkedin.com/company/openai/"
],
"searchQuery": "Recruiter",
"maxResults": 3,
"startPage": 2,
"scrape
# --- truncated at 32 KB (70 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/neuralverge-api/refs/heads/main/openapi/neuralverge-api-openapi.json