{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } }, "schemas": { "Manual576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1": { "type": "object", "properties": { "profile_url": { "type": "string", "minLength": 1, "description": "Business company profile URL or identifier." }, "company_name": { "type": "string", "minLength": 1, "description": "Company name when its domain or profile URL is unavailable." }, "company_domain": { "type": "string", "minLength": 1, "description": "Company domain, such as example.com." } } }, "Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__630fbf5c6c912f1a" }, "Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__630fbf5c6c912f1a": { "type": "object", "properties": { "url": { "type": "string" }, "b2b_url": { "type": "string" }, "hashtag": { "type": "string" }, "message": { "type": "string" }, "revenue": { "type": "number" }, "tagline": { "type": "string" }, "industry": { "type": "string" }, "logo_url": { "type": "string" }, "companyId": { "type": "integer" }, "foundedOn": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__7f106c45c5b23b2b" }, "locations": { "type": "array", "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__20b6b1d8f0c1ac14" } }, "active_web": { "type": "boolean" }, "websiteUrl": { "type": "string" }, "companyName": { "type": "string" }, "competitors": { "type": "array", "items": { "type": "string" } }, "data_source": { "type": "string" }, "description": { "type": "string" }, "email_found": { "type": "boolean" }, "headquarter": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__20b6b1d8f0c1ac14" }, "twitter_url": { "type": "string" }, "facebook_url": { "type": "string" }, "founded_year": { "type": "string" }, "linkedin_url": { "type": "string" }, "mobile_found": { "type": "boolean" }, "specialities": { "type": "array", "items": { "type": "string" } }, "stock_ticker": { "type": "string" }, "employeeCount": { "type": "integer" }, "followerCount": { "type": "integer" }, "total_funding": { "type": "string" }, "universalName": { "type": "string" }, "employee_range": { "type": "string" }, "funding_rounds": { "type": "integer" }, "has_tech_stack": { "type": "boolean" }, "b2b_growth_rate": { "type": "number" }, "b2b_profile_url": { "type": "string" }, "credits_consumed": { "type": "number" }, "ownership_status": { "type": "string" }, "last_funding_date": { "type": "string" }, "revenue_formatted": { "type": "string" }, "acquisitions_count": { "type": "integer" }, "employeeCountRange": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__511cd78cef691d31" }, "last_funding_round": { "type": "string" }, "last_funding_amount": { "type": "number" }, "funding_investor_count": { "type": "integer" } }, "additionalProperties": true }, "Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__7f106c45c5b23b2b": { "type": "object", "properties": { "day": { "type": "integer", "maximum": 31, "minimum": 1 }, "year": { "type": "integer" }, "month": { "type": "integer", "maximum": 12, "minimum": 1 } } }, "Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__20b6b1d8f0c1ac14": { "type": "object", "properties": { "city": { "type": "string" }, "line1": { "type": "string" }, "line2": { "type": "string" }, "country": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "postalCode": { "type": "string" }, "description": { "type": "string" }, "headquarter": { "type": "boolean" }, "localizedName": { "type": "string" }, "geographicArea": { "type": "string" } } }, "Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__511cd78cef691d31": { "type": "object", "properties": { "end": { "type": "integer" }, "start": { "type": "integer" } } } }, "responses": {}, "parameters": {}, "examples": {}, "requestBodies": {}, "headers": {}, "links": {}, "callbacks": {}, "pathItems": {} }, "info": { "description": "", "title": "LeadMagic", "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/leadmagic/b2b-ads-search", "/apis/v1/leadmagic/b2b-profile", "/apis/v1/leadmagic/b2b-profile-email", "/apis/v1/leadmagic/companies-enrich", "/apis/v1/leadmagic/companies-search-v3", "/apis/v1/leadmagic/company-funding", "/apis/v1/leadmagic/competitors-search", "/apis/v1/leadmagic/employee-finder", "/apis/v1/leadmagic/enrich-company-v1", "/apis/v1/leadmagic/google-ads-search", "/apis/v1/leadmagic/job-change-detector", "/apis/v1/leadmagic/jobs-finder", "/apis/v1/leadmagic/jobs-search-v3", "/apis/v1/leadmagic/meta-ads-search", "/apis/v1/leadmagic/people-email-find", "/apis/v1/leadmagic/people-email-verify", "/apis/v1/leadmagic/people-enrich", "/apis/v1/leadmagic/people-phone-find", "/apis/v1/leadmagic/people-search", "/apis/v1/leadmagic/personal-email-finder", "/apis/v1/leadmagic/role-finder", "/apis/v1/leadmagic/technographics" ], "x-aisa-document": { "facts_hash": "5deb1b0a5edc249b6c389685a3ef109ad7e0150396ecbd2b8d4896e17effee94", "generator_version": "3", "protocol_version": "1", "schema_version": "1", "composer_version": "28", "response_pending": [ { "operation_id": "leadmagic.b2b-ads-search", "path": "/apis/v1/leadmagic/b2b-ads-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.b2b-profile", "path": "/apis/v1/leadmagic/b2b-profile", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.b2b-profile-email", "path": "/apis/v1/leadmagic/b2b-profile-email", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.companies-enrich", "path": "/apis/v1/leadmagic/companies-enrich", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.companies-search-v3", "path": "/apis/v1/leadmagic/companies-search-v3", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.company-funding", "path": "/apis/v1/leadmagic/company-funding", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.competitors-search", "path": "/apis/v1/leadmagic/competitors-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.employee-finder", "path": "/apis/v1/leadmagic/employee-finder", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.google-ads-search", "path": "/apis/v1/leadmagic/google-ads-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.job-change-detector", "path": "/apis/v1/leadmagic/job-change-detector", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.jobs-finder", "path": "/apis/v1/leadmagic/jobs-finder", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.jobs-search-v3", "path": "/apis/v1/leadmagic/jobs-search-v3", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.meta-ads-search", "path": "/apis/v1/leadmagic/meta-ads-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.people-email-find", "path": "/apis/v1/leadmagic/people-email-find", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.people-email-verify", "path": "/apis/v1/leadmagic/people-email-verify", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.people-enrich", "path": "/apis/v1/leadmagic/people-enrich", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.people-phone-find", "path": "/apis/v1/leadmagic/people-phone-find", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.personal-email-finder", "path": "/apis/v1/leadmagic/personal-email-finder", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.role-finder", "path": "/apis/v1/leadmagic/role-finder", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "leadmagic.technographics", "path": "/apis/v1/leadmagic/technographics", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" } ], "document_hash": "sha256:8f17e9fc701ee86bc73ff1496bc612e600209192b96a4672ba056cd99d00ef17" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "leadmagic", "x-aisa-catalogs": { "leadmagic": { "title": "LeadMagic", "description": "", "x-aisa-document": { "facts_hash": "5deb1b0a5edc249b6c389685a3ef109ad7e0150396ecbd2b8d4896e17effee94", "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/leadmagic/b2b-ads-search": { "post": { "description": "at least one of company_domain | company_name is required. Cost VERIFIED 2026-08-13 as 0.2 credit per ad + a 0.2 base (= 0.2 x (ads+1)): a 5-ad response cost 1.20 credits, a 24-ad response 5.00. Responses appear to cap near 24 ads, so a full page is ~5 credits. The response header X-Credits-Max-Cost shows the reserved amount before committing\n\n\nUsage-based billing; Default request estimate: $0.01 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.b2b-ads-search", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" }, "limit": { "maximum": 10, "minimum": 1, "type": "integer" } }, "required": [ "limit" ] } } } }, "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "A company's LinkedIn ads by domain or name — creatives", "tags": [ "LeadMagic" ], "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.01, "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": "b9107cb2e059" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.b2b-ads-search", "method": "POST", "path": "/apis/v1/leadmagic/b2b-ads-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": "leadmagic.b2b-ads-search", "path": "/apis/v1/leadmagic/b2b-ads-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-b2b-ads-search" } }, "/apis/v1/leadmagic/b2b-profile": { "post": { "description": "at least one of work_email | personal_email is required\n\n\nUsage-based billing; Default request estimate: $0.25 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.b2b-profile", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Reverse email lookup — the person's profile URL", "tags": [ "LeadMagic" ], "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.25, "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": "b3966a1fa086" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.b2b-profile", "method": "POST", "path": "/apis/v1/leadmagic/b2b-profile" }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "work_email": { "type": "string", "examples": [ "jane@leadmagic.io" ] }, "personal_email": { "type": "string" } } } } } }, "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": "leadmagic.b2b-profile", "path": "/apis/v1/leadmagic/b2b-profile", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-b2b-profile" } }, "/apis/v1/leadmagic/b2b-profile-email": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.125 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.b2b-profile-email", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Find a work email from a profile URL", "tags": [ "LeadMagic" ], "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.125, "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": "c6cc4d702665" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.b2b-profile-email", "method": "POST", "path": "/apis/v1/leadmagic/b2b-profile-email" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_url": { "type": "string", "description": "full profile URL or just the username", "examples": [ "https://www.linkedin.com/in/example" ] } }, "required": [ "profile_url" ] } } } }, "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": "leadmagic.b2b-profile-email", "path": "/apis/v1/leadmagic/b2b-profile-email", "method": "POST", "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 POST \\\n --url https://api.aisa.one/apis/v1/leadmagic/b2b-profile-email \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"profile_url\": \"https://www.linkedin.com/in/example\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-b2b-profile-email" } }, "/apis/v1/leadmagic/companies-enrich": { "post": { "description": "at least one of company_domain | profile_url | company_name. Named 'company-search' but it resolves ONE company, so it is an enrichment call rather than a filtered search\n\n\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.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 domain or name — headcount, revenue", "tags": [ "LeadMagic" ], "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.025, "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": "52233e46bbb9" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.companies-enrich", "method": "POST", "path": "/apis/v1/leadmagic/companies-enrich" }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "description": "website domain — the most accurate identifier", "examples": [ "leadmagic.io" ] }, "profile_url": { "type": "string", "description": "company profile URL or slug" }, "company_name": { "type": "string", "description": "company name; least precise of the three" } } } } } }, "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": "leadmagic.companies-enrich", "path": "/apis/v1/leadmagic/companies-enrich", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-companies-enrich" } }, "/apis/v1/leadmagic/companies-search-v3": { "post": { "description": "one-off lookup via company_domain/website/company_name/linkedin_url, OR broad discovery via the firmographic/technographic/funding filters; also nestable under company_filters (alias: filters)\n\n\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.companies-search-v3", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "description": "single-company lookup", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" }, "linkedin_url": { "type": "string" }, "industries": { "type": "array", "items": { "type": "string" } }, "min_employees": { "type": "integer" }, "max_employees": { "type": "integer" }, "country_codes": { "type": "array", "items": { "type": "string" } }, "tech_stack": { "type": "array", "items": { "type": "string" } }, "sort_by": { "type": "string", "description": "linkedin_followers | total_funding | linkedin_employee_count | revenue_min | revenue_max | founded_year | total_contacts" }, "limit": { "maximum": 25, "minimum": 1, "type": "integer", "description": "max 50" }, "cursor": { "type": "string", "description": "opaque pagination token from a previous response" } }, "required": [ "limit" ] } } } }, "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search companies by firmographics, tech stack or funding", "tags": [ "LeadMagic" ], "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.025, "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": "b1532c100a4b" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.companies-search-v3", "method": "POST", "path": "/apis/v1/leadmagic/companies-search-v3" }, "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": "leadmagic.companies-search-v3", "path": "/apis/v1/leadmagic/companies-search-v3", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-companies-search-v3" } }, "/apis/v1/leadmagic/company-funding": { "post": { "description": "at least one of company_domain | company_name is required\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": "leadmagic.company-funding", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "A company's funding history by domain or name — investors", "tags": [ "LeadMagic" ], "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": "24206204971e" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.company-funding", "method": "POST", "path": "/apis/v1/leadmagic/company-funding" }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" } } } } } }, "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": "leadmagic.company-funding", "path": "/apis/v1/leadmagic/company-funding", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-company-funding" } }, "/apis/v1/leadmagic/competitors-search": { "post": { "description": "at least one of company_domain | company_url | company_name is required\n\n\nUsage-based billing; Default request estimate: $0.125 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.competitors-search", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Find a company's competitors by domain or name", "tags": [ "LeadMagic" ], "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.125, "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": "68bc47447ece" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.competitors-search", "method": "POST", "path": "/apis/v1/leadmagic/competitors-search" }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "examples": [ "leadmagic.io" ] }, "company_url": { "type": "string" }, "company_name": { "type": "string" } } } } } }, "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": "leadmagic.competitors-search", "path": "/apis/v1/leadmagic/competitors-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-competitors-search" } }, "/apis/v1/leadmagic/employee-finder": { "post": { "description": "at least one of company_domain | company_name is required\n\n\nUsage-based billing; Default request estimate: $0.00125 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.employee-finder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" }, "limit": { "maximum": 10, "minimum": 1, "type": "integer" } }, "required": [ "limit" ] } } } }, "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List employees at a company by domain or name", "tags": [ "LeadMagic" ], "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.00125, "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": "b24a252e09b4" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.employee-finder", "method": "POST", "path": "/apis/v1/leadmagic/employee-finder" }, "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": "leadmagic.employee-finder", "path": "/apis/v1/leadmagic/employee-finder", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-employee-finder" } }, "/apis/v1/leadmagic/enrich-company-v1": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.0203 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.enrich-company-v1", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_url": { "type": "string", "minLength": 1, "description": "Business company profile URL or identifier." }, "company_name": { "type": "string", "minLength": 1, "description": "Company name when its domain or profile URL is unavailable." }, "company_domain": { "type": "string", "minLength": 1, "description": "Company domain, such as example.com." } } } } } }, "responses": { "200": { "description": "Tool result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_LEADMAGIC_ENRICH_COMPANY_V1__output__public_data" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Enrich Company V1", "tags": [ "LeadMagic" ], "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.0203, "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": "4e4aa24718c9" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.enrich-company-v1", "method": "POST", "path": "/apis/v1/leadmagic/enrich-company-v1" }, "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:8728274451ea27ae0695ba22c498b25f20939f0d8941effa2628d7996dde2a45" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-enrich-company-v1" } }, "/apis/v1/leadmagic/google-ads-search": { "post": { "description": "at least one of company_domain | company_name is required\n\n\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.google-ads-search", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" }, "limit": { "maximum": 10, "minimum": 1, "type": "integer" } }, "required": [ "limit" ] } } } }, "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "A company's Google Ads by domain or name", "tags": [ "LeadMagic" ], "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.025, "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": "bd58bb18d170" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.google-ads-search", "method": "POST", "path": "/apis/v1/leadmagic/google-ads-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": "leadmagic.google-ads-search", "path": "/apis/v1/leadmagic/google-ads-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-google-ads-search" } }, "/apis/v1/leadmagic/job-change-detector": { "post": { "description": "profile_url is required; at least one of company_domain | company_name is also required\n\n\nUsage-based billing; Default request estimate: $0.075 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.job-change-detector", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Detect a job change from a profile URL and last company", "tags": [ "LeadMagic" ], "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.075, "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": "602f0f7f7ef3" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.job-change-detector", "method": "POST", "path": "/apis/v1/leadmagic/job-change-detector" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_url": { "type": "string", "examples": [ "https://www.linkedin.com/in/example" ] }, "company_domain": { "type": "string", "description": "the previously known employer", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" } }, "required": [ "profile_url" ] } } } }, "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": "leadmagic.job-change-detector", "path": "/apis/v1/leadmagic/job-change-detector", "method": "POST", "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 POST \\\n --url https://api.aisa.one/apis/v1/leadmagic/job-change-detector \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"profile_url\": \"https://www.linkedin.com/in/example\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-job-change-detector" } }, "/apis/v1/leadmagic/jobs-finder": { "post": { "description": "every field is optional — set per_page deliberately to control cost\n\n\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.jobs-finder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_title": { "type": "string", "examples": [ "Sales Director" ] }, "company_name": { "type": "string" }, "company_website": { "type": "string", "examples": [ "leadmagic.io" ] }, "min_employees": { "type": "integer" }, "max_employees": { "type": "integer" }, "has_remote": { "type": "boolean" }, "location": { "type": "string" }, "posted_within": { "type": "integer", "description": "days", "examples": [ 30 ] }, "page": { "type": "integer", "examples": [ 1 ] }, "per_page": { "maximum": 10, "minimum": 1, "type": "integer" } }, "required": [ "per_page" ] } } } }, "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search job postings by company, location or date (basic)", "tags": [ "LeadMagic" ], "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.025, "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": "524d87f29d38" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.jobs-finder", "method": "POST", "path": "/apis/v1/leadmagic/jobs-finder" }, "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": "leadmagic.jobs-finder", "path": "/apis/v1/leadmagic/jobs-finder", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-jobs-finder" } }, "/apis/v1/leadmagic/jobs-search-v3": { "post": { "description": "every field is optional; an empty body queries the whole index — always set limit deliberately\n\n\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.jobs-search-v3", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "titles.include": { "type": "array", "items": { "type": "string" }, "examples": [ [ "Software Engineer" ] ] }, "companies.include": { "type": "array", "items": { "type": "string" }, "description": "company domains", "examples": [ [ "leadmagic.io" ] ] }, "location.countries": { "type": "array", "items": { "type": "string" }, "examples": [ [ "US" ] ] }, "seniority": { "type": "array", "items": { "type": "string" } }, "hasRemote": { "type": "boolean" }, "postedWithin": { "type": "integer", "description": "days", "examples": [ 30 ] }, "limit": { "maximum": 25, "minimum": 1, "type": "integer" }, "cursor": { "type": "string", "description": "opaque pagination token" }, "dryRun": { "type": "boolean" }, "includeDescription": { "enum": [ false ], "type": "boolean" }, "includeFacets": { "enum": [ false ], "type": "boolean" }, "mode": { "enum": [ "fast" ], "minLength": 1, "type": "string" }, "totalMode": { "enum": [ "none" ], "minLength": 1, "type": "string" } }, "required": [ "includeDescription", "includeFacets", "limit", "mode", "totalMode" ] } } } }, "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search job postings — titles, companies, hiring signals", "tags": [ "LeadMagic" ], "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.025, "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": "b11298b3cbe1" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.jobs-search-v3", "method": "POST", "path": "/apis/v1/leadmagic/jobs-search-v3" }, "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": "leadmagic.jobs-search-v3", "path": "/apis/v1/leadmagic/jobs-search-v3", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-jobs-search-v3" } }, "/apis/v1/leadmagic/meta-ads-search": { "post": { "description": "at least one of company_domain | company_name is required\n\n\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.meta-ads-search", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" }, "limit": { "maximum": 10, "minimum": 1, "type": "integer" } }, "required": [ "limit" ] } } } }, "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "A company's Meta (Facebook/Instagram) ads by domain", "tags": [ "LeadMagic" ], "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.025, "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": "a68b3cfdaaef" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.meta-ads-search", "method": "POST", "path": "/apis/v1/leadmagic/meta-ads-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": "leadmagic.meta-ads-search", "path": "/apis/v1/leadmagic/meta-ads-search", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-meta-ads-search" } }, "/apis/v1/leadmagic/people-email-find": { "post": { "description": "at least one NAME field and at least one COMPANY field are both required — a name alone or a domain alone is rejected. The response also carries company enrichment and employment verification at no extra cost\n\n\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.people-email-find", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Find a person's work email by name and company", "tags": [ "LeadMagic" ], "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.025, "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": "02ade6ea8f13" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.people-email-find", "method": "POST", "path": "/apis/v1/leadmagic/people-email-find" }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "first_name": { "type": "string", "description": "use with last_name; alternatively send full_name", "examples": [ "Jane" ] }, "last_name": { "type": "string", "examples": [ "Doe" ] }, "full_name": { "type": "string", "description": "alternative to first_name + last_name" }, "domain": { "type": "string", "description": "the company's domain — more accurate than company_name", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string", "description": "company name, when you don't know the domain" } } } } } }, "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": "leadmagic.people-email-find", "path": "/apis/v1/leadmagic/people-email-find", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-people-email-find" } }, "/apis/v1/leadmagic/people-email-verify": { "post": { "description": "returns email_status (valid | invalid | unknown), is_domain_catch_all, the MX provider and gateway, plus company enrichment thrown in free\n\n\nUsage-based billing; Default request estimate: $0.00625 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.people-email-verify", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Verify email — catch-all and MX provider", "tags": [ "LeadMagic" ], "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.00625, "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": "710fbcb730cf" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.people-email-verify", "method": "POST", "path": "/apis/v1/leadmagic/people-email-verify" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "the address to validate", "examples": [ "jane@leadmagic.io" ] } }, "required": [ "email" ] } } } }, "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": "leadmagic.people-email-verify", "path": "/apis/v1/leadmagic/people-email-verify", "method": "POST", "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 POST \\\n --url https://api.aisa.one/apis/v1/leadmagic/people-email-verify \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"email\": \"jane@leadmagic.io\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-people-email-verify" } }, "/apis/v1/leadmagic/people-enrich": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.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 profile URL — role, work history", "tags": [ "LeadMagic" ], "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.025, "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": "a2175b1d1266" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.people-enrich", "method": "POST", "path": "/apis/v1/leadmagic/people-enrich" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_url": { "type": "string", "description": "full professional profile URL or just the username", "examples": [ "https://www.linkedin.com/in/example" ] }, "extended_response": { "type": "boolean", "description": "adds the profile image URL; default false" } }, "required": [ "profile_url" ] } } } }, "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": "leadmagic.people-enrich", "path": "/apis/v1/leadmagic/people-enrich", "method": "POST", "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 POST \\\n --url https://api.aisa.one/apis/v1/leadmagic/people-enrich \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"profile_url\": \"https://www.linkedin.com/in/example\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-people-enrich" } }, "/apis/v1/leadmagic/people-phone-find": { "post": { "description": "at least one identifier is required. This is the most expensive endpoint in the file at 5 credits a hit — and mobile numbers are regulated contact data (TCPA / CASL), so treat the result accordingly\n\n\nUsage-based billing; Default request estimate: $0.125 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.people-phone-find", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Find a person's mobile number by profile URL or email", "tags": [ "LeadMagic" ], "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.125, "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": "18de601b0bee" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.people-phone-find", "method": "POST", "path": "/apis/v1/leadmagic/people-phone-find" }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_url": { "type": "string", "description": "professional profile URL", "examples": [ "https://www.linkedin.com/in/example" ] }, "work_email": { "type": "string", "description": "the person's work email" }, "personal_email": { "type": "string", "description": "the person's personal email" } } } } } }, "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": "leadmagic.people-phone-find", "path": "/apis/v1/leadmagic/people-phone-find", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-people-phone-find" } }, "/apis/v1/leadmagic/personal-email-finder": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.05 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.personal-email-finder", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Find a personal email from a profile URL", "tags": [ "LeadMagic" ], "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.05, "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": "f8bb146a737e" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.personal-email-finder", "method": "POST", "path": "/apis/v1/leadmagic/personal-email-finder" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_url": { "type": "string", "examples": [ "https://www.linkedin.com/in/example" ] } }, "required": [ "profile_url" ] } } } }, "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": "leadmagic.personal-email-finder", "path": "/apis/v1/leadmagic/personal-email-finder", "method": "POST", "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 POST \\\n --url https://api.aisa.one/apis/v1/leadmagic/personal-email-finder \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"profile_url\": \"https://www.linkedin.com/in/example\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-personal-email-finder" } }, "/apis/v1/leadmagic/role-finder": { "post": { "description": "job_title is required; at least one of company_domain | company_name is also required\n\n\nUsage-based billing; Default request estimate: $0.05 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.role-finder", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Find one person at a company by job title", "tags": [ "LeadMagic" ], "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.05, "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": "37db5de12a02" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.role-finder", "method": "POST", "path": "/apis/v1/leadmagic/role-finder" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_title": { "type": "string", "examples": [ "VP of Sales" ] }, "company_domain": { "type": "string", "description": "preferred for accuracy", "examples": [ "leadmagic.io" ] }, "company_name": { "type": "string" } }, "required": [ "job_title" ] } } } }, "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": "leadmagic.role-finder", "path": "/apis/v1/leadmagic/role-finder", "method": "POST", "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 POST \\\n --url https://api.aisa.one/apis/v1/leadmagic/role-finder \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"job_title\": \"VP of Sales\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-role-finder" } }, "/apis/v1/leadmagic/technographics": { "post": { "description": "\nUsage-based billing; Default request estimate: $0.025 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "leadmagic.technographics", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Detect a company's tech stack by domain", "tags": [ "LeadMagic" ], "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.025, "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": "3f9094faa001" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider", "x-aisa-catalog-id": "leadmagic", "x-aisa-runtime-operation": { "operation_id": "leadmagic.technographics", "method": "POST", "path": "/apis/v1/leadmagic/technographics" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_domain": { "type": "string", "examples": [ "leadmagic.io" ] } }, "required": [ "company_domain" ] } } } }, "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": "leadmagic.technographics", "path": "/apis/v1/leadmagic/technographics", "method": "POST", "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 POST \\\n --url https://api.aisa.one/apis/v1/leadmagic/technographics \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"company_domain\": \"leadmagic.io\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/leadmagic/leadmagic-technographics" } } } }