{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "",
    "title": "Ploid",
    "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/ploid/enrich",
      "/apis/v1/ploid/linkedin/companies/get",
      "/apis/v1/ploid/linkedin/companies/posts",
      "/apis/v1/ploid/linkedin/search",
      "/apis/v1/ploid/search"
    ],
    "x-aisa-document": {
      "facts_hash": "502ffb3237e95cbe5767114ce36ff07f994a3aa0b39368fc2d55edea1fd4cdb5",
      "generator_version": "3",
      "protocol_version": "1",
      "schema_version": "1",
      "composer_version": "27",
      "response_pending": [],
      "document_hash": "sha256:a613af79f14f939dcf40f2fe75d017204799a40daa0cfc10c7404b476fd36a47"
    },
    "x-aisa-plans": {
      "builder": 1.0,
      "display_plan": "payg",
      "payg": 1.0,
      "similarweb_payg": 1.0,
      "team": 1.0,
      "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
    },
    "x-aisa-provider": "ploid",
    "x-aisa-catalogs": {
      "ploid": {
        "title": "Ploid",
        "description": "",
        "x-aisa-document": {
          "facts_hash": "502ffb3237e95cbe5767114ce36ff07f994a3aa0b39368fc2d55edea1fd4cdb5",
          "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/ploid/enrich": {
      "post": {
        "description": "Ploid Enrich Person Contacts\n\n<!-- aisa-pricing:start -->\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "post_ploid_apis_v1_ploid_enrich",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": false,
                "properties": {
                  "enrichments": {
                    "description": "Which components to resolve: profile, email, phone. Default [\"profile\"]. Each is priced separately and only charged when actually found.",
                    "items": {
                      "enum": [
                        "profile",
                        "email",
                        "phone"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "minItems": 1,
                    "type": "array"
                  },
                  "first_name": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "last_name": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "linkedin_url": {
                    "description": "Canonical LinkedIn profile URL of the person to enrich — the identity anchor.",
                    "format": "uri",
                    "type": "string"
                  }
                },
                "required": [
                  "linkedin_url"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": true,
                      "minProperties": 1,
                      "properties": {
                        "data": {
                          "additionalProperties": true,
                          "type": "object"
                        }
                      },
                      "required": [
                        "data"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Normalized successful response"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Ploid Enrich Person Contacts",
        "tags": [
          "Ploid"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "supported": true
          },
          "mpp": false,
          "x402": false
        },
        "x-aisa-category": "ploid",
        "x-aisa-contract-source": "handler",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "estimate_source": "unavailable",
          "estimate_unavailable_reason": "reference_request_unavailable",
          "evidence_source": "response_body"
        },
        "x-aisa-response-passthrough": false,
        "x-aisa-revision": {
          "customer_pricing_ref": "2fcd31d349d5",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "f346f569d3d5"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "ploid",
        "x-aisa-runtime-operation": {
          "operation_id": "post_ploid_apis_v1_ploid_enrich",
          "method": "POST",
          "path": "/apis/v1/ploid/enrich"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/ploid/post_ploid_apis_v1_ploid_enrich"
      }
    },
    "/apis/v1/ploid/linkedin/companies/get": {
      "post": {
        "description": "Ploid LinkedIn Company\n\n<!-- aisa-pricing:start -->\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "post_ploid_apis_v1_ploid_linkedin_companies_get",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": false,
                "allOf": [
                  {
                    "anyOf": [
                      {
                        "required": [
                          "url"
                        ]
                      },
                      {
                        "required": [
                          "universalName"
                        ]
                      },
                      {
                        "required": [
                          "search"
                        ]
                      }
                    ]
                  }
                ],
                "properties": {
                  "search": {
                    "description": "Free-text company name to resolve.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "universalName": {
                    "description": "The company's LinkedIn universal name (URL slug).",
                    "minLength": 1,
                    "type": "string"
                  },
                  "url": {
                    "description": "LinkedIn company URL.",
                    "minLength": 1,
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": true,
                      "minProperties": 1,
                      "properties": {
                        "data": {
                          "additionalProperties": true,
                          "type": "object"
                        }
                      },
                      "required": [
                        "data"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Normalized successful response"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Ploid LinkedIn Company",
        "tags": [
          "Ploid"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "supported": true
          },
          "mpp": false,
          "x402": false
        },
        "x-aisa-category": "ploid",
        "x-aisa-contract-source": "handler",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "estimate_source": "unavailable",
          "estimate_unavailable_reason": "reference_request_unavailable",
          "evidence_source": "response_body"
        },
        "x-aisa-response-passthrough": false,
        "x-aisa-revision": {
          "customer_pricing_ref": "efe252cc93b6",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "022ec2753c51"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "ploid",
        "x-aisa-runtime-operation": {
          "operation_id": "post_ploid_apis_v1_ploid_linkedin_companies_get",
          "method": "POST",
          "path": "/apis/v1/ploid/linkedin/companies/get"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/ploid/post_ploid_apis_v1_ploid_linkedin_companies_get"
      }
    },
    "/apis/v1/ploid/linkedin/companies/posts": {
      "post": {
        "description": "Ploid LinkedIn Company Posts\n\n<!-- aisa-pricing:start -->\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "post_ploid_apis_v1_ploid_linkedin_companies_posts",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": false,
                "allOf": [
                  {
                    "anyOf": [
                      {
                        "required": [
                          "company"
                        ]
                      },
                      {
                        "required": [
                          "companyId"
                        ]
                      },
                      {
                        "required": [
                          "companyUniversalName"
                        ]
                      }
                    ]
                  }
                ],
                "properties": {
                  "company": {
                    "description": "LinkedIn company URL or name.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "companyId": {
                    "description": "The company's socialId from a previous read.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "companyUniversalName": {
                    "description": "The company's LinkedIn universal name (URL slug).",
                    "minLength": 1,
                    "type": "string"
                  },
                  "page": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "paginationToken": {
                    "description": "Continuation token from a previous response.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "postedLimit": {
                    "description": "Recency window for the posts, e.g. '1 month'.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "scrapePostedLimit": {
                    "minLength": 1,
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": true,
                      "minProperties": 1,
                      "properties": {
                        "data": {
                          "additionalProperties": true,
                          "type": "object"
                        }
                      },
                      "required": [
                        "data"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Normalized successful response"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Ploid LinkedIn Company Posts",
        "tags": [
          "Ploid"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "supported": true
          },
          "mpp": false,
          "x402": false
        },
        "x-aisa-category": "ploid",
        "x-aisa-contract-source": "handler",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "estimate_source": "unavailable",
          "estimate_unavailable_reason": "reference_request_unavailable",
          "evidence_source": "response_body"
        },
        "x-aisa-response-passthrough": false,
        "x-aisa-revision": {
          "customer_pricing_ref": "759294567d4e",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "36a5cf3a4be3"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "ploid",
        "x-aisa-runtime-operation": {
          "operation_id": "post_ploid_apis_v1_ploid_linkedin_companies_posts",
          "method": "POST",
          "path": "/apis/v1/ploid/linkedin/companies/posts"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/ploid/post_ploid_apis_v1_ploid_linkedin_companies_posts"
      }
    },
    "/apis/v1/ploid/linkedin/search": {
      "post": {
        "description": "Ploid LinkedIn People Search\n\n<!-- aisa-pricing:start -->\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "post_ploid_apis_v1_ploid_linkedin_search",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": false,
                "properties": {
                  "cursor": {
                    "description": "Pagination cursor from a previous response's data.cursor.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "filters": {
                    "description": "Structured filters; each accepts one value or a list.",
                    "properties": {
                      "currentCompany": {
                        "anyOf": [
                          {
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "items": {
                              "minLength": 1,
                              "type": "string"
                            },
                            "type": "array"
                          }
                        ]
                      },
                      "keywords": {
                        "maxLength": 500,
                        "type": "string"
                      },
                      "location": {
                        "anyOf": [
                          {
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "items": {
                              "minLength": 1,
                              "type": "string"
                            },
                            "type": "array"
                          }
                        ]
                      },
                      "school": {
                        "anyOf": [
                          {
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "items": {
                              "minLength": 1,
                              "type": "string"
                            },
                            "type": "array"
                          }
                        ]
                      },
                      "title": {
                        "anyOf": [
                          {
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "items": {
                              "minLength": 1,
                              "type": "string"
                            },
                            "type": "array"
                          }
                        ]
                      }
                    },
                    "type": "object"
                  },
                  "limit": {
                    "description": "Max people to return. Default 25, max 100.",
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": true,
                      "minProperties": 1,
                      "properties": {
                        "data": {
                          "additionalProperties": true,
                          "type": "object"
                        }
                      },
                      "required": [
                        "data"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Normalized successful response"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Ploid LinkedIn People Search",
        "tags": [
          "Ploid"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "supported": true
          },
          "mpp": false,
          "x402": false
        },
        "x-aisa-category": "ploid",
        "x-aisa-contract-source": "handler",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "estimate_source": "unavailable",
          "estimate_unavailable_reason": "reference_request_unavailable",
          "evidence_source": "response_body"
        },
        "x-aisa-response-passthrough": false,
        "x-aisa-revision": {
          "customer_pricing_ref": "9fbbe8a1422f",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "b144c9a35705"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "ploid",
        "x-aisa-runtime-operation": {
          "operation_id": "post_ploid_apis_v1_ploid_linkedin_search",
          "method": "POST",
          "path": "/apis/v1/ploid/linkedin/search"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/ploid/post_ploid_apis_v1_ploid_linkedin_search"
      }
    },
    "/apis/v1/ploid/search": {
      "post": {
        "description": "Ploid People Search\n\n<!-- aisa-pricing:start -->\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "post_ploid_apis_v1_ploid_search",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": false,
                "properties": {
                  "contents": {
                    "description": "Which person fields to include on each result.",
                    "properties": {
                      "fields": {
                        "items": {
                          "enum": [
                            "linkedin",
                            "title",
                            "company",
                            "location",
                            "name"
                          ],
                          "type": "string"
                        },
                        "type": "array"
                      }
                    },
                    "type": "object"
                  },
                  "filters": {
                    "description": "Optional structured narrowing filters.",
                    "properties": {
                      "company": {
                        "type": "string"
                      },
                      "location": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "num_results": {
                    "description": "Max people to return. Default 25, max 100. Billing is per started block of 10 returned results.",
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "query": {
                    "description": "Who to find, in plain English — e.g. 'software engineers at fintech companies in San Francisco'.",
                    "maxLength": 4000,
                    "minLength": 1,
                    "type": "string"
                  },
                  "type": {
                    "description": "instant = retrieve quickly; auto (default) = retrieve and rerank; deep = apply a deeper grading path.",
                    "enum": [
                      "instant",
                      "auto",
                      "deep"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "query"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": true,
                      "minProperties": 1,
                      "properties": {
                        "data": {
                          "additionalProperties": true,
                          "type": "object"
                        }
                      },
                      "required": [
                        "data"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Normalized successful response"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Ploid People Search",
        "tags": [
          "Ploid"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "supported": true
          },
          "mpp": false,
          "x402": false
        },
        "x-aisa-category": "ploid",
        "x-aisa-contract-source": "handler",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "estimate_source": "unavailable",
          "estimate_unavailable_reason": "reference_request_unavailable",
          "evidence_source": "response_body"
        },
        "x-aisa-response-passthrough": false,
        "x-aisa-revision": {
          "customer_pricing_ref": "141f6f22ae84",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "7c5861b94a04"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "ploid",
        "x-aisa-runtime-operation": {
          "operation_id": "post_ploid_apis_v1_ploid_search",
          "method": "POST",
          "path": "/apis/v1/ploid/search"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/ploid/post_ploid_apis_v1_ploid_search"
      }
    }
  }
}