### Experience Schema Example (JSON) Source: https://api.tryspecter.com/api-ref/enrichment/getenrich-people This JSON object represents an example of the 'Experience' schema. It details a user's work experience, including company name, job title, dates, responsibilities, and company-related information. ```json { "company_name": "Google AI", "company_id": "5e3a7f2b0aa7a3270a55f2a8", "domain": "ai.google.com", "linkedin_url": "linkedin.com/company/google", "description": "Lead research initiatives in computer vision and deep learning.\n Developed novel architectures for image recognition that improved\n accuracy by 15%. Mentor junior researchers and collaborate with\n product teams to integrate ML models into Google products.", "company_size": "10001+", "industries": [ "Information Technology", "Software", "Artificial Intelligence", "Internet Services" ], "title": "Senior Research Scientist", "departments": [ "Senior Leadership", "Engineering" ], "start_date": "2020-03-01", "end_date": null, "location": "Mountain View, California, United States, United States", "is_current": true, "founded_year": 1998 } ``` -------------------------------- ### API 404 Not Found Response Example (OpenAPI) Source: https://api.tryspecter.com/api-ref/people-lists/modify-a-people-list Example of a 'Not Found' API response (HTTP 404), potentially indicating insufficient credits or a missing resource. Includes a sample JSON payload. ```yaml responses: '404': application/json: schemaArray: - type: object properties: errorCode: allOf: - type: string description: NOT_FOUND message: allOf: - type: string description: Not Found requiredProperties: - errorCode - message examples: example: value: errorCode: message: description: Not enough credits - API credit limit exceeded ``` -------------------------------- ### Experience Schema Source: https://api.tryspecter.com/api-ref/talent-searches/get-talent-saved-search-results Details about the Experience schema, including its properties and examples. ```APIDOC ## Experience Schema ### Description Represents a professional experience entry. ### Properties - **company_name** (string) - The name of the company or organization. Example: Google AI - **company_id** (string, nullable) - Unique identifier for the company in the system. Example: 5e3a7f2b0aa7a3270a55f2a8 - **domain** (string, nullable) - The company's website domain. Example: ai.google.com - **linkedin_url** (string, nullable) - LinkedIn URL for the company. Example: linkedin.com/company/google - **description** (string, nullable) - Details about the role, responsibilities, and achievements. Example: Lead research initiatives in computer vision and deep learning. Developed novel architectures for image recognition that improved accuracy by 15%. Mentor junior researchers and collaborate with product teams to integrate ML models into Google products. - **company_size** (string, nullable) - The size category of the company. Example: 10001+ - **industries** (array of strings, nullable) - Industries the company operates in. Example: ["Information Technology", "Software", "Artificial Intelligence", "Internet Services"] - **title** (string) - Job title or position held. Example: Senior Research Scientist - **departments** (array of strings, nullable) - Departments or teams the person worked in. Example: ["Senior Leadership", "Engineering"] - **start_date** (string, nullable) - Start date of the position. Example: '2020-03-01' - **end_date** (string, nullable) - End date of the position (null if current). Example: null - **location** (string, nullable) - Location where the work was performed. Example: Mountain View, California, United States, United States - **is_current** (boolean) - Whether this is the person's current position. ``` -------------------------------- ### Error Response Examples (JSON) Source: https://api.tryspecter.com/api-ref/enrichment/getenrich-companies Illustrates common error response structures for API requests, including validation errors, missing API keys, invalid API keys, and permission denied errors. These examples are useful for implementing robust error handling in client applications. ```json { "errorCode": "VALIDATION_ERROR", "message": "Cannot get item with no request body." } ``` ```json { "errorCode": "VALIDATION_ERROR", "message": "\"{\\\"code\\\":\\\"invalid_type\\\",\\\"expected\\\":\\\"number\\\",\\\"received\\\":\\\"string\\\",\\\"path\\\":[\\\"linkedin_id\\\"],\\\"message\\\":\\\"Expected number, received string\\\"}\"" } ``` ```json { "errorCode": "API_KEY_MISSING", "message": "No API Key was presented on the header X-API-KEY" } ``` ```json { "errorCode": "API_KEY_NOT_VALID", "message": "API key present, but not valid" } ``` ```json { "errorCode": "NOT_PERMITTED", "message": "You do not have permission to access this resource." } ``` -------------------------------- ### OpenAPI Specification for Talent Search Results Source: https://api.tryspecter.com/api-ref/talent-searches/get-talent-saved-search-results This OpenAPI specification defines the GET /searches/talent/{searchId}/results endpoint. It details the request parameters (path, query, header, cookie, body), security requirements (ApiKeyAuth), and the structure of the 200 OK response, including an example of the talent data. ```yaml api-ref/bundle_api.yaml get /searches/talent/{searchId}/results paths: path: /searches/talent/{searchId}/results method: get servers: - url: https://app.tryspecter.com/api/v1 description: Production request: security: - title: ApiKeyAuth parameters: query: {} header: X-API-Key: type: apiKey cookie: {} parameters: path: searchId: schema: - type: string required: true description: The search ID that is being queried for. query: limit: schema: - type: number required: false description: The number of results to return, default is 25. page: schema: - type: number required: false description: The page number of results to return, base 0, default is 0. header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: array items: allOf: - $ref: '#/components/schemas/Talent' examples: example: value: - talent_signal_id: 02d32673-f1ab-40a1-93c5-a3a36a10d342 person_id: per_7f8d9e2a1b3c4d5e6f7g8h9i0 signal_date: '2018-03-15' signal_score: 9 signal_type: New Company signal_status: Stealth out_of_stealth_advantage: 6 announcement_delay_months: 3 talent_last_signal: true new_position_title: Founder & CEO new_position_company_id: 5e3a7f2b0aa7a3270a55f2b9 new_position_company_name: VisionAI new_position_company_website: visionai.com new_position_company_tagline: Computer vision AI platform for enterprise applications past_position_company_id: 5e3a7f2b0aa7a3270a55f2a8 talent_signal_ids: - 02d32673-f1ab-40a1-93c5-a3a36a10d342 investor_signal_ids: - 0340bac8-bcee-46a2-94bf-cf77e0c34253 profile_picture_url: >- https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_7f8d9e2a1b3c4d5e6f7g8h9i0.jpg first_name: Sarah last_name: Chen full_name: Sarah Chen linkedin_url: https://www.linkedin.com/in/sarahchen9776 twitter_url: https://twitter.com/sarahchen9776 github_url: https://github.com/sarahchen9776 about: >- AI/ML researcher and entrepreneur with a focus on computer vision applications. Previously led ML teams at Google and founded an AI startup. tagline: >- AI Researcher | Ex-Google | Founder of VisionAI (Acquired by NVIDIA) location: San Francisco, California, United States, North America region: North America highlights: - prior_exit - prior_vc_backed_experience - prior_vc_backed_founder - serial_founder level_of_seniority: Executive Level years_of_experience: 12 education_level: Ph.D. experience: company_name: Google AI company_id: 5e3a7f2b0aa7a3270a55f2a8 domain: ai.google.com linkedin_url: linkedin.com/company/google description: >- Lead research initiatives in computer vision and deep learning. Developed novel architectures for image recognition that improved accuracy by 15%. Mentor junior researchers and collaborate with product teams to integrate ML models into Google products. company_size: 10001+ industries: - Information Technology - Software - Artificial Intelligence - Internet Services title: Senior Research Scientist departments: - Senior Leadership - Engineering start_date: '2020-03-01' end_date: null location: Mountain View, California, United States, United States is_current: true founded_year: 1998 job_order: 3 past_position_title: Founder & CEO past_position_company_name: VisionAI past_position_company_website: visionai.com current_tenure: 3 average_tenure: 18 ``` -------------------------------- ### Get Company List Results - OpenAPI Specification Source: https://api.tryspecter.com/api-ref/companies-lists/get-company-list-results This YAML snippet defines the OpenAPI specification for the GET /lists/companies/{listId}/results endpoint. It includes server details, security schemes (API Key authentication), request parameters (query parameters like newGrowthHighlights, newFundingHighlights, limit, and page), and a detailed example of the 200 OK response body, which is an array of Company objects. ```yaml paths: path: /lists/companies/{listId}/results method: get servers: - url: https://app.tryspecter.com/api/v1 description: Production request: security: - title: ApiKeyAuth parameters: query: {} header: X-API-Key: type: apiKey cookie: {} parameters: path: {} query: newGrowthHighlights: schema: - type: boolean required: false description: > Tells the results to have only companies with new growth highlights. newFundingHighlights: schema: - type: boolean required: false description: > Tells the results to have only companies with new funding highlights. limit: schema: - type: number required: false description: The number of results to return, default is 25. page: schema: - type: number required: false description: The page number of results to return, base 0, default is 0. header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: array items: allOf: - $ref: '#/components/schemas/Company' examples: example: value: - id: 1a2b3c4d5e6g1a2b3c4d5e6g organization_name: Hedgehog Analytics organization_rank: 1258 organization_name_aliases: Porcupine Analytics primary_role: company roles: - company description: >- Hedgehog Analytics is a data-driven company specializing in B2C sales across North America. tagline: Hedgehog Analytics future data-driven sales company. customer_focus: b2c certifications: - - HIPPA - GDPR - SOC 2 - B Corp - ISO 27001 customer_profile: >- Small to medium business wanted to expand and improve their sales pipelines. traction_highlights: “5 million monthly unique users” reported_clients: - - 3a1b3c4d5e4g1a4453c4d5e3a - 2a4b3c6d75efg132b3c4d5e2f last_updated: '2025-01-01' tags: - SaaS - Data Analytics industries: - Data and Analytics - DeepTech - Information Technology - Software sub_industries: - Analytics - Open Source - Software operating_status: active logo_url: >- https://specter-company-logo.s3.amazonaws.com/hedgehog_analytics.jpeg highlights: - headcount_surge - no_recent_funding - strong_headcount_growth - strong_social_growth - strong_web_traffic_growth - top_tier_investors new_highlights: - headcount_surge - strong_headcount_growth - strong_social_growth - strong_web_traffic_growth - top_tier_investors regions: - Europe founded_year: 2019 founders: - Sam Specter - Arthur Miller founder_info: - specter_person_id: per_7f8d9e2a1b3c4d5e6f7g8h9i0 full_name: Sarah Chen title: Co-Founder & CTO departments: - Senior Leadership seniority: Executive Level founder_count: 2 employee_count: 39 employee_count_range: 1-10 revenue_estimate_usd: 50000 investors: - YCombinator investor_count: 1 patent_count: 5 trademark_count: 2 website: domain: hedgehog_analytics.com url: https://www.hedgehog_analytics.com domain_aliases: - hh_analytics.com - hedgehoganalytics.com hq: city: London state: England country: United Kingdom region: Europe contact: ``` -------------------------------- ### Get Talent Lists - OpenAPI Specification (YAML) Source: https://api.tryspecter.com/api-ref/talent-lists/get-all-talent-lists This YAML snippet defines the OpenAPI specification for the GET /lists/talent endpoint. It includes details about the server URL, request parameters (API key authentication), response schemas for success (200 OK) and various error codes (401, 403, 429), along with example payloads. ```yaml paths: path: /lists/talent method: get servers: - url: https://app.tryspecter.com/api/v1 description: Production request: security: - title: ApiKeyAuth parameters: query: {} header: X-API-Key: type: apiKey cookie: {} parameters: path: {} query: {} header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: array items: allOf: - properties: id: description: List Id type: string example: b73c8bed-3b92-48f9-a879-40ee114dca03 name: description: Name of the list type: string example: Favourites created_at: description: Date list was created type: string format: date-time example: '2024-11-14T10:36:12.625Z' updated_at: description: Date the list was last updated type: string format: date-time example: '2024-11-14T10:36:12.625Z' is_global: description: This flags lists recommended by Specter for all users type: boolean example: false talent_count: description: The number of talent signals in this list type: number example: 10 shared_with: description: The user ids of the users this list is shared with type: array items: description: User Id type: string example: user_2PFJ2V8IR837k6TPguVCIFhNsWA examples: example: value: - id: b73c8bed-3b92-48f9-a879-40ee114dca03 name: Favourites created_at: '2024-11-14T10:36:12.625Z' updated_at: '2024-11-14T10:36:12.625Z' is_global: false talent_count: 10 shared_with: - user_2PFJ2V8IR837k6TPguVCIFhNsWA description: The talent signals lists '401': application/json: schemaArray: - type: object properties: errorCode: allOf: - description: API_KEY_MISSING example: API_KEY_MISSING type: string message: allOf: - description: No API Key was presented on the header X-API-KEY example: No API Key was presented on the header X-API-KEY type: string refIdentifier: '#/components/schemas/ApiKeyMissing' - type: object properties: errorCode: allOf: - description: API_KEY_NOT_VALID example: API_KEY_NOT_VALID type: string message: allOf: - description: API key present, but not valid example: API key present, but not valid type: string refIdentifier: '#/components/schemas/ApiKeyNotValid' examples: example: value: errorCode: API_KEY_MISSING message: No API Key was presented on the header X-API-KEY description: Unauthorized '403': application/json: schemaArray: - type: object properties: errorCode: allOf: - description: NOT_PERMITTED type: string example: NOT_PERMITTED message: allOf: - type: string description: You do not have permission to access this resource. example: You do not have permission to access this resource. requiredProperties: - errorCode - message examples: example: value: errorCode: NOT_PERMITTED message: You do not have permission to access this resource. description: Forbidden - There is no permissions to use the endpoint '429': application/json: schemaArray: - type: object properties: errorCode: allOf: - type: string description: RATE_LIMITED message: allOf: ``` -------------------------------- ### API 401 Unauthorized Response Example (OpenAPI) Source: https://api.tryspecter.com/api-ref/people-lists/modify-a-people-list Example of an unauthorized API response (HTTP 401) indicating an API key issue. It includes a sample JSON payload with 'errorCode' and 'message' fields. ```yaml responses: '401': application/json: schemaArray: - type: object properties: errorCode: allOf: - description: API_KEY_MISSING example: API_KEY_MISSING type: string message: allOf: - description: API key was not presented on the HTTP header X-API-KEY example: API key was not presented on the HTTP header X-API-KEY type: string examples: example: value: errorCode: API_KEY_MISSING message: No API Key was presented on the header X-API-KEY description: Unauthorized ``` -------------------------------- ### GET /lists/companies/{listId}/results Source: https://api.tryspecter.com/api-ref/companies-lists/get-company-list-results Fetches a paginated list of companies with optional highlights and limits. ```APIDOC ## GET /lists/companies/{listId}/results ### Description Retrieves a list of companies. You can filter results to include only companies with new growth or new funding highlights, and specify the number of results and the page number. ### Method GET ### Endpoint https://app.tryspecter.com/api/v1/lists/companies/{listId}/results ### Parameters #### Path Parameters - **listId** (string) - Required - The ID of the list to retrieve results from. #### Query Parameters - **newGrowthHighlights** (boolean) - Optional - If true, only return companies with new growth highlights. - **newFundingHighlights** (boolean) - Optional - If true, only return companies with new funding highlights. - **limit** (number) - Optional - The number of results to return. Defaults to 25. - **page** (number) - Optional - The page number of results to return. Base 0, defaults to 0. ### Request Example ```json { "example": "" } ``` ### Response #### Success Response (200) - **id** (string) - The unique identifier for the company. - **organization_name** (string) - The name of the organization. - **organization_rank** (number) - The rank of the organization. - **organization_name_aliases** (string) - Aliases for the organization's name. - **primary_role** (string) - The primary role of the organization. - **roles** (array of strings) - A list of roles associated with the organization. - **description** (string) - A description of the organization. - **tagline** (string) - The tagline of the organization. - **customer_focus** (string) - The primary customer focus of the organization. - **certifications** (array of arrays) - A list of certifications held by the organization. - **customer_profile** (string) - The profile of the organization's customers. - **traction_highlights** (string) - Key traction highlights of the organization. - **reported_clients** (array of arrays) - A list of reported clients. - **last_updated** (string) - The last updated date of the company information. - **tags** (array of strings) - Tags associated with the company. - **industries** (array of strings) - Industries the company operates in. - **sub_industries** (array of strings) - Sub-industries the company operates in. - **operating_status** (string) - The current operating status of the company. - **logo_url** (string) - URL to the company's logo. - **highlights** (array of strings) - General highlights of the company. - **new_highlights** (array of strings) - New highlights for the company. - **regions** (array of strings) - Regions where the company operates. - **founded_year** (number) - The year the company was founded. - **founders** (array of strings) - Names of the company founders. - **founder_info** (array of objects) - Detailed information about founders. - **founder_count** (number) - The number of founders. - **employee_count** (number) - The number of employees. - **employee_count_range** (string) - The range of the employee count. - **revenue_estimate_usd** (number) - Estimated revenue in USD. - **investors** (array of strings) - List of investors. - **investor_count** (number) - The number of investors. - **patent_count** (number) - The number of patents held. - **trademark_count** (number) - The number of trademarks held. - **website** (object) - Website details. - **hq** (object) - Headquarters information. - **contact** (object) - Contact information. #### Response Example ```json { "example": [ { "id": "1a2b3c4d5e6g1a2b3c4d5e6g", "organization_name": "Hedgehog Analytics", "organization_rank": 1258, "organization_name_aliases": "Porcupine Analytics", "primary_role": "company", "roles": [ "company" ], "description": "Hedgehog Analytics is a data-driven company specializing in B2C sales across North America.", "tagline": "Hedgehog Analytics future data-driven sales company.", "customer_focus": "b2c", "certifications": [ [ "HIPPA", "GDPR", "SOC 2", "B Corp", "ISO 27001" ] ], "customer_profile": "Small to medium business wanted to expand and improve their sales pipelines.", "traction_highlights": "5 million monthly unique users", "reported_clients": [ [ "3a1b3c4d5e4g1a4453c4d5e3a", "2a4b3c6d75efg132b3c4d5e2f" ] ], "last_updated": "2025-01-01", "tags": [ "SaaS", "Data Analytics" ], "industries": [ "Data and Analytics", "DeepTech", "Information Technology", "Software" ], "sub_industries": [ "Analytics", "Open Source", "Software" ], "operating_status": "active", "logo_url": "https://specter-company-logo.s3.amazonaws.com/hedgehog_analytics.jpeg", "highlights": [ "headcount_surge", "no_recent_funding", "strong_headcount_growth", "strong_social_growth", "strong_web_traffic_growth", "top_tier_investors" ], "new_highlights": [ "headcount_surge", "strong_headcount_growth", "strong_social_growth", "strong_web_traffic_growth", "top_tier_investors" ], "regions": [ "Europe" ], "founded_year": 2019, "founders": [ "Sam Specter", "Arthur Miller" ], "founder_info": [ { "specter_person_id": "per_7f8d9e2a1b3c4d5e6f7g8h9i0", "full_name": "Sarah Chen", "title": "Co-Founder & CTO", "departments": [ "Senior Leadership" ], "seniority": "Executive Level" } ], "founder_count": 2, "employee_count": 39, "employee_count_range": "1-10", "revenue_estimate_usd": 50000, "investors": [ "YCombinator" ], "investor_count": 1, "patent_count": 5, "trademark_count": 2, "website": { "domain": "hedgehog_analytics.com", "url": "https://www.hedgehog_analytics.com", "domain_aliases": [ "hh_analytics.com", "hedgehoganalytics.com" ] }, "hq": { "city": "London", "state": "England", "country": "United Kingdom", "region": "Europe" }, "contact": {} } ] } ``` ``` -------------------------------- ### Get Similar Companies - OpenAPI Specification Source: https://api.tryspecter.com/api-ref/companies/get-similar-companies This OpenAPI specification defines the `/companies/{companyId}/similar` endpoint for the TrySpecter API. It details the GET request method, authentication requirements (API Key), path and query parameters (companyId, growth_stage, limit), and possible response schemas for successful retrieval (200) and various error conditions (400, 401, 403, 404, 429). ```yaml paths: path: /companies/{companyId}/similar method: get servers: - url: https://app.tryspecter.com/api/v1 description: Production request: security: - title: ApiKeyAuth parameters: query: {} header: X-API-Key: type: apiKey cookie: {} parameters: path: companyId: schema: - type: string required: true description: The ID of the company being requested query: growth_stage: schema: - type: array items: allOf: - type: string enum: - no_funding - seed - early - growing - late - exit required: false description: | Filters the growth stage of similar companies. limit: schema: - type: number required: false description: | Sets the limit on the number of results, maximum value is 100 header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: array items: allOf: - type: string example: 5e3a7f2b0aa7a3270a55f2a7 examples: example: value: - 5e3a7f2b0aa7a3270a55f2a7 description: The list of companies IDs '400': application/json: schemaArray: - type: object properties: errorCode: allOf: - type: string description: VALIDATION_ERROR example: VALIDATION_ERROR message: allOf: - type: string description: Cannot request more than 100 similar companies. example: Cannot request more than 100 similar companies. examples: example: value: errorCode: VALIDATION_ERROR message: Cannot request more than 100 similar companies. description: BadRequest '401': application/json: schemaArray: - type: object properties: errorCode: allOf: - description: API_KEY_MISSING example: API_KEY_MISSING type: string message: allOf: - description: No API Key was presented on the header X-API-KEY example: No API Key was presented on the header X-API-KEY type: string refIdentifier: '#/components/schemas/ApiKeyMissing' - type: object properties: errorCode: allOf: - description: API_KEY_NOT_VALID example: API_KEY_NOT_VALID type: string message: allOf: - description: API key present, but not valid example: API key present, but not valid type: string refIdentifier: '#/components/schemas/ApiKeyNotValid' examples: example: value: errorCode: API_KEY_MISSING message: No API Key was presented on the header X-API-KEY description: Unauthorized '403': application/json: schemaArray: - type: object properties: errorCode: allOf: - description: NOT_PERMITTED type: string example: NOT_PERMITTED message: allOf: - type: string description: You do not have permission to access this resource. example: You do not have permission to access this resource. requiredProperties: - errorCode - message examples: example: value: errorCode: NOT_PERMITTED message: You do not have permission to access this resource. description: Forbidden - There is no permissions to use the endpoint '404': _mintlify/placeholder: schemaArray: - type: any description: The company does not exist examples: {} description: The company does not exist '429': application/json: schemaArray: - type: object properties: errorCode: allOf: - type: string enum: - RATE_LIMITED ``` -------------------------------- ### Get Talent List Results - OpenAPI Specification Source: https://api.tryspecter.com/api-ref/talent-lists/get-talent-list-results This OpenAPI specification defines the GET endpoint for retrieving talent list results. It includes details on the API server URL, authentication methods (API Key), request parameters (path and query), and the structure of the successful JSON response, along with an example. ```yaml paths: path: /lists/talent/{listId}/results method: get servers: - url: https://app.tryspecter.com/api/v1 description: Production request: security: - title: ApiKeyAuth parameters: query: {} header: X-API-Key: type: apiKey cookie: {} parameters: path: listId: schema: - type: string required: true description: The UUID of the list being requested format: uuid query: limit: schema: - type: number required: false description: The number of results to return, default is 25. page: schema: - type: number required: false description: The page number of results to return, base 0, default is 0. header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: array items: allOf: - $ref: '#/components/schemas/Talent' examples: example: value: - talent_signal_id: 02d32673-f1ab-40a1-93c5-a3a36a10d342 person_id: per_7f8d9e2a1b3c4d5e6f7g8h9i0 signal_date: '2018-03-15' signal_score: 9 signal_type: New Company signal_status: Stealth out_of_stealth_advantage: 6 announcement_delay_months: 3 talent_last_signal: true new_position_title: Founder & CEO new_position_company_id: 5e3a7f2b0aa7a3270a55f2b9 new_position_company_name: VisionAI new_position_company_website: visionai.com new_position_company_tagline: Computer vision AI platform for enterprise applications past_position_company_id: 5e3a7f2b0aa7a3270a55f2a8 talent_signal_ids: - 02d32673-f1ab-40a1-93c5-a3a36a10d342 investor_signal_ids: - 0340bac8-bcee-46a2-94bf-cf77e0c34253 profile_picture_url: >- https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_7f8d9e2a1b3c4d5e6f7g8h9i0.jpg first_name: Sarah last_name: Chen full_name: Sarah Chen linkedin_url: https://www.linkedin.com/in/sarahchen9776 twitter_url: https://twitter.com/sarahchen9776 github_url: https://github.com/sarahchen9776 about: >- AI/ML researcher and entrepreneur with a focus on computer vision applications. Previously led ML teams at Google and founded an AI startup. tagline: >- AI Researcher | Ex-Google | Founder of VisionAI (Acquired by NVIDIA) location: San Francisco, California, United States, North America region: North America highlights: - prior_exit - prior_vc_backed_experience - prior_vc_backed_founder - serial_founder level_of_seniority: Executive Level years_of_experience: 12 education_level: Ph.D. experience: company_name: Google AI company_id: 5e3a7f2b0aa7a3270a55f2a8 domain: ai.google.com linkedin_url: linkedin.com/company/google description: >- Lead research initiatives in computer vision and deep learning. Developed novel architectures for image recognition that improved accuracy by 15%. Mentor junior researchers and collaborate with product teams to integrate ML models into Google products. company_size: 10001+ industries: - Information Technology - Software - Artificial Intelligence - Internet Services title: Senior Research Scientist departments: - Senior Leadership - Engineering start_date: '2020-03-01' end_date: null location: Mountain View, California, United States, United States is_current: true founded_year: 1998 job_order: 3 past_position_title: Founder & CEO past_position_company_name: VisionAI past_position_company_website: visionai.com current_tenure: 3 ``` -------------------------------- ### Create a List via API Source: https://api.tryspecter.com/api-ref/lists_and_searches Endpoints for creating new lists for Companies, People, and Talent Signals via the API. Lists created this way are automatically shared with the API. ```APIDOC ## Create a list via the API * You can create lists using the **POST endpoints** for each product type: [**Companies**](https://api.tryspecter.com/api-ref/companies-lists/create-a-new-company-list), [**People**](https://api.tryspecter.com/api-ref/people-lists/create-a-new-people-list), and [**Talent Signals.**](https://api.tryspecter.com/api-ref/talent-lists/create-a-new-talent-list) (These will be automatically shared with the API) * **Ownership:** When a list is created via the API, it is owned by the **first team admin** in your organization. ``` -------------------------------- ### Experience Schema Example Source: https://api.tryspecter.com/api-ref/people-lists/get-people-list-results Illustrates the data structure for an 'Experience' object, commonly used in API responses to represent professional experience. Includes fields for company name, ID, domain, and LinkedIn URL. ```json { "company_name": "Google AI", "company_id": "5e3a7f2b0aa7a3270a55f2a8", "domain": "ai.google.com", "linkedin_url": "" } ``` -------------------------------- ### Company Search Results (YAML) Source: https://api.tryspecter.com/api-ref/company-searches/get-company-saved-search-results This OpenAPI specification defines the GET endpoint for retrieving company search results. It details the path parameters, query parameters for filtering results (e.g., new data, growth highlights, funding highlights, pagination), and the structure of the JSON response, including a comprehensive example of a company object. ```yaml paths: path: /searches/companies/{searchId}/results method: get servers: - url: https://app.tryspecter.com/api/v1 description: Production request: security: - title: ApiKeyAuth parameters: query: {} header: X-API-Key: type: apiKey cookie: {} parameters: path: searchId: schema: - type: string required: true description: The search ID that is being queried for. query: new: schema: - type: boolean required: false description: | Tells the results to have only new data since the last delivery. Note: Applies only to company searches newGrowthHighlights: schema: - type: boolean required: false description: > Tells the results to have only companies with new growth highlights. newFundingHighlights: schema: - type: boolean required: false description: > Tells the results to have only companies with new funding highlights. limit: schema: - type: number required: false description: The number of results to return, default is 25. page: schema: - type: number required: false description: The page number of results to return, base 0, default is 0. header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: array items: allOf: - $ref: '#/components/schemas/Company' examples: example: value: - id: 1a2b3c4d5e6g1a2b3c4d5e6g organization_name: Hedgehog Analytics organization_rank: 1258 organization_name_aliases: Porcupine Analytics primary_role: company roles: - company description: >- Hedgehog Analytics is a data-driven company specializing in B2C sales across North America. tagline: Hedgehog Analytics future data-driven sales company. customer_focus: b2c certifications: - - HIPPA - GDPR - SOC 2 - B Corp - ISO 27001 customer_profile: >- Small to medium business wanted to expand and improve their sales pipelines. traction_highlights: “5 million monthly unique users” reported_clients: - - 3a1b3c4d5e4g1a4453c4d5e3a - 2a4b3c6d75efg132b3c4d5e2f last_updated: '2025-01-01' tags: - SaaS - Data Analytics industries: - Data and Analytics - DeepTech - Information Technology - Software sub_industries: - Analytics - Open Source - Software operating_status: active logo_url: >- https://specter-company-logo.s3.amazonaws.com/hedgehog_analytics.jpeg highlights: - headcount_surge - no_recent_funding - strong_headcount_growth - strong_social_growth - strong_web_traffic_growth - top_tier_investors new_highlights: - headcount_surge - strong_headcount_growth - strong_social_growth - strong_web_traffic_growth - top_tier_investors regions: - Europe founded_year: 2019 founders: - Sam Specter - Arthur Miller founder_info: - specter_person_id: per_7f8d9e2a1b3c4d5e6f7g8h9i0 full_name: Sarah Chen title: Co-Founder & CTO departments: - Senior Leadership seniority: Executive Level founder_count: 2 employee_count: 39 employee_count_range: 1-10 revenue_estimate_usd: 50000 investors: - YCombinator investor_count: 1 patent_count: 5 trademark_count: 2 website: ``` -------------------------------- ### API 403 Forbidden Response Example (OpenAPI) Source: https://api.tryspecter.com/api-ref/people-lists/modify-a-people-list Example of a forbidden API response (HTTP 403) when a user lacks permissions. It provides a sample JSON payload with 'errorCode' and 'message' fields. ```yaml responses: '403': application/json: schemaArray: - type: object properties: errorCode: allOf: - description: NOT_PERMITTED type: string example: NOT_PERMITTED message: allOf: - type: string description: You do not have permission to access this resource. example: You do not have permission to access this resource. requiredProperties: - errorCode - message examples: example: value: errorCode: NOT_PERMITTED message: You do not have permission to access this resource. description: Forbidden - There is no permissions to use the endpoint ```