{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } }, "schemas": { "Manual576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA": { "type": "object", "required": [ "requests" ], "properties": { "requests": { "type": "array", "items": { "type": "object", "required": [ "params" ], "properties": { "params": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "Apple Inc.", "Google LLC" ], "description": "Company name to search for. At least one of pdl_id/name/profile/ticker/website must be provided." }, "pdl_id": { "type": "string", "examples": [ "qfVEk4GNmw03Pln1TfV9xA_0000" ], "description": "People Data Labs unique ID for a company. At least one of pdl_id/name/profile/ticker/website must be provided." }, "region": { "type": "string", "examples": [ "California", "New York" ], "description": "The state, province, or administrative region where the company is located." }, "ticker": { "type": "string", "examples": [ "AAPL", "MSFT" ], "description": "Stock market ticker symbol. At least one of pdl_id/name/profile/ticker/website must be provided." }, "country": { "type": "string", "examples": [ "USA", "United Kingdom", "FR" ], "description": "The country where the company is located. Can be a full name or an ISO country code." }, "profile": { "type": "string", "examples": [ "linkedin.com/company/google", "crunchbase.com/organization/facebook" ], "description": "Company social media profile URL. At least one of pdl_id/name/profile/ticker/website must be provided." }, "website": { "type": "string", "examples": [ "www.apple.com", "about.google" ], "description": "Company website URL. At least one of pdl_id/name/profile/ticker/website must be provided." }, "locality": { "type": "string", "examples": [ "Cupertino", "New York City" ], "description": "The city or locality where the company is situated." }, "location": { "type": "string", "examples": [ "San Francisco, CA", "London, UK" ], "description": "A general text query for the company's location (e.g., 'San Francisco, CA' or 'London')." }, "postal_code": { "type": "string", "examples": [ "95014", "94043" ], "description": "The postal or ZIP code for the company's location." }, "street_address": { "type": "string", "examples": [ "1 Apple Park Way", "1600 Amphitheatre Parkway" ], "description": "The street address component of the company's location." } }, "description": "Parameters for this individual company enrichment request. Must include at least one identifier (pdl_id, name, profile, ticker, or website).", "additionalProperties": false } }, "description": "A single request item in the bulk company enrichment array." }, "examples": [ [ { "params": { "website": "google.com" } }, { "params": { "website": "microsoft.com" } } ] ], "maxItems": 100, "minItems": 1, "description": "Array of 1-100 individual company enrichment requests. Each request must contain a params object with at least one company identifier." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA__output__7084e086e2277b03" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA__output__7084e086e2277b03": { "type": "object", "required": [ "results" ], "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA__output__33fd9cbe7e71cdba" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA__output__33fd9cbe7e71cdba": { "type": "object", "required": [ "status" ], "properties": { "data": { "type": "object", "additionalProperties": true }, "status": { "type": "integer" }, "likelihood": { "type": "integer" } } }, "Manual576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA": { "type": "object", "required": [ "requests" ], "properties": { "requests": { "type": "array", "items": { "type": "object", "required": [ "params" ], "properties": { "params": { "type": "object", "properties": { "lid": { "type": "string", "examples": [ "123456789" ], "description": "LinkedIn ID." }, "name": { "type": "string", "examples": [ "John Michael Doe" ], "description": "Full name." }, "email": { "type": "string", "examples": [ "john.doe@example.com" ], "description": "Email address." }, "phone": { "type": "string", "examples": [ "+14155552671" ], "description": "Phone number; E.164 format recommended." }, "pdl_id": { "type": "string", "examples": [ "qEnxS5T1G2YvasA1x24qoA_0000" ], "description": "People Data Labs unique record ID." }, "region": { "type": "string", "examples": [ "CA" ], "description": "State, province, or region of residence." }, "school": { "type": "string", "examples": [ "Stanford University" ], "description": "School name attended." }, "company": { "type": "string", "examples": [ "Acme Corporation" ], "description": "Company name where person has worked." }, "country": { "type": "string", "examples": [ "US", "United States" ], "description": "Country of residence (ISO 3166-1 alpha-2 code or full name)." }, "profile": { "type": "string", "examples": [ "https://www.linkedin.com/in/john-doe", "https://www.facebook.com/jane.doe" ], "description": "Social profile URL (e.g., LinkedIn, Facebook)." }, "locality": { "type": "string", "examples": [ "San Francisco" ], "description": "City or locality of residence." }, "location": { "type": "string", "examples": [ "San Francisco, CA, USA" ], "description": "General location (e.g., city, state, country)." }, "required": { "type": "string", "examples": [ "emails AND phone_numbers", "education AND (emails OR phone_numbers)", "job_title AND job_company_name" ], "description": "Boolean expression of top-level fields required in enriched profile for match. Use AND/OR operators and parentheses for logic (e.g., 'emails AND phone_numbers', 'education AND (emails OR phone_numbers)')." }, "last_name": { "type": "string", "examples": [ "Doe" ], "description": "Last name." }, "birth_date": { "type": "string", "examples": [ "1990-01-15" ], "description": "Birth date (YYYY-MM-DD format)." }, "email_hash": { "type": "string", "examples": [ "d41d8cd98f00b204e9800998ecf8427e", "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" ], "description": "SHA-256 or MD5 hash of an email, for matching without exposing the raw email." }, "first_name": { "type": "string", "examples": [ "John" ], "description": "First name." }, "postal_code": { "type": "string", "examples": [ "94107" ], "description": "Postal or ZIP code of residence." }, "data_include": { "type": "string", "examples": [ "emails,phones,profiles", "jobs,education" ], "description": "Comma-separated data fields to include in response (e.g., 'emails,phones'). Refer to People Data Labs docs for all fields." }, "min_likelihood": { "type": "integer", "maximum": 10, "minimum": 0, "examples": [ 0, 5, 10 ], "description": "Minimum confidence score (0-10) for a match to be returned; higher is stricter." }, "street_address": { "type": "string", "examples": [ "123 Main St" ], "description": "Street address." } }, "description": "Parameters for single person enrichment. Must include at least one identifier (profile, email, phone, etc.) or name with additional demographic data.", "additionalProperties": false }, "metadata": { "type": "object", "description": "Optional metadata to include in the response for this request. Can be used to track individual requests in the bulk response.", "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "description": "A single enrichment request within the bulk request array." }, "maxItems": 100, "minItems": 1, "description": "Array of 1-100 individual enrichment requests, each containing a 'params' object with person identifiers." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__a903f1c082faf2a6" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__a903f1c082faf2a6": { "type": "object", "required": [ "results" ], "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__9cc3473c202fd363" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__9cc3473c202fd363": { "type": "object", "required": [ "status" ], "properties": { "data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__801a7bed5bd96761" }, "status": { "type": "integer" }, "metadata": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "likelihood": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__801a7bed5bd96761": { "type": "object", "properties": { "id": { "type": "string" }, "sex": { "type": "string" }, "emails": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__52b88ac1067d4130" } } ] }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__4b08c5750b3b38c4" } }, "skills": { "type": "array", "items": { "type": "string" } }, "regions": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "summary": { "type": "string" }, "headline": { "type": "string" }, "industry": { "type": "string" }, "profiles": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__c09b76b3bd3d0fa9" } }, "countries": { "type": "array", "items": { "type": "string" } }, "education": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__599b93efe16611a5" } }, "full_name": { "type": "string" }, "interests": { "type": "array", "items": { "type": "string" } }, "job_title": { "type": "string" }, "languages": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__bc978d1b46ca644d" } }, "last_name": { "type": "string" }, "last_seen": { "type": "string" }, "birth_date": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "birth_year": { "anyOf": [ { "type": "boolean" }, { "type": "integer" } ] }, "experience": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__2d7f961eac09b920" } }, "first_name": { "type": "string" }, "first_seen": { "type": "string" }, "github_url": { "type": "string" }, "work_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "facebook_id": { "type": "string" }, "job_history": { "type": "array", "items": {} }, "job_summary": { "type": "string" }, "linkedin_id": { "type": "string" }, "middle_name": { "type": "string" }, "num_records": { "type": "integer" }, "num_sources": { "type": "integer" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "last_initial": { "type": "string" }, "linkedin_url": { "type": "string" }, "location_geo": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "mobile_phone": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "name_aliases": { "type": "array", "items": { "type": "string" } }, "first_initial": { "type": "string" }, "job_onet_code": { "type": "string" }, "location_name": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "phone_numbers": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "certifications": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__e96325452eab319c" } }, "job_company_id": { "type": "string" }, "job_start_date": { "type": "string" }, "job_title_role": { "type": "string" }, "location_metro": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "location_names": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "middle_initial": { "type": "string" }, "dataset_version": { "type": "string" }, "github_username": { "type": "string" }, "inferred_salary": { "type": "string" }, "job_title_class": { "type": "string" }, "location_region": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "personal_emails": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "possible_emails": { "type": "array", "items": {} }, "possible_phones": { "type": "array", "items": {} }, "facebook_friends": { "type": "integer" }, "job_company_name": { "type": "string" }, "job_company_size": { "type": "string" }, "job_company_type": { "type": "string" }, "job_last_changed": { "type": "string" }, "job_title_levels": { "type": "array", "items": { "type": "string" } }, "location_country": { "type": "string" }, "street_addresses": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__dcb5667b12edf989" } } ] }, "twitter_username": { "type": "string" }, "facebook_username": { "type": "string" }, "job_last_verified": { "type": "string" }, "linkedin_username": { "type": "string" }, "location_locality": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "possible_profiles": { "type": "array", "items": {} }, "job_company_ticker": { "type": "string" }, "job_title_sub_role": { "type": "string" }, "location_continent": { "type": "string" }, "job_company_founded": { "type": "integer" }, "job_company_website": { "type": "string" }, "job_company_industry": { "type": "string" }, "job_onet_major_group": { "type": "string" }, "job_onet_minor_group": { "type": "string" }, "linkedin_connections": { "type": "integer" }, "location_postal_code": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "possible_birth_dates": { "type": "array", "items": { "type": "string" } }, "location_last_updated": { "type": "string" }, "job_company_industry_v2": { "type": "string" }, "job_company_linkedin_id": { "type": "string" }, "job_company_twitter_url": { "type": "string" }, "location_address_line_2": { "type": "string" }, "location_street_address": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "possible_location_names": { "type": "array", "items": { "type": "string" } }, "job_company_facebook_url": { "type": "string" }, "job_company_linkedin_url": { "type": "string" }, "job_company_location_geo": { "type": "string" }, "inferred_years_experience": { "type": "integer" }, "job_company_location_name": { "type": "string" }, "job_onet_broad_occupation": { "type": "string" }, "possible_street_addresses": { "type": "array", "items": {} }, "job_company_employee_count": { "type": "integer" }, "job_company_location_metro": { "type": "string" }, "recommended_personal_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_company_location_region": { "type": "string" }, "job_company_inferred_revenue": { "type": "string" }, "job_company_location_country": { "type": "string" }, "job_onet_specific_occupation": { "type": "string" }, "job_company_location_locality": { "type": "string" }, "job_company_location_continent": { "type": "string" }, "job_company_location_postal_code": { "type": "string" }, "job_company_total_funding_raised": { "type": "integer" }, "job_company_location_address_line_2": { "type": "string" }, "job_company_location_street_address": { "type": "string" }, "job_onet_specific_occupation_detail": { "type": "string" }, "job_company_12mo_employee_growth_rate": { "type": "number" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__52b88ac1067d4130": { "type": "object", "properties": { "type": { "type": "string" }, "address": { "type": "string" }, "md5_hash": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" }, "sha_256_hash": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__4b08c5750b3b38c4": { "type": "object", "properties": { "number": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__c09b76b3bd3d0fa9": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "network": { "type": "string" }, "username": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__599b93efe16611a5": { "type": "object", "properties": { "gpa": { "type": "number" }, "raw": { "type": "array", "items": { "type": "string" } }, "majors": { "type": "array", "items": { "type": "string" } }, "minors": { "type": "array", "items": { "type": "string" } }, "school": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__9cb4ca9b3fb6f2eb" }, "degrees": { "type": "array", "items": { "type": "string" } }, "summary": { "type": "string" }, "end_date": { "type": "string" }, "start_date": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__9cb4ca9b3fb6f2eb": { "type": "object", "properties": { "id": { "type": "string" }, "raw": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "type": { "type": "string" }, "domain": { "type": "string" }, "website": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__0b1549661314d92d" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__0b1549661314d92d": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__bc978d1b46ca644d": { "type": "object", "properties": { "name": { "type": "string" }, "proficiency": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__2d7f961eac09b920": { "type": "object", "properties": { "title": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__da280d167e6b8aed" }, "company": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__74fd576ca6841cee" }, "summary": { "type": "string" }, "end_date": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "is_primary": { "type": "boolean" }, "start_date": { "type": "string" }, "num_sources": { "type": "integer" }, "location_names": { "type": "array", "items": { "type": "string" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__da280d167e6b8aed": { "type": "object", "properties": { "raw": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "role": { "type": "string" }, "class": { "type": "string" }, "levels": { "type": "array", "items": { "type": "string" } }, "sub_role": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__74fd576ca6841cee": { "type": "object", "properties": { "id": { "type": "string" }, "raw": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "size": { "type": "string" }, "type": { "type": "string" }, "ticker": { "type": "string" }, "founded": { "type": "integer" }, "website": { "type": "string" }, "industry": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__0b1549661314d92d" }, "fuzzy_match": { "type": "boolean" }, "industry_v2": { "type": "string" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__e96325452eab319c": { "type": "object", "properties": { "name": { "type": "string" }, "end_date": { "type": "string" }, "start_date": { "type": "string" }, "organization": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__dcb5667b12edf989": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } }, "Manual576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "Apple Inc.", "Google LLC" ], "description": "REQUIRED if no other identifier provided. Company name to search for. At least one of pdl_id/name/profile/ticker/website must be provided." }, "pdl_id": { "type": "string", "examples": [ "" ], "description": "REQUIRED if no other identifier provided. People Data Labs unique ID for a company. At least one of pdl_id/name/profile/ticker/website must be provided." }, "pretty": { "type": "boolean", "default": true, "examples": [ "true", "false" ], "description": "If true, the JSON response will be pretty-printed with human-readable indentation for easier inspection." }, "region": { "type": "string", "examples": [ "California", "New York", "Texas" ], "description": "The state, province, or administrative region where the company is located (e.g., 'California' or 'TX')." }, "ticker": { "type": "string", "examples": [ "AAPL", "MSFT" ], "description": "REQUIRED if no other identifier provided. Stock market ticker symbol. At least one of pdl_id/name/profile/ticker/website must be provided." }, "country": { "type": "string", "examples": [ "USA", "United Kingdom", "FR", "Canada" ], "description": "The country where the company is located. Can be a full name or an ISO country code." }, "profile": { "type": "string", "examples": [ "linkedin.com/company/google", "crunchbase.com/organization/facebook" ], "description": "REQUIRED if no other identifier provided. Company social media profile URL. At least one of pdl_id/name/profile/ticker/website must be provided." }, "website": { "type": "string", "examples": [ "www.apple.com", "about.google" ], "description": "REQUIRED if no other identifier provided. Company website URL. At least one of pdl_id/name/profile/ticker/website must be provided." }, "locality": { "type": "string", "examples": [ "Cupertino", "New York City" ], "description": "The city or locality where the company is situated (e.g., 'Mountain View')." }, "location": { "type": "string", "examples": [ "San Francisco, CA", "London, UK", "Paris" ], "description": "A general text query for the company's location (e.g., 'San Francisco, CA' or 'London'). Can be a partial or complete location string." }, "titlecase": { "type": "boolean", "examples": [ "true", "false" ], "description": "If set to true, textual data in the API response will be converted to title case. If omitted, the API's default casing is used." }, "postal_code": { "type": "string", "examples": [ "95014", "94043" ], "description": "The postal or ZIP code for the company's location." }, "street_address": { "type": "string", "examples": [ "1 Apple Park Way", "1600 Amphitheatre Parkway" ], "description": "The street address component of the company's location." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__96820631034a6864" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__96820631034a6864": { "type": "object", "required": [ "found" ], "properties": { "data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__1e3f470e007a40e7" }, "found": { "type": "boolean" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__1e3f470e007a40e7": { "type": "object", "required": [ "status", "likelihood" ], "properties": { "id": { "type": "string" }, "sic": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__6cd3a75db0ef076b" } }, "name": { "type": "string" }, "size": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__679d735ed5fd1872" }, "tags": { "type": "array", "items": { "type": "string" } }, "type": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__e305ea5bb33a1f2f" }, "naics": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__2048c65893cba949" } }, "status": { "type": "integer" }, "ticker": { "type": "string" }, "founded": { "type": "integer", "exclusiveMinimum": 0 }, "summary": { "type": "string" }, "website": { "type": "string" }, "headline": { "type": "string" }, "industry": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__20b6b1d8f0c1ac14" }, "profiles": { "type": "array", "items": { "type": "string" } }, "likelihood": { "type": "integer", "maximum": 10, "minimum": 1 }, "industry_v2": { "type": "string" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "display_name": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" }, "mic_exchange": { "type": "string" }, "linkedin_slug": { "type": "string" }, "employee_count": { "type": "integer", "minimum": 0 }, "funding_stages": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__6285a4077261b3bc" } }, "dataset_version": { "type": "string" }, "alternative_names": { "type": "array", "items": { "type": "string" } }, "last_funding_date": { "type": "string" }, "affiliated_profiles": { "type": "array", "items": { "type": "string" } }, "alternative_domains": { "type": "array", "items": { "type": "string" } }, "latest_funding_stage": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__6285a4077261b3bc" }, "total_funding_raised": { "type": "number", "minimum": 0 }, "number_funding_rounds": { "type": "integer", "minimum": 0 }, "employee_count_by_country": { "type": "object", "additionalProperties": { "type": "integer" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__6cd3a75db0ef076b": { "type": "object", "properties": { "sic_code": { "type": "string" }, "major_group": { "type": "string" }, "industry_group": { "type": "string" }, "industry_sector": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__679d735ed5fd1872": { "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "type": "string" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__e305ea5bb33a1f2f": { "enum": [ "educational", "government", "nonprofit", "private", "public", "public_subsidiary" ], "type": "string" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__2048c65893cba949": { "type": "object", "properties": { "sector": { "type": "string" }, "naics_code": { "type": "string" }, "sub_sector": { "type": "string" }, "industry_group": { "type": "string" }, "naics_industry": { "type": "string" }, "national_industry": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__20b6b1d8f0c1ac14": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__6285a4077261b3bc": { "enum": [ "angel", "pre_seed", "seed", "series_a", "series_b", "series_c", "series_d", "series_e", "series_f", "series_g", "series_h", "series_i", "series_j", "series_unknown", "funding_round", "private_equity", "debt_financing", "convertible_note", "grant", "corporate_round", "equity_crowdfunding", "product_crowdfunding", "secondary_market", "post_ipo_equity", "post_ipo_debt", "post_ipo_secondary", "non_equity_assistance", "initial_coin_offering", "undisclosed" ], "type": "string" }, "Manual576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA": { "type": "object", "properties": { "lid": { "type": "string", "examples": [ "123456789" ], "description": "LinkedIn ID." }, "name": { "type": "string", "examples": [ "John Michael Doe" ], "description": "Full name." }, "email": { "type": "string", "examples": [ "john.doe@example.com" ], "description": "Email address." }, "phone": { "type": "string", "examples": [ "+14155552671" ], "description": "Phone number; E.164 format recommended." }, "pdl_id": { "type": "string", "examples": [ "qEnxS5T1G2YvasA1x24qoA_0000" ], "description": "People Data Labs unique record ID." }, "pretty": { "type": "boolean", "default": true, "description": "Format JSON response with indentation for readability." }, "region": { "type": "string", "examples": [ "CA" ], "description": "State, province, or region of residence." }, "school": { "type": "string", "examples": [ "Stanford University" ], "description": "School name attended." }, "company": { "type": "string", "examples": [ "Acme Corporation" ], "description": "Company name where person has worked." }, "country": { "type": "string", "examples": [ "US", "United States" ], "description": "Country of residence (ISO 3166-1 alpha-2 code or full name)." }, "profile": { "type": "string", "examples": [ "https://www.linkedin.com/in/john-doe", "https://www.facebook.com/jane.doe" ], "description": "Social profile URL (e.g., LinkedIn, Facebook)." }, "locality": { "type": "string", "examples": [ "San Francisco" ], "description": "City or locality of residence." }, "location": { "type": "string", "examples": [ "San Francisco, CA, USA" ], "description": "General location (e.g., city, state, country)." }, "required": { "type": "string", "examples": [ "emails AND phone_numbers", "education AND (emails OR phone_numbers)", "job_title AND job_company_name", "experience AND work_email" ], "description": "Boolean expression of top-level fields required in enriched profile for match. Use AND/OR operators and parentheses for logic (e.g., 'emails AND phone_numbers', 'education AND (emails OR phone_numbers)'). Valid fields: emails, phone_numbers, experience, education, job_title, job_company_name, full_name, location_country, work_email, personal_emails, mobile_phone, linkedin_url, profiles, skills, etc." }, "last_name": { "type": "string", "examples": [ "Doe" ], "description": "Last name." }, "birth_date": { "type": "string", "examples": [ "1990-01-15" ], "description": "Birth date (YYYY-MM-DD format)." }, "email_hash": { "type": "string", "examples": [ "d41d8cd98f00b204e9800998ecf8427e", "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" ], "description": "SHA-256 or MD5 hash of an email, for matching without exposing the raw email." }, "first_name": { "type": "string", "examples": [ "John" ], "description": "First name." }, "postal_code": { "type": "string", "examples": [ "94107" ], "description": "Postal or ZIP code of residence." }, "data_include": { "type": "string", "examples": [ "emails,phones,profiles", "jobs,education" ], "description": "Comma-separated data fields to include in response (e.g., 'emails,phones'). Refer to People Data Labs docs for all fields." }, "min_likelihood": { "type": "integer", "default": 2, "maximum": 10, "minimum": 0, "examples": [ 0, 5, 10 ], "description": "Minimum confidence score (0-10) for a match to be returned; higher is stricter." }, "street_address": { "type": "string", "examples": [ "123 Main St" ], "description": "Street address." }, "include_if_matched": { "type": "boolean", "default": false, "description": "Include input parameters used for matching in the response if true." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__fc7285c49c464f36" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__fc7285c49c464f36": { "type": "object", "required": [ "status", "likelihood", "data" ], "properties": { "data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__801a7bed5bd96761" }, "status": { "type": "integer" }, "matched": { "type": "array", "items": { "type": "string" } }, "likelihood": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__801a7bed5bd96761": { "type": "object", "properties": { "id": { "type": "string" }, "sex": { "type": "string" }, "emails": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__52b88ac1067d4130" } } ] }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__4b08c5750b3b38c4" } }, "skills": { "type": "array", "items": { "type": "string" } }, "regions": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "summary": { "type": "string" }, "headline": { "type": "string" }, "industry": { "type": "string" }, "profiles": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__c09b76b3bd3d0fa9" } }, "countries": { "type": "array", "items": { "type": "string" } }, "education": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__599b93efe16611a5" } }, "full_name": { "type": "string" }, "interests": { "type": "array", "items": { "type": "string" } }, "job_title": { "type": "string" }, "languages": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__bc978d1b46ca644d" } }, "last_name": { "type": "string" }, "last_seen": { "type": "string" }, "birth_date": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "birth_year": { "anyOf": [ { "type": "boolean" }, { "type": "integer" } ] }, "experience": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__2d7f961eac09b920" } }, "first_name": { "type": "string" }, "first_seen": { "type": "string" }, "github_url": { "type": "string" }, "work_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "facebook_id": { "type": "string" }, "job_history": { "type": "array", "items": {} }, "job_summary": { "type": "string" }, "linkedin_id": { "type": "string" }, "middle_name": { "type": "string" }, "num_records": { "type": "integer" }, "num_sources": { "type": "integer" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "last_initial": { "type": "string" }, "linkedin_url": { "type": "string" }, "location_geo": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "mobile_phone": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "name_aliases": { "type": "array", "items": { "type": "string" } }, "first_initial": { "type": "string" }, "job_onet_code": { "type": "string" }, "location_name": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "phone_numbers": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "certifications": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__e96325452eab319c" } }, "job_company_id": { "type": "string" }, "job_start_date": { "type": "string" }, "job_title_role": { "type": "string" }, "location_metro": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "location_names": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "middle_initial": { "type": "string" }, "dataset_version": { "type": "string" }, "github_username": { "type": "string" }, "inferred_salary": { "type": "string" }, "job_title_class": { "type": "string" }, "location_region": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "personal_emails": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "possible_emails": { "type": "array", "items": {} }, "possible_phones": { "type": "array", "items": {} }, "facebook_friends": { "type": "integer" }, "job_company_name": { "type": "string" }, "job_company_size": { "type": "string" }, "job_company_type": { "type": "string" }, "job_last_changed": { "type": "string" }, "job_title_levels": { "type": "array", "items": { "type": "string" } }, "location_country": { "type": "string" }, "street_addresses": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__dcb5667b12edf989" } } ] }, "twitter_username": { "type": "string" }, "facebook_username": { "type": "string" }, "job_last_verified": { "type": "string" }, "linkedin_username": { "type": "string" }, "location_locality": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "possible_profiles": { "type": "array", "items": {} }, "job_company_ticker": { "type": "string" }, "job_title_sub_role": { "type": "string" }, "location_continent": { "type": "string" }, "job_company_founded": { "type": "integer" }, "job_company_website": { "type": "string" }, "job_company_industry": { "type": "string" }, "job_onet_major_group": { "type": "string" }, "job_onet_minor_group": { "type": "string" }, "linkedin_connections": { "type": "integer" }, "location_postal_code": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "possible_birth_dates": { "type": "array", "items": { "type": "string" } }, "location_last_updated": { "type": "string" }, "job_company_industry_v2": { "type": "string" }, "job_company_linkedin_id": { "type": "string" }, "job_company_twitter_url": { "type": "string" }, "location_address_line_2": { "type": "string" }, "location_street_address": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "possible_location_names": { "type": "array", "items": { "type": "string" } }, "job_company_facebook_url": { "type": "string" }, "job_company_linkedin_url": { "type": "string" }, "job_company_location_geo": { "type": "string" }, "inferred_years_experience": { "type": "integer" }, "job_company_location_name": { "type": "string" }, "job_onet_broad_occupation": { "type": "string" }, "possible_street_addresses": { "type": "array", "items": {} }, "job_company_employee_count": { "type": "integer" }, "job_company_location_metro": { "type": "string" }, "recommended_personal_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_company_location_region": { "type": "string" }, "job_company_inferred_revenue": { "type": "string" }, "job_company_location_country": { "type": "string" }, "job_onet_specific_occupation": { "type": "string" }, "job_company_location_locality": { "type": "string" }, "job_company_location_continent": { "type": "string" }, "job_company_location_postal_code": { "type": "string" }, "job_company_total_funding_raised": { "type": "integer" }, "job_company_location_address_line_2": { "type": "string" }, "job_company_location_street_address": { "type": "string" }, "job_onet_specific_occupation_detail": { "type": "string" }, "job_company_12mo_employee_growth_rate": { "type": "number" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__52b88ac1067d4130": { "type": "object", "properties": { "type": { "type": "string" }, "address": { "type": "string" }, "md5_hash": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" }, "sha_256_hash": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__4b08c5750b3b38c4": { "type": "object", "properties": { "number": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__c09b76b3bd3d0fa9": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "network": { "type": "string" }, "username": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__599b93efe16611a5": { "type": "object", "properties": { "gpa": { "type": "number" }, "raw": { "type": "array", "items": { "type": "string" } }, "majors": { "type": "array", "items": { "type": "string" } }, "minors": { "type": "array", "items": { "type": "string" } }, "school": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__9cb4ca9b3fb6f2eb" }, "degrees": { "type": "array", "items": { "type": "string" } }, "summary": { "type": "string" }, "end_date": { "type": "string" }, "start_date": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__9cb4ca9b3fb6f2eb": { "type": "object", "properties": { "id": { "type": "string" }, "raw": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "type": { "type": "string" }, "domain": { "type": "string" }, "website": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__0b1549661314d92d" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__0b1549661314d92d": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__bc978d1b46ca644d": { "type": "object", "properties": { "name": { "type": "string" }, "proficiency": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__2d7f961eac09b920": { "type": "object", "properties": { "title": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__da280d167e6b8aed" }, "company": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__74fd576ca6841cee" }, "summary": { "type": "string" }, "end_date": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "is_primary": { "type": "boolean" }, "start_date": { "type": "string" }, "num_sources": { "type": "integer" }, "location_names": { "type": "array", "items": { "type": "string" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__da280d167e6b8aed": { "type": "object", "properties": { "raw": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "role": { "type": "string" }, "class": { "type": "string" }, "levels": { "type": "array", "items": { "type": "string" } }, "sub_role": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__74fd576ca6841cee": { "type": "object", "properties": { "id": { "type": "string" }, "raw": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "size": { "type": "string" }, "type": { "type": "string" }, "ticker": { "type": "string" }, "founded": { "type": "integer" }, "website": { "type": "string" }, "industry": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__0b1549661314d92d" }, "fuzzy_match": { "type": "boolean" }, "industry_v2": { "type": "string" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__e96325452eab319c": { "type": "object", "properties": { "name": { "type": "string" }, "end_date": { "type": "string" }, "start_date": { "type": "string" }, "organization": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__dcb5667b12edf989": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } }, "Manual576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA": { "type": "object", "properties": { "lid": { "type": "string", "examples": [ "123456789" ], "description": "The person's LinkedIn ID. This is a numerical ID found in some LinkedIn URLs." }, "name": { "type": "string", "examples": [ "John Michael Doe" ], "description": "The full name of the person." }, "email": { "type": "string", "examples": [ "john.doe@example.com" ], "description": "An email address associated with the person." }, "phone": { "type": "string", "examples": [ "+14155552671", "415-555-0110" ], "description": "A phone number associated with the person." }, "pretty": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, the JSON response is pretty-printed for easier human readability." }, "region": { "type": "string", "examples": [ "CA", "New York" ], "description": "The state, province, or region where the person resides or has resided." }, "school": { "type": "string", "examples": [ "University of California, Berkeley", "Stanford University" ], "description": "The name of an educational institution the person attended." }, "company": { "type": "string", "examples": [ "Acme Corp", "Globex Corporation" ], "description": "The name of a company where the person is or was employed." }, "profile": { "type": "string", "examples": [ "https://www.linkedin.com/in/johndoe", "https://twitter.com/janedoe" ], "description": "A social media profile URL associated with the person, e.g., a LinkedIn or Twitter profile URL." }, "locality": { "type": "string", "examples": [ "San Francisco", "New York" ], "description": "The city or locality where the person resides or has resided." }, "location": { "type": "string", "examples": [ "San Francisco, CA", "London" ], "description": "A general location query (e.g., 'San Francisco, CA', 'London, UK') associated with the person." }, "last_name": { "type": "string", "examples": [ "Doe" ], "description": "The last name of the person." }, "titlecase": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, returns all text values in title case (e.g., 'John Doe'). Otherwise, text is returned as is." }, "email_hash": { "type": "string", "examples": [ "55502f40dc8b7c769880b10874abc9d0", "8b21e5e33be1739a3eda69c1046d1385022b8817999b5a76e9300dd839cb2569" ], "description": "An MD5 or SHA-256 hash of the person's email address." }, "first_name": { "type": "string", "examples": [ "John" ], "description": "The first name of the person." }, "postal_code": { "type": "string", "examples": [ "94107", "10001" ], "description": "The postal or ZIP code where the person resides or has resided." }, "street_address": { "type": "string", "examples": [ "123 Main St, Anytown, USA" ], "description": "The street address where the person resides or has resided." }, "include_if_matched": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, the response will include a 'matched_on' attribute, an array of strings indicating which input parameters led to the match." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__6fcc717d2287600b" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__6fcc717d2287600b": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "integer" }, "matches": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__6f9acc49d50db306" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__6f9acc49d50db306": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__801a7bed5bd96761" }, "matched_on": { "type": "array", "items": { "type": "string" } }, "match_score": { "type": "integer", "maximum": 99, "minimum": 1 } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__801a7bed5bd96761": { "type": "object", "properties": { "id": { "type": "string" }, "sex": { "type": "string" }, "emails": { "anyOf": [ { "type": "array", "items": { "type": "object", "additionalProperties": true } }, { "type": "boolean" } ] }, "skills": { "type": "array", "items": { "type": "string" } }, "industry": { "type": "string" }, "profiles": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "education": { "anyOf": [ { "type": "array", "items": { "type": "object", "additionalProperties": true } }, { "type": "boolean" } ] }, "full_name": { "type": "string" }, "interests": { "type": "array", "items": { "type": "string" } }, "job_title": { "type": "string" }, "last_name": { "type": "string" }, "birth_date": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "birth_year": { "anyOf": [ { "type": "boolean" }, { "type": "integer" } ] }, "experience": { "anyOf": [ { "type": "array", "items": { "type": "object", "additionalProperties": true } }, { "type": "boolean" } ] }, "first_name": { "type": "string" }, "github_url": { "type": "string" }, "work_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "facebook_id": { "type": "string" }, "job_summary": { "type": "string" }, "linkedin_id": { "type": "string" }, "middle_name": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "last_initial": { "type": "string" }, "linkedin_url": { "type": "string" }, "location_geo": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "mobile_phone": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "name_aliases": { "type": "array", "items": { "type": "string" } }, "location_name": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "phone_numbers": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "job_company_id": { "type": "string" }, "job_start_date": { "type": "string" }, "job_title_role": { "type": "string" }, "location_metro": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "middle_initial": { "type": "string" }, "github_username": { "type": "string" }, "inferred_salary": { "type": "string" }, "job_title_class": { "type": "string" }, "location_region": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "personal_emails": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "job_company_name": { "type": "string" }, "job_company_size": { "type": "string" }, "job_last_changed": { "type": "string" }, "job_title_levels": { "type": "array", "items": { "type": "string" } }, "location_country": { "type": "string" }, "street_addresses": { "anyOf": [ { "type": "array", "items": { "type": "object", "additionalProperties": true } }, { "type": "boolean" } ] }, "twitter_username": { "type": "string" }, "facebook_username": { "type": "string" }, "job_last_verified": { "type": "string" }, "linkedin_username": { "type": "string" }, "location_locality": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_title_sub_role": { "type": "string" }, "location_continent": { "type": "string" }, "job_company_founded": { "type": "integer" }, "job_company_website": { "type": "string" }, "job_company_industry": { "type": "string" }, "linkedin_connections": { "type": "integer" }, "location_postal_code": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "location_last_updated": { "type": "string" }, "job_company_industry_v2": { "type": "string" }, "job_company_linkedin_id": { "type": "string" }, "job_company_twitter_url": { "type": "string" }, "location_address_line_2": { "type": "string" }, "location_street_address": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_company_facebook_url": { "type": "string" }, "job_company_linkedin_url": { "type": "string" }, "job_company_location_geo": { "type": "string" }, "job_company_location_name": { "type": "string" }, "job_company_location_metro": { "type": "string" }, "recommended_personal_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_company_location_region": { "type": "string" }, "job_company_location_country": { "type": "string" }, "job_company_location_locality": { "type": "string" }, "job_company_location_continent": { "type": "string" }, "job_company_location_postal_code": { "type": "string" }, "job_company_location_address_line_2": { "type": "string" }, "job_company_location_street_address": { "type": "string" } }, "additionalProperties": true }, "Manual576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC": { "type": "object", "required": [ "query" ], "properties": { "size": { "type": "integer", "default": 1, "examples": [ 10, 25, 100 ], "description": "The number of matched person records to return. Must be an integer between 1 and 100, inclusive." }, "query": { "type": "string", "examples": [ "{\"bool\": {\"must\": [{\"term\": {\"job_company_industry\": \"computer software\"}}]}}", "{\"bool\": {\"must\": [{\"term\": {\"job_title_role\": \"engineer\"}}, {\"term\": {\"location_country\": \"united states\"}}]}}", "{\"bool\": {\"should\": [{\"match\": {\"full_name\": \"john\"}}, {\"match\": {\"first_name\": \"john\"}}]}}" ], "description": "Elasticsearch DSL query string (JSON object) for searching PDL person profiles. Provide just the DSL body (e.g., '{\"bool\": {...}}') without an outer 'query' wrapper.\n\nSupported query types: term, terms, match, match_phrase, prefix, wildcard, range, exists, bool (must/should/filter/must_not).\n\nALL field names MUST use snake_case, NOT camelCase.\n\nValid queryable fields include:\n- Name: full_name, first_name, last_name, middle_name\n- Job: job_title, job_title_role, job_title_class, job_company_name, job_company_industry, job_company_size, job_company_website, job_company_location_*\n- Location (NOT 'location' alone): location_country, location_region, location_locality, location_metro, location_geo\n- Social: linkedin_url, linkedin_username, linkedin_id, facebook_url, facebook_username, twitter_url, twitter_username, github_url, github_username\n- Nested profiles: profiles.network, profiles.url, profiles.username, profiles.id\n- Other: industry, skills, interests, countries, sex, work_email, personal_emails\n\nNOT queryable as fields (use 'dataset' parameter instead): email, phone.\n'experience_level' is not valid — use 'job_title_levels'. 'job_company_domain' is not valid — use 'job_company_website'. 'minimum_should_match' is not supported by PDL's API.\n\nFull field reference: https://docs.peopledatalabs.com/docs/fields-person" }, "pretty": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, formats the JSON response with human-readable indentation. Defaults to false." }, "dataset": { "type": "string", "default": "resume", "examples": [ "resume", "email", "all" ], "description": "Specifies the dataset category to search against, filtering results to profiles that have the specified type of data available. Allowed values are: 'resume', 'email', 'phone', 'mobile_phone', 'street_address', 'consumer_social', 'developer', 'all'. Note: Use 'email' here to filter for profiles with email addresses available, rather than querying 'email' as a field in the query parameter." }, "titlecase": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, titlecases the person records in the response. Defaults to false." }, "scroll_token": { "type": "string", "default": "", "examples": [ "", "627445704a7f000001000000" ], "description": "A token returned in a previous search response. Provide this token to retrieve the next page of results. Omit or pass an empty string for the first request." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__cd854e5510d2480e" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__cd854e5510d2480e": { "type": "object", "required": [ "query", "records", "scroll_token", "total" ], "properties": { "query": { "type": "string" }, "total": { "type": "integer" }, "records": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__63b76bca786f0947" } }, "scroll_token": { "type": "string" }, "composio_execution_message": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__63b76bca786f0947": { "type": "object", "properties": { "id": { "type": "string" }, "sex": { "type": "string" }, "emails": { "type": "boolean" }, "skills": { "type": "array", "items": { "type": "string" } }, "regions": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "industry": { "type": "string" }, "profiles": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__770e8b2920163057" } }, "countries": { "type": "array", "items": { "type": "string" } }, "education": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__f45315775795c6e8" } }, "full_name": { "type": "string" }, "interests": { "type": "array", "items": { "type": "string" } }, "job_title": { "type": "string" }, "last_name": { "type": "string" }, "birth_date": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "birth_year": { "anyOf": [ { "type": "boolean" }, { "type": "integer" } ] }, "experience": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__bb6b7f1e33fa2850" } }, "first_name": { "type": "string" }, "github_url": { "type": "string" }, "work_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "facebook_id": { "type": "string" }, "linkedin_id": { "type": "string" }, "middle_name": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "last_initial": { "type": "string" }, "linkedin_url": { "type": "string" }, "location_geo": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "mobile_phone": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "location_name": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "phone_numbers": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "job_company_id": { "type": "string" }, "job_start_date": { "type": "string" }, "job_title_role": { "type": "string" }, "location_metro": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "location_names": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "middle_initial": { "type": "string" }, "dataset_version": { "type": "string" }, "github_username": { "type": "string" }, "job_title_class": { "type": "string" }, "location_region": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "personal_emails": { "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "job_company_name": { "type": "string" }, "job_company_size": { "type": "string" }, "job_last_changed": { "type": "string" }, "job_title_levels": { "type": "array", "items": { "type": "string" } }, "location_country": { "type": "string" }, "street_addresses": { "anyOf": [ { "type": "array", "items": { "type": "object", "additionalProperties": true } }, { "type": "boolean" } ] }, "twitter_username": { "type": "string" }, "facebook_username": { "type": "string" }, "job_last_verified": { "type": "string" }, "linkedin_username": { "type": "string" }, "location_locality": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_title_sub_role": { "type": "string" }, "location_continent": { "type": "string" }, "job_company_founded": { "type": "integer" }, "job_company_website": { "type": "string" }, "job_company_industry": { "type": "string" }, "location_postal_code": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "location_last_updated": { "type": "string" }, "job_company_industry_v2": { "type": "string" }, "job_company_linkedin_id": { "type": "string" }, "job_company_twitter_url": { "type": "string" }, "location_address_line_2": { "type": "string" }, "location_street_address": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_company_facebook_url": { "type": "string" }, "job_company_linkedin_url": { "type": "string" }, "job_company_location_geo": { "type": "string" }, "job_company_location_name": { "type": "string" }, "job_company_location_metro": { "type": "string" }, "recommended_personal_email": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ] }, "job_company_location_region": { "type": "string" }, "job_company_location_country": { "type": "string" }, "job_company_location_locality": { "type": "string" }, "job_company_location_continent": { "type": "string" }, "job_company_location_postal_code": { "type": "string" }, "job_company_location_address_line_2": { "type": "string" }, "job_company_location_street_address": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__770e8b2920163057": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "network": { "type": "string" }, "username": { "type": "string" }, "last_seen": { "type": "string" }, "first_seen": { "type": "string" }, "num_sources": { "type": "integer" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__f45315775795c6e8": { "type": "object", "properties": { "gpa": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "majors": { "type": "array", "items": { "type": "string" } }, "minors": { "type": "array", "items": { "type": "string" } }, "school": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__d7c54dd2bc2fa4e5" }, "degrees": { "type": "array", "items": { "type": "string" } }, "end_date": { "type": "string" }, "start_date": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__d7c54dd2bc2fa4e5": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "domain": { "type": "string" }, "website": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__73694151657f12c6" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__73694151657f12c6": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__bb6b7f1e33fa2850": { "type": "object", "properties": { "title": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__a45d521d910e34c8" }, "company": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__eed0b1123d23cb0f" }, "end_date": { "type": "string" }, "is_primary": { "type": "boolean" }, "start_date": { "type": "string" }, "location_names": { "type": "array", "items": { "type": "string" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__a45d521d910e34c8": { "type": "object", "properties": { "name": { "type": "string" }, "role": { "type": "string" }, "class": { "type": "string" }, "levels": { "type": "array", "items": { "type": "string" } }, "sub_role": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__eed0b1123d23cb0f": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "size": { "type": "string" }, "type": { "type": "string" }, "ticker": { "type": "string" }, "founded": { "type": "integer" }, "website": { "type": "string" }, "industry": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__73694151657f12c6" }, "industry_v2": { "type": "string" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" } } }, "Manual576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC": { "type": "object", "required": [ "query" ], "properties": { "size": { "type": "integer", "default": 1, "examples": [ "10", "50", "100" ], "description": "The number of matched company records to return. Must be an integer between 1 and 100, inclusive." }, "query": { "type": "string", "examples": [ "{\"bool\": {\"must\": [{\"term\": {\"industry\": \"computer software\"}}]}}", "{\"range\": {\"employee_count\": {\"gte\": 5000}}}", "{\"bool\": {\"filter\": [{\"range\": {\"founded\": {\"gte\": 2010}}}, {\"term\": {\"location.country\": \"united states\"}}]}}", "{\"match\": {\"name\": \"google\"}}" ], "description": "Elasticsearch DSL query string (JSON object) for searching People Data Labs company profiles.\n\n**Supported query types:** term, terms, match, match_phrase, range, exists, bool (must/should/filter/must_not), wildcard, prefix.\n\n**Common Company Fields:** name, display_name, website, industry, employee_count, founded, size, location.country, location.region, location.locality, location.name, tags, linkedin_url, type, summary.\n\n**Location Searches:** Use nested fields: `location.country`, `location.region`, `location.locality`, `location.name`. Example: `{\"term\": {\"location.country\": \"united states\"}}`.\n\n**Important Restrictions:**\n- Do NOT include `size` or `scroll_token` in this query; use the dedicated request fields.\n- Do NOT use `minimum_should_match` in bool queries.\n\nFor complete field mappings, see https://docs.peopledatalabs.com/docs/company-search-api." }, "pretty": { "type": "boolean", "default": false, "examples": [ "true", "false" ], "description": "If true, the JSON response will be pretty-printed with human-readable indentation. Defaults to false." }, "titlecase": { "type": "boolean", "default": false, "examples": [ "true", "false" ], "description": "If true, an attempt will be made to title-case relevant text fields in the returned company records. Defaults to false." }, "scroll_token": { "type": "string", "default": "", "examples": [ "627275426f6b656e3432363935383437303232353438373930323030343934383635343734313337", "" ], "description": "A token returned from a previous search response, used for paginating through large result sets. Provide this token to retrieve the next batch of `size` records. Leave empty or omit for the first request." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__a74b4d831e94f8c0" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__a74b4d831e94f8c0": { "type": "object", "required": [ "query", "records", "scroll_token", "total" ], "properties": { "query": { "type": "string" }, "total": { "type": "integer" }, "records": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e132828af5abc696" } }, "scroll_token": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e132828af5abc696": { "type": "object", "properties": { "id": { "type": "string" }, "sic": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__747a19c7ca00e242" } }, "name": { "type": "string" }, "size": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3d498cc8dd55f1c9" }, "tags": { "type": "array", "items": { "type": "string" } }, "type": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__be1cf172b8eeb4a3" }, "naics": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__5fff78354a0252c1" } }, "ticker": { "type": "string" }, "founded": { "type": "integer" }, "summary": { "type": "string" }, "website": { "type": "string" }, "headline": { "type": "string" }, "industry": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__20b6b1d8f0c1ac14" }, "profiles": { "type": "array", "items": { "type": "string" } }, "industry_v2": { "type": "string" }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "display_name": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" }, "mic_exchange": { "type": "string" }, "linkedin_slug": { "type": "string" }, "employee_count": { "type": "integer" }, "funding_stages": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3854e01f2bc19c61" } }, "dataset_version": { "type": "string" }, "inferred_revenue": { "type": "string" }, "alternative_names": { "type": "array", "items": { "type": "string" } }, "last_funding_date": { "type": "string" }, "recent_exec_hires": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e6ee6721184f4a9d" } }, "top_next_employers": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4" } } }, "affiliated_profiles": { "type": "array", "items": { "type": "string" } }, "alternative_domains": { "type": "array", "items": { "type": "string" } }, "employee_churn_rate": { "type": "object", "additionalProperties": { "type": "number" } }, "employee_growth_rate": { "type": "object", "additionalProperties": { "type": "number" } }, "latest_funding_stage": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3854e01f2bc19c61" }, "total_funding_raised": { "type": "number" }, "number_funding_rounds": { "type": "integer" }, "average_tenure_by_role": { "type": "object", "additionalProperties": { "type": "number" } }, "employee_count_by_role": { "type": "object", "additionalProperties": { "type": "integer" } }, "recent_exec_departures": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__9ade69eb098566cf" } }, "top_previous_employers": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4" } } }, "average_employee_tenure": { "type": "number" }, "average_tenure_by_level": { "type": "object", "additionalProperties": { "type": "number" } }, "employee_count_by_class": { "type": "object", "additionalProperties": { "type": "integer" } }, "employee_count_by_month": { "type": "object", "additionalProperties": { "type": "integer" } }, "gross_additions_by_month": { "type": "object", "additionalProperties": { "type": "integer" } }, "employee_count_by_country": { "type": "object", "additionalProperties": { "type": "integer" } }, "gross_departures_by_month": { "type": "object", "additionalProperties": { "type": "integer" } }, "employee_count_by_sub_role": { "type": "object", "additionalProperties": { "type": "integer" } }, "top_next_employers_by_role": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4" } } }, "top_next_employers_12_month": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4" } } }, "top_previous_employers_by_role": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4" } } }, "employee_count_by_month_by_role": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "type": "integer" } } }, "top_previous_employers_12_month": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4" } } }, "employee_count_by_month_by_level": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "type": "integer" } } }, "employee_growth_rate_12_month_by_role": { "type": "object", "additionalProperties": { "type": "number" } }, "employee_growth_rate_12_month_by_class": { "type": "object", "additionalProperties": { "type": "number" } }, "employee_growth_rate_12_month_by_sub_role": { "type": "object", "additionalProperties": { "type": "number" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__747a19c7ca00e242": { "type": "object", "properties": { "sic_code": { "type": "string" }, "major_group": { "type": "string" }, "industry_group": { "type": "string" }, "industry_sector": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3d498cc8dd55f1c9": { "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "type": "string" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__be1cf172b8eeb4a3": { "enum": [ "public", "private", "public_subsidiary", "educational", "government", "nonprofit" ], "type": "string" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__5fff78354a0252c1": { "type": "object", "properties": { "sector": { "type": "string" }, "naics_code": { "type": "string" }, "sub_sector": { "type": "string" }, "industry_group": { "type": "string" }, "naics_industry": { "type": "string" }, "national_industry": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__20b6b1d8f0c1ac14": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3854e01f2bc19c61": { "enum": [ "seed", "series_a", "series_b", "series_c", "series_d", "series_e", "series_f", "series_g", "series_h", "series_i", "series_j", "series_unknown", "angel", "pre_seed", "private_equity", "debt_financing", "convertible_note", "grant", "corporate_round", "equity_crowdfunding", "product_crowdfunding", "initial_coin_offering", "post_ipo_equity", "post_ipo_debt", "post_ipo_secondary", "secondary_market", "non_equity_assistance", "funding_round", "undisclosed" ], "type": "string" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e6ee6721184f4a9d": { "type": "object", "properties": { "roles": { "type": "array", "items": { "type": "string" } }, "levels": { "type": "array", "items": { "type": "string" } }, "pdl_id": { "type": "string" }, "job_title": { "type": "string" }, "joined_date": { "type": "string" }, "previous_company": { "type": "object", "additionalProperties": { "type": "string" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4": { "type": "object", "properties": { "id": { "type": "string" }, "count": { "type": "integer" }, "display_name": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__9ade69eb098566cf": { "type": "object", "properties": { "roles": { "type": "array", "items": { "type": "string" } }, "levels": { "type": "array", "items": { "type": "string" } }, "pdl_id": { "type": "string" }, "job_title": { "type": "string" }, "new_company": { "type": "object", "additionalProperties": { "type": "string" } }, "departed_date": { "type": "string" } } }, "Manual576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST": { "type": "object", "properties": { "sql": { "type": "string", "examples": [ "SELECT * FROM company WHERE industry='computer software' AND website IS NOT NULL", "SELECT * FROM company WHERE employee_count >= 100 AND location.country='united states'" ], "description": "SQL query format: SELECT * FROM company WHERE [condition]. Either 'query' or 'sql' is required, but not both." }, "size": { "type": "integer", "default": 1, "maximum": 100, "minimum": 1, "examples": [ 10, 50, 100 ], "description": "Batch size/max records returned. Must be between 1 and 100. Default: 1" }, "query": { "type": "string", "examples": [ "{\"query\": {\"term\": {\"industry\": \"computer software\"}}}", "{\"bool\": {\"must\": [{\"term\": {\"industry\": \"computer software\"}}, {\"exists\": {\"field\": \"website\"}}]}}" ], "description": "An Elasticsearch (v7.7) DSL query for searching company data. Must be a valid JSON object as a string. Either 'query' or 'sql' is required, but not both." }, "pretty": { "type": "boolean", "default": false, "description": "Human-readable JSON formatting. Default: false" }, "titlecase": { "type": "boolean", "default": false, "description": "Titlecase response text. Default: false" }, "from_offset": { "type": "integer", "maximum": 9999, "minimum": 0, "examples": [ 0, 100, 500 ], "description": "Legacy offset for pagination (0-9999), max 10000 records total. Use scroll_token for unlimited pagination." }, "scroll_token": { "type": "string", "examples": [ "104$14.278746" ], "description": "Pagination token from previous response for unlimited record retrieval. Use this for paginating beyond 10000 records." } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__5c173251d3b0e1e0" }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__5c173251d3b0e1e0": { "type": "object", "required": [ "status", "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__e132828af5abc696" } }, "total": { "type": "integer" }, "status": { "type": "integer" }, "scroll_token": { "type": "string" } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__e132828af5abc696": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "size": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "type": { "type": "string" }, "ticker": { "type": "string" }, "founded": { "type": "integer" }, "summary": { "type": "string" }, "website": { "type": "string" }, "headline": { "type": "string" }, "industry": { "type": "string" }, "location": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__0b1549661314d92d" }, "profiles": { "type": "array", "items": { "type": "string" } }, "linkedin_id": { "type": "string" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "linkedin_url": { "type": "string" }, "employee_count": { "type": "integer" }, "alternative_names": { "type": "array", "items": { "type": "string" } }, "affiliated_profiles": { "type": "array", "items": { "type": "string" } } } }, "Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__0b1549661314d92d": { "type": "object", "properties": { "geo": { "type": "string" }, "name": { "type": "string" }, "metro": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" }, "locality": { "type": "string" }, "continent": { "type": "string" }, "postal_code": { "type": "string" }, "address_line_2": { "type": "string" }, "street_address": { "type": "string" } } } }, "responses": {}, "parameters": {}, "examples": {}, "requestBodies": {}, "headers": {}, "links": {}, "callbacks": {}, "pathItems": {} }, "info": { "description": "", "title": "People Data Labs", "version": "1", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-configured-paths": [ "/apis/v1/people-data-labs/companies-enrich", "/apis/v1/people-data-labs/companies-search", "/apis/v1/people-data-labs/company/enrich", "/apis/v1/people-data-labs/company/search", "/apis/v1/people-data-labs/enrich-bulk-company-data", "/apis/v1/people-data-labs/enrich-bulk-person-data", "/apis/v1/people-data-labs/enrich-company-data", "/apis/v1/people-data-labs/enrich-person-data", "/apis/v1/people-data-labs/identify-person-data", "/apis/v1/people-data-labs/people-enrich", "/apis/v1/people-data-labs/people-search", "/apis/v1/people-data-labs/people-search-elastic", "/apis/v1/people-data-labs/search-company-elastic", "/apis/v1/people-data-labs/search-company-post" ], "x-aisa-document": { "facts_hash": "d9aafd76ae02b9bcd98e168c52eb69aba6e12890a1eed8da421910f394e8200a", "generator_version": "3", "protocol_version": "1", "schema_version": "1", "composer_version": "28", "response_pending": [ { "operation_id": "people-data-labs.companies-enrich", "path": "/apis/v1/people-data-labs/companies-enrich", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "people-data-labs.companies-search", "path": "/apis/v1/people-data-labs/companies-search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "people-data-labs.people-enrich", "path": "/apis/v1/people-data-labs/people-enrich", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "people-data-labs.people-search", "path": "/apis/v1/people-data-labs/people-search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" } ], "document_hash": "sha256:fcc357eea49c3a145e5ed0f836a0034070b32bf97d92453e0a56ff91d1d4e687" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "people-data-labs", "x-aisa-catalogs": { "people-data-labs": { "title": "People Data Labs", "description": "", "x-aisa-document": { "facts_hash": "d9aafd76ae02b9bcd98e168c52eb69aba6e12890a1eed8da421910f394e8200a", "generator_version": "3", "protocol_version": "1", "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } } } } }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ], "paths": { "/apis/v1/people-data-labs/companies-enrich": { "get": { "description": "at least one of pdl_id | name | website | ticker | profile (pdl_id overrides the rest); website gives the highest match rate. The other fields only disambiguate\n\n\nUsage-based billing; Default request estimate: $0.1 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.companies-enrich", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Enrich a company by website, name or ticker", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e17d184edb30" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.companies-enrich", "method": "GET", "path": "/apis/v1/people-data-labs/companies-enrich" }, "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "locality", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "location", "in": "query", "required": false, "schema": { "type": "string", "description": "free-text HQ location, to disambiguate a name" } }, { "name": "min_likelihood", "in": "query", "required": false, "schema": { "type": "integer", "description": "1-10 match-confidence floor; defaults to 2 here, lower than you might expect" } }, { "name": "name", "in": "query", "required": false, "schema": { "type": "string", "description": "company name; ambiguous on its own, pair with location" } }, { "name": "postal_code", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pretty", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "profile", "in": "query", "required": false, "schema": { "type": "string", "description": "LinkedIn company URL", "examples": [ "linkedin.com/company/peopledatalabs" ] } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "street_address", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "ticker", "in": "query", "required": false, "schema": { "type": "string", "description": "stock ticker for public companies", "examples": [ "AAPL" ] } }, { "name": "website", "in": "query", "required": false, "schema": { "type": "string", "description": "company domain — the strongest identifier", "examples": [ "peopledatalabs.com" ] } } ], "x-aisa-source": { "kind": "manual", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/", "fetched_at": "2026-11-07T11:52:30.302332+00:00", "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566", "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68", "converter": "scripts/prepare_treg_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.", "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18", "source_pages": [ { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py", "scope": "pathParams arrive as query; array enum and numeric bounds semantics" }, { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py", "scope": "Parameter declaration vocabulary and optional required flag" } ], "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978" }, "x-aisa-response-pending": { "operation_id": "people-data-labs.companies-enrich", "path": "/apis/v1/people-data-labs/companies-enrich", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-companies-enrich" } }, "/apis/v1/people-data-labs/companies-search": { "get": { "description": "exactly one of sql | query. Unlike person search, company search caps `size` at 100 on BOTH methods, and the spec does not offer scroll_token here. Rate limit 10 req/min\n\n\nUsage-based billing; Default request estimate: $0.1 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.companies-search", "parameters": [ { "name": "pretty", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "description": "Elasticsearch JSON query — the alternative to sql" } }, { "name": "scroll_token", "in": "query", "required": false, "schema": { "type": "string", "description": "cursor from the previous response" } }, { "examples": { "default": { "value": 1 }, "minimal": { "value": 1 } }, "in": "query", "name": "size", "required": true, "schema": { "maximum": 100, "minimum": 1, "type": "integer", "description": "records to return, 1-100, default 1 — you pay 1 credit per record" } }, { "name": "sql", "in": "query", "required": false, "schema": { "type": "string", "description": "SQL WHERE clause over the Company schema, e.g. \"SELECT * FROM company WHERE industry='computer software' AND size='51-200'\"" } }, { "name": "titlecase", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search companies by industry, headcount or location", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0448c79cd86e" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.companies-search", "method": "GET", "path": "/apis/v1/people-data-labs/companies-search" }, "x-aisa-source": { "kind": "manual", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/", "fetched_at": "2026-11-07T11:52:30.302332+00:00", "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566", "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68", "converter": "scripts/prepare_treg_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.", "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18", "source_pages": [ { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py", "scope": "pathParams arrive as query; array enum and numeric bounds semantics" }, { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py", "scope": "Parameter declaration vocabulary and optional required flag" } ], "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978" }, "x-aisa-response-pending": { "operation_id": "people-data-labs.companies-search", "path": "/apis/v1/people-data-labs/companies-search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/people-data-labs/companies-search?size=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-companies-search" } }, "/apis/v1/people-data-labs/enrich-bulk-company-data": { "post": { "description": "\nA request reference price is not currently available; use a request quote where supported. Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.enrich-bulk-company-data", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "requests": { "items": { "type": "object", "required": [ "params" ], "properties": { "params": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "Apple Inc.", "Google LLC" ], "description": "Company name to search for. At least one of pdl_id/name/profile/ticker/website must be provided." }, "pdl_id": { "type": "string", "examples": [ "qfVEk4GNmw03Pln1TfV9xA_0000" ], "description": "People Data Labs unique ID for a company. At least one of pdl_id/name/profile/ticker/website must be provided." }, "region": { "type": "string", "examples": [ "California", "New York" ], "description": "The state, province, or administrative region where the company is located." }, "ticker": { "type": "string", "examples": [ "AAPL", "MSFT" ], "description": "Stock market ticker symbol. At least one of pdl_id/name/profile/ticker/website must be provided." }, "country": { "type": "string", "examples": [ "USA", "United Kingdom", "FR" ], "description": "The country where the company is located. Can be a full name or an ISO country code." }, "profile": { "type": "string", "examples": [ "linkedin.com/company/google", "crunchbase.com/organization/facebook" ], "description": "Company social media profile URL. At least one of pdl_id/name/profile/ticker/website must be provided." }, "website": { "type": "string", "examples": [ "www.apple.com", "about.google" ], "description": "Company website URL. At least one of pdl_id/name/profile/ticker/website must be provided." }, "locality": { "type": "string", "examples": [ "Cupertino", "New York City" ], "description": "The city or locality where the company is situated." }, "location": { "type": "string", "examples": [ "San Francisco, CA", "London, UK" ], "description": "A general text query for the company's location (e.g., 'San Francisco, CA' or 'London')." }, "postal_code": { "type": "string", "examples": [ "95014", "94043" ], "description": "The postal or ZIP code for the company's location." }, "street_address": { "type": "string", "examples": [ "1 Apple Park Way", "1600 Amphitheatre Parkway" ], "description": "The street address component of the company's location." } }, "description": "Parameters for this individual company enrichment request. Must include at least one identifier (pdl_id, name, profile, ticker, or website).", "additionalProperties": false } }, "description": "A single request item in the bulk company enrichment array." }, "maxItems": 100, "minItems": 1, "type": "array", "description": "Array of 1-100 individual company enrichment requests. Each request must contain a params object with at least one company identifier." } }, "required": [ "requests" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Enrich Bulk Company Data", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "estimate_source": "unavailable", "estimate_unavailable_reason": "reference_request_unavailable", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "397ac6752af5" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.enrich-bulk-company-data", "method": "POST", "path": "/apis/v1/people-data-labs/enrich-bulk-company-data" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:c73837d011cee5c680edb76208b8280862c216fb20fe3f43939ccd1b3117fa8e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-enrich-bulk-company-data" } }, "/apis/v1/people-data-labs/enrich-bulk-person-data": { "post": { "description": "\nA request reference price is not currently available; use a request quote where supported. Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.enrich-bulk-person-data", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "requests": { "items": { "type": "object", "required": [ "params" ], "properties": { "params": { "type": "object", "properties": { "lid": { "type": "string", "examples": [ "123456789" ], "description": "LinkedIn ID." }, "name": { "type": "string", "examples": [ "John Michael Doe" ], "description": "Full name." }, "email": { "type": "string", "examples": [ "john.doe@example.com" ], "description": "Email address." }, "phone": { "type": "string", "examples": [ "+14155552671" ], "description": "Phone number; E.164 format recommended." }, "pdl_id": { "type": "string", "examples": [ "qEnxS5T1G2YvasA1x24qoA_0000" ], "description": "People Data Labs unique record ID." }, "region": { "type": "string", "examples": [ "CA" ], "description": "State, province, or region of residence." }, "school": { "type": "string", "examples": [ "Stanford University" ], "description": "School name attended." }, "company": { "type": "string", "examples": [ "Acme Corporation" ], "description": "Company name where person has worked." }, "country": { "type": "string", "examples": [ "US", "United States" ], "description": "Country of residence (ISO 3166-1 alpha-2 code or full name)." }, "profile": { "type": "string", "examples": [ "https://www.linkedin.com/in/john-doe", "https://www.facebook.com/jane.doe" ], "description": "Social profile URL (e.g., LinkedIn, Facebook)." }, "locality": { "type": "string", "examples": [ "San Francisco" ], "description": "City or locality of residence." }, "location": { "type": "string", "examples": [ "San Francisco, CA, USA" ], "description": "General location (e.g., city, state, country)." }, "required": { "type": "string", "examples": [ "emails AND phone_numbers", "education AND (emails OR phone_numbers)", "job_title AND job_company_name" ], "description": "Boolean expression of top-level fields required in enriched profile for match. Use AND/OR operators and parentheses for logic (e.g., 'emails AND phone_numbers', 'education AND (emails OR phone_numbers)')." }, "last_name": { "type": "string", "examples": [ "Doe" ], "description": "Last name." }, "birth_date": { "type": "string", "examples": [ "1990-01-15" ], "description": "Birth date (YYYY-MM-DD format)." }, "email_hash": { "type": "string", "examples": [ "d41d8cd98f00b204e9800998ecf8427e", "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" ], "description": "SHA-256 or MD5 hash of an email, for matching without exposing the raw email." }, "first_name": { "type": "string", "examples": [ "John" ], "description": "First name." }, "postal_code": { "type": "string", "examples": [ "94107" ], "description": "Postal or ZIP code of residence." }, "data_include": { "type": "string", "examples": [ "emails,phones,profiles", "jobs,education" ], "description": "Comma-separated data fields to include in response (e.g., 'emails,phones'). Refer to People Data Labs docs for all fields." }, "min_likelihood": { "type": "integer", "maximum": 10, "minimum": 0, "examples": [ 0, 5, 10 ], "description": "Minimum confidence score (0-10) for a match to be returned; higher is stricter." }, "street_address": { "type": "string", "examples": [ "123 Main St" ], "description": "Street address." } }, "description": "Parameters for single person enrichment. Must include at least one identifier (profile, email, phone, etc.) or name with additional demographic data.", "additionalProperties": false }, "metadata": { "type": "object", "description": "Optional metadata to include in the response for this request. Can be used to track individual requests in the bulk response.", "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "description": "A single enrichment request within the bulk request array." }, "maxItems": 100, "minItems": 1, "type": "array", "description": "Array of 1-100 individual enrichment requests, each containing a 'params' object with person identifiers." } }, "required": [ "requests" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Enrich bulk person data", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "estimate_source": "unavailable", "estimate_unavailable_reason": "reference_request_unavailable", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "491cdcb7b306" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.enrich-bulk-person-data", "method": "POST", "path": "/apis/v1/people-data-labs/enrich-bulk-person-data" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:844f10051b3171bfe3cd2d74b2a75567396d48db2b38f8c79abd5e170c199f53" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-enrich-bulk-person-data" } }, "/apis/v1/people-data-labs/enrich-company-data": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.1003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.enrich-company-data", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "Apple Inc.", "Google LLC" ], "description": "REQUIRED if no other identifier provided. Company name to search for. At least one of pdl_id/name/profile/ticker/website must be provided." }, "pdl_id": { "type": "string", "examples": [ "" ], "description": "REQUIRED if no other identifier provided. People Data Labs unique ID for a company. At least one of pdl_id/name/profile/ticker/website must be provided." }, "pretty": { "type": "boolean", "default": true, "examples": [ "true", "false" ], "description": "If true, the JSON response will be pretty-printed with human-readable indentation for easier inspection." }, "region": { "type": "string", "examples": [ "California", "New York", "Texas" ], "description": "The state, province, or administrative region where the company is located (e.g., 'California' or 'TX')." }, "ticker": { "type": "string", "examples": [ "AAPL", "MSFT" ], "description": "REQUIRED if no other identifier provided. Stock market ticker symbol. At least one of pdl_id/name/profile/ticker/website must be provided." }, "country": { "type": "string", "examples": [ "USA", "United Kingdom", "FR", "Canada" ], "description": "The country where the company is located. Can be a full name or an ISO country code." }, "profile": { "type": "string", "examples": [ "linkedin.com/company/google", "crunchbase.com/organization/facebook" ], "description": "REQUIRED if no other identifier provided. Company social media profile URL. At least one of pdl_id/name/profile/ticker/website must be provided." }, "website": { "type": "string", "description": "REQUIRED if no other identifier provided. Company website URL. At least one of pdl_id/name/profile/ticker/website must be provided.", "examples": [ "www.apple.com", "about.google" ] }, "locality": { "type": "string", "examples": [ "Cupertino", "New York City" ], "description": "The city or locality where the company is situated (e.g., 'Mountain View')." }, "location": { "type": "string", "examples": [ "San Francisco, CA", "London, UK", "Paris" ], "description": "A general text query for the company's location (e.g., 'San Francisco, CA' or 'London'). Can be a partial or complete location string." }, "titlecase": { "type": "boolean", "examples": [ "true", "false" ], "description": "If set to true, textual data in the API response will be converted to title case. If omitted, the API's default casing is used." }, "postal_code": { "type": "string", "examples": [ "95014", "94043" ], "description": "The postal or ZIP code for the company's location." }, "street_address": { "type": "string", "examples": [ "1 Apple Park Way", "1600 Amphitheatre Parkway" ], "description": "The street address component of the company's location." } }, "required": [ "website" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_COMPANY_DATA__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Enrich Company Data", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1003, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "91d71fd87605" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.enrich-company-data", "method": "POST", "path": "/apis/v1/people-data-labs/enrich-company-data" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:6dec2d621993a588f8cde0aa7925b3b8106f746b5e792a19a4110b38a26ab53d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-enrich-company-data" } }, "/apis/v1/people-data-labs/enrich-person-data": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.2803 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.enrich-person-data", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lid": { "type": "string", "examples": [ "123456789" ], "description": "LinkedIn ID." }, "name": { "type": "string", "examples": [ "John Michael Doe" ], "description": "Full name." }, "email": { "type": "string", "description": "Email address.", "examples": [ "john.doe@example.com" ] }, "phone": { "type": "string", "examples": [ "+14155552671" ], "description": "Phone number; E.164 format recommended." }, "pdl_id": { "type": "string", "examples": [ "qEnxS5T1G2YvasA1x24qoA_0000" ], "description": "People Data Labs unique record ID." }, "pretty": { "type": "boolean", "default": true, "description": "Format JSON response with indentation for readability." }, "region": { "type": "string", "examples": [ "CA" ], "description": "State, province, or region of residence." }, "school": { "type": "string", "examples": [ "Stanford University" ], "description": "School name attended." }, "company": { "type": "string", "examples": [ "Acme Corporation" ], "description": "Company name where person has worked." }, "country": { "type": "string", "examples": [ "US", "United States" ], "description": "Country of residence (ISO 3166-1 alpha-2 code or full name)." }, "profile": { "type": "string", "examples": [ "https://www.linkedin.com/in/john-doe", "https://www.facebook.com/jane.doe" ], "description": "Social profile URL (e.g., LinkedIn, Facebook)." }, "locality": { "type": "string", "examples": [ "San Francisco" ], "description": "City or locality of residence." }, "location": { "type": "string", "examples": [ "San Francisco, CA, USA" ], "description": "General location (e.g., city, state, country)." }, "required": { "type": "string", "examples": [ "emails AND phone_numbers", "education AND (emails OR phone_numbers)", "job_title AND job_company_name", "experience AND work_email" ], "description": "Boolean expression of top-level fields required in enriched profile for match. Use AND/OR operators and parentheses for logic (e.g., 'emails AND phone_numbers', 'education AND (emails OR phone_numbers)'). Valid fields: emails, phone_numbers, experience, education, job_title, job_company_name, full_name, location_country, work_email, personal_emails, mobile_phone, linkedin_url, profiles, skills, etc." }, "last_name": { "type": "string", "examples": [ "Doe" ], "description": "Last name." }, "birth_date": { "type": "string", "examples": [ "1990-01-15" ], "description": "Birth date (YYYY-MM-DD format)." }, "email_hash": { "type": "string", "examples": [ "d41d8cd98f00b204e9800998ecf8427e", "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" ], "description": "SHA-256 or MD5 hash of an email, for matching without exposing the raw email." }, "first_name": { "type": "string", "examples": [ "John" ], "description": "First name." }, "postal_code": { "type": "string", "examples": [ "94107" ], "description": "Postal or ZIP code of residence." }, "data_include": { "type": "string", "examples": [ "emails,phones,profiles", "jobs,education" ], "description": "Comma-separated data fields to include in response (e.g., 'emails,phones'). Refer to People Data Labs docs for all fields." }, "min_likelihood": { "type": "integer", "default": 2, "maximum": 10, "minimum": 0, "examples": [ 0, 5, 10 ], "description": "Minimum confidence score (0-10) for a match to be returned; higher is stricter." }, "street_address": { "type": "string", "examples": [ "123 Main St" ], "description": "Street address." }, "include_if_matched": { "type": "boolean", "default": false, "description": "Include input parameters used for matching in the response if true." } }, "required": [ "email" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_ENRICH_PERSON_DATA__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Enrich person data", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.2803, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ee4a295aeff2" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.enrich-person-data", "method": "POST", "path": "/apis/v1/people-data-labs/enrich-person-data" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:e7f715e0a85662f2e4ed78604339a332976c4b946d6dbb21251b70681e153468" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/people-data-labs/enrich-person-data \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"email\": \"john.doe@example.com\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-enrich-person-data" } }, "/apis/v1/people-data-labs/identify-person-data": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.5503 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.identify-person-data", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lid": { "type": "string", "examples": [ "123456789" ], "description": "The person's LinkedIn ID. This is a numerical ID found in some LinkedIn URLs." }, "name": { "type": "string", "examples": [ "John Michael Doe" ], "description": "The full name of the person." }, "email": { "type": "string", "description": "An email address associated with the person.", "examples": [ "john.doe@example.com" ] }, "phone": { "type": "string", "examples": [ "+14155552671", "415-555-0110" ], "description": "A phone number associated with the person." }, "pretty": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, the JSON response is pretty-printed for easier human readability." }, "region": { "type": "string", "examples": [ "CA", "New York" ], "description": "The state, province, or region where the person resides or has resided." }, "school": { "type": "string", "examples": [ "University of California, Berkeley", "Stanford University" ], "description": "The name of an educational institution the person attended." }, "company": { "type": "string", "examples": [ "Acme Corp", "Globex Corporation" ], "description": "The name of a company where the person is or was employed." }, "profile": { "type": "string", "examples": [ "https://www.linkedin.com/in/johndoe", "https://twitter.com/janedoe" ], "description": "A social media profile URL associated with the person, e.g., a LinkedIn or Twitter profile URL." }, "locality": { "type": "string", "examples": [ "San Francisco", "New York" ], "description": "The city or locality where the person resides or has resided." }, "location": { "type": "string", "examples": [ "San Francisco, CA", "London" ], "description": "A general location query (e.g., 'San Francisco, CA', 'London, UK') associated with the person." }, "last_name": { "type": "string", "examples": [ "Doe" ], "description": "The last name of the person." }, "titlecase": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, returns all text values in title case (e.g., 'John Doe'). Otherwise, text is returned as is." }, "email_hash": { "type": "string", "examples": [ "55502f40dc8b7c769880b10874abc9d0", "8b21e5e33be1739a3eda69c1046d1385022b8817999b5a76e9300dd839cb2569" ], "description": "An MD5 or SHA-256 hash of the person's email address." }, "first_name": { "type": "string", "examples": [ "John" ], "description": "The first name of the person." }, "postal_code": { "type": "string", "examples": [ "94107", "10001" ], "description": "The postal or ZIP code where the person resides or has resided." }, "street_address": { "type": "string", "examples": [ "123 Main St, Anytown, USA" ], "description": "The street address where the person resides or has resided." }, "include_if_matched": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, the response will include a 'matched_on' attribute, an array of strings indicating which input parameters led to the match." } }, "required": [ "email" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_IDENTIFY_PERSON_DATA__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Identify person data", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.5503, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6523fa1e4bd6" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.identify-person-data", "method": "POST", "path": "/apis/v1/people-data-labs/identify-person-data" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:66d72d6575ec885a52c1ba7d98c4bd8f7d9b26f983da0dd21dd88f33fd5daa71" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/people-data-labs/identify-person-data \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"email\": \"john.doe@example.com\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-identify-person-data" } }, "/apis/v1/people-data-labs/people-enrich": { "get": { "description": "PDL's minimum-input rule, verbatim: profile OR email OR phone OR email_hash OR lid OR ((first_name AND last_name, or name) AND (locality OR region OR company OR school OR location OR postal_code)). A bare name is never enough on its own\n\n\nUsage-based billing; Default request estimate: $0.28 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.people-enrich", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Enrich a person by email, LinkedIn or name + company", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.28, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "33b348d54ca2" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.people-enrich", "method": "GET", "path": "/apis/v1/people-data-labs/people-enrich" }, "parameters": [ { "name": "company", "in": "query", "required": false, "schema": { "type": "string", "description": "employer name or domain", "examples": [ "peopledatalabs" ] } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string", "description": "strongest single identifier", "examples": [ "sean@peopledatalabs.com" ] } }, { "name": "email_hash", "in": "query", "required": false, "schema": { "type": "string", "description": "MD5 or SHA-256 of the email, when you cannot send it in the clear" } }, { "name": "first_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "last_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lid", "in": "query", "required": false, "schema": { "type": "string", "description": "LinkedIn numeric profile id" } }, { "name": "location", "in": "query", "required": false, "schema": { "type": "string", "description": "free-text location of the person" } }, { "name": "min_likelihood", "in": "query", "required": false, "schema": { "type": "integer", "description": "1-10 match-confidence floor; PDL returns 404 below it. 6+ is the usual production setting", "examples": [ 6 ] } }, { "name": "name", "in": "query", "required": false, "schema": { "type": "string", "description": "full name; use with company or location to disambiguate" } }, { "name": "phone", "in": "query", "required": false, "schema": { "type": "string", "description": "E.164 preferred" } }, { "name": "pretty", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "profile", "in": "query", "required": false, "schema": { "type": "string", "description": "social profile URL — LinkedIn, GitHub, Twitter, Facebook", "examples": [ "linkedin.com/in/seanthorne" ] } }, { "name": "required", "in": "query", "required": false, "schema": { "type": "string", "description": "fields the response must contain or it is treated as a miss, e.g. 'emails AND profiles'" } }, { "name": "school", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "titlecase", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "x-aisa-source": { "kind": "manual", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/", "fetched_at": "2026-11-07T11:52:30.302332+00:00", "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566", "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68", "converter": "scripts/prepare_treg_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.", "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18", "source_pages": [ { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py", "scope": "pathParams arrive as query; array enum and numeric bounds semantics" }, { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py", "scope": "Parameter declaration vocabulary and optional required flag" } ], "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978" }, "x-aisa-response-pending": { "operation_id": "people-data-labs.people-enrich", "path": "/apis/v1/people-data-labs/people-enrich", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-people-enrich" } }, "/apis/v1/people-data-labs/people-search": { "get": { "description": "exactly one of sql | query. GET caps `size` at 100, POST at 1000 — the only real difference between the two methods. Always set an explicit small size while iterating: you pay per record, so a size=100 call is a 100-credit call. Rate limit 10 req/min\n\n\nUsage-based billing; Default request estimate: $0.28 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.people-search", "parameters": [ { "examples": { "default": { "value": "resume" }, "minimal": { "value": "resume" } }, "in": "query", "name": "dataset", "required": true, "schema": { "enum": [ "resume" ], "minLength": 1, "type": "string", "description": "restrict to a licensed dataset, e.g. resume, email, phone" } }, { "name": "pretty", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "description": "Elasticsearch JSON query — the alternative to sql, more expressive" } }, { "name": "scroll_token", "in": "query", "required": false, "schema": { "type": "string", "description": "cursor from the previous response, for paging past 100" } }, { "examples": { "default": { "value": 1 }, "minimal": { "value": 1 } }, "in": "query", "name": "size", "required": true, "schema": { "maximum": 100, "minimum": 1, "type": "integer", "description": "records to return, 1-100, default 1 — THIS IS THE PRICE DIAL: you pay 1 credit per record" } }, { "name": "sql", "in": "query", "required": false, "schema": { "type": "string", "description": "SQL WHERE clause over the Person schema, e.g. \"SELECT * FROM person WHERE job_title_role='engineering' AND location_country='united states'\"" } }, { "name": "titlecase", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search people by title, company, skills or location", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.28, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "51edcf34ad47" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.people-search", "method": "GET", "path": "/apis/v1/people-data-labs/people-search" }, "x-aisa-source": { "kind": "manual", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/", "fetched_at": "2026-11-07T11:52:30.302332+00:00", "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566", "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68", "converter": "scripts/prepare_treg_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.", "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18", "source_pages": [ { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py", "scope": "pathParams arrive as query; array enum and numeric bounds semantics" }, { "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py", "scope": "Parameter declaration vocabulary and optional required flag" } ], "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978" }, "x-aisa-response-pending": { "operation_id": "people-data-labs.people-search", "path": "/apis/v1/people-data-labs/people-search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/people-data-labs/people-search?dataset=resume&size=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-people-search" } }, "/apis/v1/people-data-labs/people-search-elastic": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.2803 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.people-search-elastic", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "size": { "maximum": 100, "minimum": 1, "type": "integer", "description": "The number of matched person records to return. Must be an integer between 1 and 100, inclusive." }, "query": { "type": "string", "examples": [ "{\"bool\": {\"must\": [{\"term\": {\"job_company_industry\": \"computer software\"}}]}}", "{\"bool\": {\"must\": [{\"term\": {\"job_title_role\": \"engineer\"}}, {\"term\": {\"location_country\": \"united states\"}}]}}", "{\"bool\": {\"should\": [{\"match\": {\"full_name\": \"john\"}}, {\"match\": {\"first_name\": \"john\"}}]}}" ], "description": "Elasticsearch DSL query string (JSON object) for searching PDL person profiles. Provide just the DSL body (e.g., '{\"bool\": {...}}') without an outer 'query' wrapper.\n\nSupported query types: term, terms, match, match_phrase, prefix, wildcard, range, exists, bool (must/should/filter/must_not).\n\nALL field names MUST use snake_case, NOT camelCase.\n\nValid queryable fields include:\n- Name: full_name, first_name, last_name, middle_name\n- Job: job_title, job_title_role, job_title_class, job_company_name, job_company_industry, job_company_size, job_company_website, job_company_location_*\n- Location (NOT 'location' alone): location_country, location_region, location_locality, location_metro, location_geo\n- Social: linkedin_url, linkedin_username, linkedin_id, facebook_url, facebook_username, twitter_url, twitter_username, github_url, github_username\n- Nested profiles: profiles.network, profiles.url, profiles.username, profiles.id\n- Other: industry, skills, interests, countries, sex, work_email, personal_emails\n\nNOT queryable as fields (use 'dataset' parameter instead): email, phone.\n'experience_level' is not valid — use 'job_title_levels'. 'job_company_domain' is not valid — use 'job_company_website'. 'minimum_should_match' is not supported by PDL's API.\n\nFull field reference: https://docs.peopledatalabs.com/docs/fields-person" }, "pretty": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, formats the JSON response with human-readable indentation. Defaults to false." }, "dataset": { "enum": [ "resume" ], "type": "string", "description": "Specifies the dataset category to search against, filtering results to profiles that have the specified type of data available. Allowed values are: 'resume', 'email', 'phone', 'mobile_phone', 'street_address', 'consumer_social', 'developer', 'all'. Note: Use 'email' here to filter for profiles with email addresses available, rather than querying 'email' as a field in the query parameter." }, "titlecase": { "type": "boolean", "default": false, "examples": [ true, false ], "description": "If true, titlecases the person records in the response. Defaults to false." }, "scroll_token": { "type": "string", "default": "", "examples": [ "", "627445704a7f000001000000" ], "description": "A token returned in a previous search response. Provide this token to retrieve the next page of results. Omit or pass an empty string for the first request." } }, "required": [ "dataset", "query", "size" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "People Search with Elasticsearch", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.2803, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "90cdfb9fe722" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.people-search-elastic", "method": "POST", "path": "/apis/v1/people-data-labs/people-search-elastic" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:9a8e1bfd74fceb513b8dbcf2bf5a8ca579f5f30aeb112da7c60cd2575d7ca937" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-people-search-elastic" } }, "/apis/v1/people-data-labs/search-company-elastic": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.1003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.search-company-elastic", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "size": { "maximum": 100, "minimum": 1, "type": "integer", "description": "The number of matched company records to return. Must be an integer between 1 and 100, inclusive." }, "query": { "type": "string", "description": "Elasticsearch DSL query string (JSON object) for searching People Data Labs company profiles.\n\n**Supported query types:** term, terms, match, match_phrase, range, exists, bool (must/should/filter/must_not), wildcard, prefix.\n\n**Common Company Fields:** name, display_name, website, industry, employee_count, founded, size, location.country, location.region, location.locality, location.name, tags, linkedin_url, type, summary.\n\n**Location Searches:** Use nested fields: `location.country`, `location.region`, `location.locality`, `location.name`. Example: `{\"term\": {\"location.country\": \"united states\"}}`.\n\n**Important Restrictions:**\n- Do NOT include `size` or `scroll_token` in this query; use the dedicated request fields.\n- Do NOT use `minimum_should_match` in bool queries.\n\nFor complete field mappings, see https://docs.peopledatalabs.com/docs/company-search-api.", "examples": [ "{\"bool\": {\"must\": [{\"term\": {\"industry\": \"computer software\"}}]}}", "{\"range\": {\"employee_count\": {\"gte\": 5000}}}", "{\"bool\": {\"filter\": [{\"range\": {\"founded\": {\"gte\": 2010}}}, {\"term\": {\"location.country\": \"united states\"}}]}}", "{\"match\": {\"name\": \"google\"}}" ] }, "pretty": { "type": "boolean", "default": false, "examples": [ "true", "false" ], "description": "If true, the JSON response will be pretty-printed with human-readable indentation. Defaults to false." }, "titlecase": { "type": "boolean", "default": false, "examples": [ "true", "false" ], "description": "If true, an attempt will be made to title-case relevant text fields in the returned company records. Defaults to false." }, "scroll_token": { "type": "string", "default": "", "examples": [ "627275426f6b656e3432363935383437303232353438373930323030343934383635343734313337", "" ], "description": "A token returned from a previous search response, used for paginating through large result sets. Provide this token to retrieve the next batch of `size` records. Leave empty or omit for the first request." } }, "required": [ "query", "size" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Company Search with Elasticsearch", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1003, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4c29a37d0184" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.search-company-elastic", "method": "POST", "path": "/apis/v1/people-data-labs/search-company-elastic" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:b6879e490178e3eca6a4b092f116c2a61464610668f02c9b9706056d5957f4bf" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-search-company-elastic" } }, "/apis/v1/people-data-labs/search-company-post": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.1003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "people-data-labs.search-company-post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sql": { "type": "string", "examples": [ "SELECT * FROM company WHERE industry='computer software' AND website IS NOT NULL", "SELECT * FROM company WHERE employee_count >= 100 AND location.country='united states'" ], "description": "SQL query format: SELECT * FROM company WHERE [condition]. Either 'query' or 'sql' is required, but not both." }, "size": { "maximum": 100, "minimum": 1, "type": "integer", "description": "Batch size/max records returned. Must be between 1 and 100. Default: 1", "examples": [ 10, 50, 100 ] }, "query": { "type": "string", "description": "An Elasticsearch (v7.7) DSL query for searching company data. Must be a valid JSON object as a string. Either 'query' or 'sql' is required, but not both.", "examples": [ "{\"query\": {\"term\": {\"industry\": \"computer software\"}}}", "{\"bool\": {\"must\": [{\"term\": {\"industry\": \"computer software\"}}, {\"exists\": {\"field\": \"website\"}}]}}" ] }, "pretty": { "type": "boolean", "default": false, "description": "Human-readable JSON formatting. Default: false" }, "titlecase": { "type": "boolean", "default": false, "description": "Titlecase response text. Default: false" }, "from_offset": { "type": "integer", "maximum": 9999, "minimum": 0, "examples": [ 0, 100, 500 ], "description": "Legacy offset for pagination (0-9999), max 10000 records total. Use scroll_token for unlimited pagination." }, "scroll_token": { "type": "string", "examples": [ "104$14.278746" ], "description": "Pagination token from previous response for unlimited record retrieval. Use this for paginating beyond 10000 records." } }, "required": [ "query", "size" ] } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_POST__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Company Records (POST)", "tags": [ "People Data Labs" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "people", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1003, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3cbfd54d57d1" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "people-data-labs", "x-aisa-runtime-operation": { "operation_id": "people-data-labs.search-company-post", "method": "POST", "path": "/apis/v1/people-data-labs/search-company-post" }, "x-aisa-source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://connect.composio.dev/mcp", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "path_space": "public", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_pages": [ { "url": "https://connect.composio.dev/mcp", "scope": "Captured input schemas only; no current-source review asserted" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json", "scope": "Exact provider tool slug to public route mapping" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go", "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input" }, { "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go", "scope": "PublicResponse returns only the one completed tool response data as HTTP 200" } ], "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da" }, "content_hash": "sha256:0757ca720230e6f8df3bb2c900c4bbabacd933b5ffe98ad53d534a713cab5a4d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/people-data-labs/people-data-labs-search-company-post" } } } }