{
  "openapi": "3.0.3",
  "info": {
    "title": "LinkedInDataAPI \u2014 No-Cookie B2B Profile, Company & Decision-Maker Intelligence API",
    "version": "1.0.0",
    "description": "Enterprise REST API for structured B2B person profiles, company firmographics, domain-to-company enrichment, decision-maker people search, executive activity feeds, and active company hiring signals. Zero LinkedIn cookies (`li_at`), zero browser proxies, and drop-in compatibility aliases for Proxycurl (`/api/v2/linkedin`) and Clearbit.\n\n**Authentication** \u2014 pass your API key in the `x-api-key` request header (`Authorization: Bearer b2b_live_...` is also supported).\n\n**Unified Credit System** \u2014 `$1 = 10,000 Credits` (`1 Credit = $0.0001`).\n- **Person Profile Enrichment** (`/v1/profile`, `/api/v2/linkedin`): **10 Credits / profile** (`$0.001` base, `$0.0004` on Business).\n- **Company & Domain Enrichment** (`/v1/company`): **10 Credits / company** (`$0.001` base, `$0.0004` on Business).\n- **Decision-Maker People Search** (`/v1/people/search`, `/v1/company/employees`): **2 Credits / person** (`$0.20 / 1K people`, min 10 Credits on hit, 0 Credits when empty).\n- **Executive & Company Activity Feeds** (`/v1/profile/posts`, `/v1/company/posts`): **10 Credits / call**.\n- **B2B Post Search & Hiring Signals** (`/v1/posts/search`, `/v1/jobs/search`): **2 Credits / item** (`$0.20 / 1K items`, min 10 Credits on hit, 0 Credits when empty).\n",
    "contact": {
      "name": "LinkedInDataAPI Engineering",
      "email": "contact@linkedindataapi.com",
      "url": "https://linkedindataapi.com"
    }
  },
  "servers": [
    {
      "url": "https://api.linkedindataapi.com",
      "description": "Production Global Edge API Gateway"
    }
  ],
  "security": [
    {
      "ApiKey": []
    }
  ],
  "tags": [
    {
      "name": "Person Profiles",
      "description": "Full B2B person profile, career timeline, education, skills, and Proxycurl-compatible lookup."
    },
    {
      "name": "Company Enrichment",
      "description": "Company firmographics, headcount, specialties, funding, and domain-to-company resolution."
    },
    {
      "name": "Decision-Maker Search",
      "description": "Search company employees and B2B decision-makers by company, title, keyword, and country."
    },
    {
      "name": "Executive Activity & Posts",
      "description": "Executive posts, company updates, and B2B thought-leadership content search."
    },
    {
      "name": "Hiring Signals & System",
      "description": "Active company job openings (buying/expansion intent) and gateway health telemetry."
    }
  ],
  "paths": {
    "/v1/profile": {
      "get": {
        "operationId": "v1_profile",
        "tags": [
          "Person Profiles"
        ],
        "summary": "Enrich a B2B person profile by username or profile URL",
        "description": "Returns structured work history (`experiences`), academic background (`educations`), skills, current employer (`current_company`, `current_title`), location, follower count, and hiring/open-to-work signals. Also available via drop-in aliases `/v1/people/profile`, `/v1/person`, and `/api/v2/linkedin`.",
        "parameters": [
          {
            "name": "username",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Public profile handle (`satyanadella`) or full profile URL (`https://www.linkedin.com/in/satyanadella`).",
            "example": "satyanadella"
          },
          {
            "name": "url",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional alias for `username` (Proxycurl `/api/v2/linkedin?url=...` compatibility).",
            "example": "https://www.linkedin.com/in/satyanadella"
          }
        ],
        "x-price-per-request": "$1.00 / 1K profiles ($0.40 Business)",
        "x-credits-per-request": "10 Credits / profile",
        "responses": {
          "200": {
            "description": "Success (`code === 0`). Deducts 10 Credits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "username": {
                          "type": "string",
                          "example": "satyanadella",
                          "description": "Canonical lowercase person profile slug (`satyanadella`)."
                        },
                        "urn": {
                          "type": "string",
                          "example": "ACoAAAAABL0B9f2c8d1e",
                          "description": "Upstream member or entity identifier."
                        },
                        "full_name": {
                          "type": "string",
                          "example": "Satya Nadella",
                          "description": "Full display name of the professional."
                        },
                        "first_name": {
                          "type": "string",
                          "example": "Satya",
                          "description": "Given / first name."
                        },
                        "last_name": {
                          "type": "string",
                          "example": "Nadella",
                          "description": "Family / last name."
                        },
                        "headline": {
                          "type": "string",
                          "example": "Chairman and CEO at Microsoft",
                          "description": "Professional headline and executive summary title."
                        },
                        "summary": {
                          "type": "string",
                          "example": "As Chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
                          "description": "Full professional biography / About section."
                        },
                        "current_title": {
                          "type": "string",
                          "example": "Chairman and CEO",
                          "description": "Primary active job title extracted from current work experience."
                        },
                        "current_company": {
                          "type": "string",
                          "example": "Microsoft",
                          "description": "Primary active employer name."
                        },
                        "current_company_slug": {
                          "type": "string",
                          "example": "microsoft",
                          "description": "Canonical company slug of the primary active employer."
                        },
                        "country_code": {
                          "type": "string",
                          "example": "US",
                          "description": "ISO-2 country code (`US`, `GB`, `DE`, `CA`, etc.)."
                        },
                        "location": {
                          "type": "string",
                          "example": "Redmond, Washington, United States",
                          "description": "Human-readable geographic location (`Redmond, Washington, United States`)."
                        },
                        "city": {
                          "type": "string",
                          "example": "Redmond",
                          "description": "City name."
                        },
                        "state": {
                          "type": "string",
                          "example": "Washington",
                          "description": "State or province name."
                        },
                        "industry": {
                          "type": "string",
                          "example": "Software Development",
                          "description": "Primary B2B industry classification."
                        },
                        "avatar_url": {
                          "type": "string",
                          "example": "https://media.licdn.com/dms/image/v2/C5603AQHHUuOSlRVA1w/profile-displayphoto-shrink_800_800/0/1579726625423",
                          "description": "High-resolution profile avatar or logo CDN URL."
                        },
                        "banner_url": {
                          "type": "string",
                          "example": "https://media.licdn.com/dms/image/v2/C5616AQG8x9_banner/0/1620000000000",
                          "description": "Profile or company cover banner URL."
                        },
                        "profile_url": {
                          "type": "string",
                          "example": "https://www.linkedin.com/in/satyanadella",
                          "description": "Canonical public profile URL."
                        },
                        "follower_count": {
                          "type": "integer",
                          "example": 11482900,
                          "description": "Total public follower count."
                        },
                        "connection_count": {
                          "type": "integer",
                          "example": 500,
                          "description": "Total professional connection count."
                        },
                        "is_creator": {
                          "type": "boolean",
                          "example": true,
                          "description": "Whether Creator Mode / thought-leadership publishing is enabled."
                        },
                        "is_open_to_work": {
                          "type": "boolean",
                          "example": false,
                          "description": "Whether the professional displays an Open-to-Work signal."
                        },
                        "is_hiring": {
                          "type": "boolean",
                          "example": true,
                          "description": "Whether the professional displays an active Hiring badge."
                        },
                        "experiences": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "title": {
                                "type": "string",
                                "example": "Chairman and CEO",
                                "description": "Role or job title."
                              },
                              "company_name": {
                                "type": "string",
                                "example": "Microsoft"
                              },
                              "company_slug": {
                                "type": "string",
                                "example": "microsoft"
                              },
                              "company_url": {
                                "type": "string",
                                "example": "https://www.linkedin.com/company/microsoft"
                              },
                              "location": {
                                "type": "string",
                                "example": "Redmond, Washington, United States",
                                "description": "Human-readable geographic location (`Redmond, Washington, United States`)."
                              },
                              "is_current": {
                                "type": "boolean",
                                "example": true
                              },
                              "start_date": {
                                "type": "string",
                                "example": "2014-02"
                              },
                              "end_date": {
                                "type": "string",
                                "nullable": true
                              },
                              "duration_months": {
                                "type": "integer",
                                "example": 153
                              },
                              "description": {
                                "type": "string",
                                "example": "Leading Microsoft's transformation across Azure cloud infrastructure, enterprise productivity, and Copilot AI.",
                                "description": "Full company overview and product description."
                              }
                            },
                            "description": "Chronological career work history array."
                          },
                          "description": "Chronological career work history array."
                        },
                        "educations": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "school_name": {
                                "type": "string",
                                "example": "The University of Chicago Booth School of Business"
                              },
                              "degree": {
                                "type": "string",
                                "example": "Master of Business Administration (MBA)"
                              },
                              "field_of_study": {
                                "type": "string",
                                "example": "Business Administration and Management"
                              },
                              "start_year": {
                                "type": "integer",
                                "example": 1994
                              },
                              "end_year": {
                                "type": "integer",
                                "example": 1997
                              }
                            },
                            "description": "Academic degrees and university history array."
                          },
                          "description": "Academic degrees and university history array."
                        },
                        "skills": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "Cloud Computing",
                            "description": "Endorsed professional skills and domain competencies."
                          },
                          "description": "Endorsed professional skills and domain competencies."
                        },
                        "certifications": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Professional licenses and certifications."
                        },
                        "languages": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "English",
                            "description": "Spoken/written languages."
                          },
                          "description": "Spoken/written languages."
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "cached": {
                          "type": "boolean",
                          "example": false
                        },
                        "freshness_ts": {
                          "type": "string",
                          "example": "2026-11-04T22:00:00Z"
                        },
                        "credits_charged": {
                          "type": "integer",
                          "example": 10,
                          "description": "Exact unified credits deducted for this call."
                        }
                      },
                      "description": "Pagination, freshness, and billing metadata."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "username": "satyanadella",
                    "urn": "ACoAAAAABL0B9f2c8d1e",
                    "full_name": "Satya Nadella",
                    "first_name": "Satya",
                    "last_name": "Nadella",
                    "headline": "Chairman and CEO at Microsoft",
                    "summary": "As Chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
                    "current_title": "Chairman and CEO",
                    "current_company": "Microsoft",
                    "current_company_slug": "microsoft",
                    "country_code": "US",
                    "location": "Redmond, Washington, United States",
                    "city": "Redmond",
                    "state": "Washington",
                    "industry": "Software Development",
                    "avatar_url": "https://media.licdn.com/dms/image/v2/C5603AQHHUuOSlRVA1w/profile-displayphoto-shrink_800_800/0/1579726625423",
                    "banner_url": "https://media.licdn.com/dms/image/v2/C5616AQG8x9_banner/0/1620000000000",
                    "profile_url": "https://www.linkedin.com/in/satyanadella",
                    "follower_count": 11482900,
                    "connection_count": 500,
                    "is_creator": true,
                    "is_open_to_work": false,
                    "is_hiring": true,
                    "experiences": [
                      {
                        "title": "Chairman and CEO",
                        "company_name": "Microsoft",
                        "company_slug": "microsoft",
                        "company_url": "https://www.linkedin.com/company/microsoft",
                        "location": "Redmond, Washington, United States",
                        "is_current": true,
                        "start_date": "2014-02",
                        "end_date": null,
                        "duration_months": 153,
                        "description": "Leading Microsoft's transformation across Azure cloud infrastructure, enterprise productivity, and Copilot AI."
                      },
                      {
                        "title": "Executive Vice President, Cloud and Enterprise",
                        "company_name": "Microsoft",
                        "company_slug": "microsoft",
                        "company_url": "https://www.linkedin.com/company/microsoft",
                        "location": "Redmond, Washington, United States",
                        "is_current": false,
                        "start_date": "2011-02",
                        "end_date": "2014-02",
                        "duration_months": 36,
                        "description": "Built and scaled Microsoft Azure, Windows Server, SQL Server, and Developer Tools."
                      }
                    ],
                    "educations": [
                      {
                        "school_name": "The University of Chicago Booth School of Business",
                        "degree": "Master of Business Administration (MBA)",
                        "field_of_study": "Business Administration and Management",
                        "start_year": 1994,
                        "end_year": 1997
                      },
                      {
                        "school_name": "University of Wisconsin-Milwaukee",
                        "degree": "Master of Science (M.S.)",
                        "field_of_study": "Computer Science",
                        "start_year": 1988,
                        "end_year": 1990
                      }
                    ],
                    "skills": [
                      "Cloud Computing",
                      "Enterprise Software",
                      "Artificial Intelligence",
                      "Executive Leadership",
                      "Distributed Systems"
                    ],
                    "certifications": [],
                    "languages": [
                      "English",
                      "Telugu",
                      "Hindi"
                    ]
                  },
                  "meta": {
                    "cached": false,
                    "freshness_ts": "2026-11-04T22:00:00Z",
                    "credits_charged": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/company": {
      "get": {
        "operationId": "v1_company",
        "tags": [
          "Company Enrichment"
        ],
        "summary": "Enrich company firmographics by slug, domain, or company URL",
        "description": "Returns verified employee headcount (`staff_count`, `staff_range`), industry, corporate website & domain, headquarters address, founding year, specialties, global office locations, and funding summary. Supports both `company=stripe` and `domain=stripe.com`.",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Company slug (`stripe`), corporate domain (`stripe.com`), or full company URL (`https://www.linkedin.com/company/stripe`).",
            "example": "stripe"
          },
          {
            "name": "domain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Corporate web domain (`stripe.com`, `openai.com`) for Clearbit-style domain-to-company enrichment.",
            "example": "stripe.com"
          }
        ],
        "x-price-per-request": "$1.00 / 1K companies ($0.40 Business)",
        "x-credits-per-request": "10 Credits / company",
        "responses": {
          "200": {
            "description": "Success (`code === 0`). Deducts 10 Credits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string",
                          "example": "stripe",
                          "description": "Canonical lowercase company slug (`stripe`)."
                        },
                        "company_id": {
                          "type": "string",
                          "example": "2135371",
                          "description": "Numeric organization ID."
                        },
                        "name": {
                          "type": "string",
                          "example": "Stripe",
                          "description": "Official company or institution name."
                        },
                        "tagline": {
                          "type": "string",
                          "example": "Financial infrastructure for the internet.",
                          "description": "Company slogan or one-line mission statement."
                        },
                        "description": {
                          "type": "string",
                          "example": "Stripe is a financial infrastructure platform for businesses. Millions of companies\u2014from the world\u2019s largest enterprises to the most ambitious startups\u2014use Stripe to accept payments, grow their revenue, and accelerate new business opportunities.",
                          "description": "Full company overview and product description."
                        },
                        "website": {
                          "type": "string",
                          "example": "https://stripe.com",
                          "description": "Official corporate website URL."
                        },
                        "domain": {
                          "type": "string",
                          "example": "stripe.com",
                          "description": "Normalized root corporate domain (`stripe.com`)."
                        },
                        "industry": {
                          "type": "string",
                          "example": "Financial Services & FinTech",
                          "description": "Primary B2B industry classification."
                        },
                        "company_type": {
                          "type": "string",
                          "example": "Privately Held",
                          "description": "Corporate structure (`Privately Held`, `Public Company`, `Nonprofit`)."
                        },
                        "founded_year": {
                          "type": "integer",
                          "example": 2010,
                          "description": "Year the organization was founded."
                        },
                        "staff_count": {
                          "type": "integer",
                          "example": 8450,
                          "description": "Verified employee headcount."
                        },
                        "staff_range": {
                          "type": "string",
                          "example": "5001-10000",
                          "description": "Employee headcount bracket (`5001-10000`)."
                        },
                        "follower_count": {
                          "type": "integer",
                          "example": 1924000,
                          "description": "Total public follower count."
                        },
                        "hq_city": {
                          "type": "string",
                          "example": "South San Francisco",
                          "description": "Headquarters city."
                        },
                        "hq_state": {
                          "type": "string",
                          "example": "California"
                        },
                        "hq_country": {
                          "type": "string",
                          "example": "US",
                          "description": "Headquarters ISO-2 country code."
                        },
                        "hq_address": {
                          "type": "string",
                          "example": "354 Oyster Point Blvd, South San Francisco, CA 94080, US"
                        },
                        "logo_url": {
                          "type": "string",
                          "example": "https://media.licdn.com/dms/image/v2/D4E0BAQFf_stripe_logo/0/1700000000000"
                        },
                        "company_url": {
                          "type": "string",
                          "example": "https://www.linkedin.com/company/stripe"
                        },
                        "specialties": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "Global Payments",
                            "description": "Core corporate specialties and product domains."
                          },
                          "description": "Core corporate specialties and product domains."
                        },
                        "locations": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "city": {
                                "type": "string",
                                "example": "South San Francisco",
                                "description": "City name."
                              },
                              "state": {
                                "type": "string",
                                "example": "CA",
                                "description": "State or province name."
                              },
                              "country": {
                                "type": "string",
                                "example": "US"
                              },
                              "is_hq": {
                                "type": "boolean",
                                "example": true
                              }
                            },
                            "description": "Global office locations."
                          },
                          "description": "Global office locations."
                        },
                        "funding": {
                          "type": "object",
                          "properties": {
                            "last_round_type": {
                              "type": "string",
                              "example": "Series I"
                            },
                            "last_round_amount_usd": {
                              "type": "integer",
                              "example": 6500000000
                            },
                            "last_round_date": {
                              "type": "string",
                              "example": "2023-03-15"
                            },
                            "investors": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "example": "Andreessen Horowitz"
                              }
                            }
                          },
                          "description": "Latest venture funding round and investor summary."
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "cached": {
                          "type": "boolean",
                          "example": false
                        },
                        "freshness_ts": {
                          "type": "string",
                          "example": "2026-11-04T22:00:00Z"
                        },
                        "credits_charged": {
                          "type": "integer",
                          "example": 10,
                          "description": "Exact unified credits deducted for this call."
                        }
                      },
                      "description": "Pagination, freshness, and billing metadata."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "slug": "stripe",
                    "company_id": "2135371",
                    "name": "Stripe",
                    "tagline": "Financial infrastructure for the internet.",
                    "description": "Stripe is a financial infrastructure platform for businesses. Millions of companies\u2014from the world\u2019s largest enterprises to the most ambitious startups\u2014use Stripe to accept payments, grow their revenue, and accelerate new business opportunities.",
                    "website": "https://stripe.com",
                    "domain": "stripe.com",
                    "industry": "Financial Services & FinTech",
                    "company_type": "Privately Held",
                    "founded_year": 2010,
                    "staff_count": 8450,
                    "staff_range": "5001-10000",
                    "follower_count": 1924000,
                    "hq_city": "South San Francisco",
                    "hq_state": "California",
                    "hq_country": "US",
                    "hq_address": "354 Oyster Point Blvd, South San Francisco, CA 94080, US",
                    "logo_url": "https://media.licdn.com/dms/image/v2/D4E0BAQFf_stripe_logo/0/1700000000000",
                    "company_url": "https://www.linkedin.com/company/stripe",
                    "specialties": [
                      "Global Payments",
                      "Financial Infrastructure",
                      "Billing & Subscriptions",
                      "Fraud Prevention (Radar)",
                      "Embedded Finance (Connect)",
                      "Revenue Recognition"
                    ],
                    "locations": [
                      {
                        "city": "South San Francisco",
                        "state": "CA",
                        "country": "US",
                        "is_hq": true
                      },
                      {
                        "city": "Dublin",
                        "state": "Leinster",
                        "country": "IE",
                        "is_hq": true
                      },
                      {
                        "city": "London",
                        "state": "England",
                        "country": "GB",
                        "is_hq": false
                      }
                    ],
                    "funding": {
                      "last_round_type": "Series I",
                      "last_round_amount_usd": 6500000000,
                      "last_round_date": "2023-03-15",
                      "investors": [
                        "Andreessen Horowitz",
                        "Founders Fund",
                        "General Catalyst",
                        "Sequoia Capital"
                      ]
                    }
                  },
                  "meta": {
                    "cached": false,
                    "freshness_ts": "2026-11-04T22:00:00Z",
                    "credits_charged": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/people/search": {
      "get": {
        "operationId": "v1_people_search",
        "tags": [
          "Decision-Maker Search"
        ],
        "summary": "Search company employees & B2B decision-makers by role, company, and location",
        "description": "Discover executives, engineering leaders, and GTM decision-makers across any target company or industry. Also available via `/v1/company/employees` and `/v1/people`. Charged per returned profile (2 Credits / item, minimum 10 Credits on non-empty hit, 0 Credits when empty).",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Current employer slug or name (`stripe`, `openai`, `microsoft`).",
            "example": "stripe"
          },
          {
            "name": "title",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Job title or seniority filter (`VP Engineering`, `Head of AI`, `CTO`, `Founder`).",
            "example": "VP"
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Boolean or free-text keyword query (`payments infrastructure`, `enterprise sales`).",
            "example": "payments"
          },
          {
            "name": "country_code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "ISO-2 country code filter (`US`, `GB`, `DE`, `CA`).",
            "example": "US"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1
            },
            "description": "Page number (1-indexed).",
            "example": 1
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 25,
              "default": 10
            },
            "description": "Maximum decision-makers returned per page (`1` to `25`).",
            "example": 10
          }
        ],
        "x-price-per-request": "$0.20 / 1K people ($0.08 Business)",
        "x-credits-per-request": "2 Credits / person (min 10)",
        "responses": {
          "200": {
            "description": "Success (`code === 0`). Deducts 2 Credits per person returned (min 10 Credits on non-empty hit).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "username": {
                                "type": "string",
                                "example": "patrickc",
                                "description": "Canonical lowercase person profile slug (`satyanadella`)."
                              },
                              "full_name": {
                                "type": "string",
                                "example": "Patrick Collison",
                                "description": "Full display name of the professional."
                              },
                              "headline": {
                                "type": "string",
                                "example": "CEO at Stripe",
                                "description": "Professional headline and executive summary title."
                              },
                              "current_title": {
                                "type": "string",
                                "example": "Co-Founder & CEO",
                                "description": "Primary active job title extracted from current work experience."
                              },
                              "current_company": {
                                "type": "string",
                                "example": "Stripe",
                                "description": "Primary active employer name."
                              },
                              "current_company_slug": {
                                "type": "string",
                                "example": "stripe",
                                "description": "Canonical company slug of the primary active employer."
                              },
                              "location": {
                                "type": "string",
                                "example": "San Francisco Bay Area",
                                "description": "Human-readable geographic location (`Redmond, Washington, United States`)."
                              },
                              "country_code": {
                                "type": "string",
                                "example": "US",
                                "description": "ISO-2 country code (`US`, `GB`, `DE`, `CA`, etc.)."
                              },
                              "profile_url": {
                                "type": "string",
                                "example": "https://www.linkedin.com/in/patrickc",
                                "description": "Canonical public profile URL."
                              },
                              "avatar_url": {
                                "type": "string",
                                "example": "https://media.licdn.com/dms/image/v2/C5603AQ_patrickc/0/1600000000000",
                                "description": "High-resolution profile avatar or logo CDN URL."
                              }
                            },
                            "description": "Array of returned search or feed records."
                          },
                          "description": "Array of returned search or feed records."
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page": {
                          "type": "integer",
                          "example": 1,
                          "description": "Current 1-indexed page number."
                        },
                        "limit": {
                          "type": "integer",
                          "example": 10,
                          "description": "Maximum records returned per page."
                        },
                        "total_estimated": {
                          "type": "integer",
                          "example": 412,
                          "description": "Estimated total matching records across the index."
                        },
                        "has_more": {
                          "type": "boolean",
                          "example": true,
                          "description": "Whether additional pages are available."
                        },
                        "next_page": {
                          "type": "integer",
                          "example": 2,
                          "description": "Next page number to request (`null` if at end)."
                        },
                        "credits_charged": {
                          "type": "integer",
                          "example": 10,
                          "description": "Exact unified credits deducted for this call."
                        }
                      },
                      "description": "Pagination, freshness, and billing metadata."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "items": [
                      {
                        "username": "patrickc",
                        "full_name": "Patrick Collison",
                        "headline": "CEO at Stripe",
                        "current_title": "Co-Founder & CEO",
                        "current_company": "Stripe",
                        "current_company_slug": "stripe",
                        "location": "San Francisco Bay Area",
                        "country_code": "US",
                        "profile_url": "https://www.linkedin.com/in/patrickc",
                        "avatar_url": "https://media.licdn.com/dms/image/v2/C5603AQ_patrickc/0/1600000000000"
                      },
                      {
                        "username": "willgaybrick",
                        "full_name": "Will Gaybrick",
                        "headline": "President, Technology and Business at Stripe",
                        "current_title": "President, Technology and Business",
                        "current_company": "Stripe",
                        "current_company_slug": "stripe",
                        "location": "San Francisco, California, United States",
                        "country_code": "US",
                        "profile_url": "https://www.linkedin.com/in/willgaybrick",
                        "avatar_url": "https://media.licdn.com/dms/image/v2/C5603AQ_willgaybrick/0/1600000000000"
                      },
                      {
                        "username": "david-singleton-stripe",
                        "full_name": "David Singleton",
                        "headline": "Engineering & Infrastructure Leader",
                        "current_title": "VP of Engineering",
                        "current_company": "Stripe",
                        "current_company_slug": "stripe",
                        "location": "San Francisco, California, United States",
                        "country_code": "US",
                        "profile_url": "https://www.linkedin.com/in/david-singleton-stripe",
                        "avatar_url": "https://media.licdn.com/dms/image/v2/C5603AQ_dsingleton/0/1600000000000"
                      },
                      {
                        "username": "steffantomlinson",
                        "full_name": "Steffan Tomlinson",
                        "headline": "Chief Financial Officer at Stripe",
                        "current_title": "Chief Financial Officer",
                        "current_company": "Stripe",
                        "current_company_slug": "stripe",
                        "location": "Palo Alto, California, United States",
                        "country_code": "US",
                        "profile_url": "https://www.linkedin.com/in/steffantomlinson",
                        "avatar_url": "https://media.licdn.com/dms/image/v2/C5603AQ_stomlinson/0/1600000000000"
                      },
                      {
                        "username": "emily-glassberg-sands",
                        "full_name": "Emily Glassberg Sands",
                        "headline": "Head of Information & Data Science at Stripe",
                        "current_title": "VP of Data Science & AI",
                        "current_company": "Stripe",
                        "current_company_slug": "stripe",
                        "location": "San Francisco, California, United States",
                        "country_code": "US",
                        "profile_url": "https://www.linkedin.com/in/emily-glassberg-sands",
                        "avatar_url": "https://media.licdn.com/dms/image/v2/C5603AQ_esands/0/1600000000000"
                      }
                    ]
                  },
                  "meta": {
                    "page": 1,
                    "limit": 10,
                    "total_estimated": 412,
                    "has_more": true,
                    "next_page": 2,
                    "credits_charged": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/profile/posts": {
      "get": {
        "operationId": "v1_profile_posts",
        "tags": [
          "Executive Activity & Posts"
        ],
        "summary": "Fetch recent posts & thought-leadership activity for a B2B person profile",
        "description": "Retrieve recent public posts, articles, engagement counts (`like_count`, `comment_count`, `repost_count`), and timestamps for any executive or prospect to power warm AI SDR outreach.",
        "parameters": [
          {
            "name": "username",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Public profile handle (`satyanadella`) or profile URL.",
            "example": "satyanadella"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 1
            },
            "description": "Page number (1-indexed).",
            "example": 1
          }
        ],
        "x-price-per-request": "$1.00 / 1K calls ($0.40 Business)",
        "x-credits-per-request": "10 Credits / call",
        "responses": {
          "200": {
            "description": "Success (`code === 0`). Deducts 10 Credits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "username": {
                          "type": "string",
                          "example": "satyanadella",
                          "description": "Canonical lowercase person profile slug (`satyanadella`)."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "post_id": {
                                "type": "string",
                                "example": "7258192039182736451",
                                "description": "Unique activity / post identifier."
                              },
                              "author_type": {
                                "type": "string",
                                "example": "person"
                              },
                              "author_slug": {
                                "type": "string",
                                "example": "satyanadella"
                              },
                              "author_name": {
                                "type": "string",
                                "example": "Satya Nadella"
                              },
                              "author_headline": {
                                "type": "string",
                                "example": "Chairman and CEO at Microsoft"
                              },
                              "text": {
                                "type": "string",
                                "example": "Autonomous AI agents are becoming the new UI for enterprise workflows. Excited to see how developers are connecting Copilot Studio directly to their core systems of record.",
                                "description": "Full post body text."
                              },
                              "like_count": {
                                "type": "integer",
                                "example": 18420,
                                "description": "Total reaction / like count."
                              },
                              "comment_count": {
                                "type": "integer",
                                "example": 942,
                                "description": "Total comment count."
                              },
                              "repost_count": {
                                "type": "integer",
                                "example": 1650,
                                "description": "Total repost / share count."
                              },
                              "media_type": {
                                "type": "string",
                                "example": "article"
                              },
                              "post_url": {
                                "type": "string",
                                "example": "https://www.linkedin.com/feed/update/urn:li:activity:7258192039182736451"
                              },
                              "posted_at": {
                                "type": "string",
                                "example": "2026-11-02T16:30:00Z",
                                "description": "ISO-8601 publication timestamp."
                              }
                            },
                            "description": "Array of returned search or feed records."
                          },
                          "description": "Array of returned search or feed records."
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page": {
                          "type": "integer",
                          "example": 1,
                          "description": "Current 1-indexed page number."
                        },
                        "has_more": {
                          "type": "boolean",
                          "example": true,
                          "description": "Whether additional pages are available."
                        },
                        "next_page": {
                          "type": "integer",
                          "example": 2,
                          "description": "Next page number to request (`null` if at end)."
                        },
                        "credits_charged": {
                          "type": "integer",
                          "example": 10,
                          "description": "Exact unified credits deducted for this call."
                        }
                      },
                      "description": "Pagination, freshness, and billing metadata."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "username": "satyanadella",
                    "items": [
                      {
                        "post_id": "7258192039182736451",
                        "author_type": "person",
                        "author_slug": "satyanadella",
                        "author_name": "Satya Nadella",
                        "author_headline": "Chairman and CEO at Microsoft",
                        "text": "Autonomous AI agents are becoming the new UI for enterprise workflows. Excited to see how developers are connecting Copilot Studio directly to their core systems of record.",
                        "like_count": 18420,
                        "comment_count": 942,
                        "repost_count": 1650,
                        "media_type": "article",
                        "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7258192039182736451",
                        "posted_at": "2026-11-02T16:30:00Z"
                      },
                      {
                        "post_id": "7255102938475610293",
                        "author_type": "person",
                        "author_slug": "satyanadella",
                        "author_name": "Satya Nadella",
                        "author_headline": "Chairman and CEO at Microsoft",
                        "text": "Our Q1 results reflect strong enterprise cloud adoption and rapid deployment of AI infrastructure across every industry.",
                        "like_count": 24110,
                        "comment_count": 1320,
                        "repost_count": 2190,
                        "media_type": "image",
                        "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7255102938475610293",
                        "posted_at": "2026-10-28T20:15:00Z"
                      }
                    ]
                  },
                  "meta": {
                    "page": 1,
                    "has_more": true,
                    "next_page": 2,
                    "credits_charged": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/company/posts": {
      "get": {
        "operationId": "v1_company_posts",
        "tags": [
          "Executive Activity & Posts"
        ],
        "summary": "Fetch official company announcements, product launches & feed updates",
        "description": "Track official corporate announcements, product releases, partnership posts, and engagement velocity for any target account.",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Company slug (`stripe`), domain (`stripe.com`), or full company URL.",
            "example": "stripe"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 1
            },
            "description": "Page number (1-indexed).",
            "example": 1
          }
        ],
        "x-price-per-request": "$1.00 / 1K calls ($0.40 Business)",
        "x-credits-per-request": "10 Credits / call",
        "responses": {
          "200": {
            "description": "Success (`code === 0`). Deducts 10 Credits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string",
                          "example": "stripe",
                          "description": "Canonical lowercase company slug (`stripe`)."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "post_id": {
                                "type": "string",
                                "example": "7258901234567890123",
                                "description": "Unique activity / post identifier."
                              },
                              "author_type": {
                                "type": "string",
                                "example": "company"
                              },
                              "author_slug": {
                                "type": "string",
                                "example": "stripe"
                              },
                              "author_name": {
                                "type": "string",
                                "example": "Stripe"
                              },
                              "text": {
                                "type": "string",
                                "example": "Introducing usage-based billing meters in Stripe Billing\u2014built for AI SaaS, API gateways, and high-throughput infrastructure companies.",
                                "description": "Full post body text."
                              },
                              "like_count": {
                                "type": "integer",
                                "example": 4890,
                                "description": "Total reaction / like count."
                              },
                              "comment_count": {
                                "type": "integer",
                                "example": 312,
                                "description": "Total comment count."
                              },
                              "repost_count": {
                                "type": "integer",
                                "example": 580,
                                "description": "Total repost / share count."
                              },
                              "media_type": {
                                "type": "string",
                                "example": "video"
                              },
                              "post_url": {
                                "type": "string",
                                "example": "https://www.linkedin.com/feed/update/urn:li:activity:7258901234567890123"
                              },
                              "posted_at": {
                                "type": "string",
                                "example": "2026-11-03T15:00:00Z",
                                "description": "ISO-8601 publication timestamp."
                              }
                            },
                            "description": "Array of returned search or feed records."
                          },
                          "description": "Array of returned search or feed records."
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page": {
                          "type": "integer",
                          "example": 1,
                          "description": "Current 1-indexed page number."
                        },
                        "has_more": {
                          "type": "boolean",
                          "example": true,
                          "description": "Whether additional pages are available."
                        },
                        "next_page": {
                          "type": "integer",
                          "example": 2,
                          "description": "Next page number to request (`null` if at end)."
                        },
                        "credits_charged": {
                          "type": "integer",
                          "example": 10,
                          "description": "Exact unified credits deducted for this call."
                        }
                      },
                      "description": "Pagination, freshness, and billing metadata."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "slug": "stripe",
                    "items": [
                      {
                        "post_id": "7258901234567890123",
                        "author_type": "company",
                        "author_slug": "stripe",
                        "author_name": "Stripe",
                        "text": "Introducing usage-based billing meters in Stripe Billing\u2014built for AI SaaS, API gateways, and high-throughput infrastructure companies.",
                        "like_count": 4890,
                        "comment_count": 312,
                        "repost_count": 580,
                        "media_type": "video",
                        "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7258901234567890123",
                        "posted_at": "2026-11-03T15:00:00Z"
                      }
                    ]
                  },
                  "meta": {
                    "page": 1,
                    "has_more": true,
                    "next_page": 2,
                    "credits_charged": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/posts/search": {
      "get": {
        "operationId": "v1_posts_search",
        "tags": [
          "Executive Activity & Posts"
        ],
        "summary": "Search public B2B posts & executive discussions by keyword",
        "description": "Monitor B2B buying intent, competitor mentions, and industry discussions across public professional posts.",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Search keyword or phrase (`enterprise AI agents`, `SOC2 compliance`, `payment orchestration`).",
            "example": "enterprise AI agents"
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "date_posted"
              ],
              "default": "relevance"
            },
            "description": "Sort order (`relevance` or `date_posted`).",
            "example": "relevance"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 1
            },
            "description": "Page number (1-indexed).",
            "example": 1
          }
        ],
        "x-price-per-request": "$0.20 / 1K posts ($0.08 Business)",
        "x-credits-per-request": "2 Credits / post (min 10)",
        "responses": {
          "200": {
            "description": "Success (`code === 0`). Deducts 2 Credits per post returned (min 10 Credits on hit).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "post_id": {
                                "type": "string",
                                "example": "7258991122334455667",
                                "description": "Unique activity / post identifier."
                              },
                              "author_type": {
                                "type": "string",
                                "example": "person"
                              },
                              "author_slug": {
                                "type": "string",
                                "example": "darioamodei"
                              },
                              "author_name": {
                                "type": "string",
                                "example": "Dario Amodei"
                              },
                              "author_headline": {
                                "type": "string",
                                "example": "CEO and Co-Founder at Anthropic"
                              },
                              "text": {
                                "type": "string",
                                "example": "Enterprise adoption of tool-using AI agents requires reliable, deterministic APIs and verifiable guardrails.",
                                "description": "Full post body text."
                              },
                              "like_count": {
                                "type": "integer",
                                "example": 9320,
                                "description": "Total reaction / like count."
                              },
                              "comment_count": {
                                "type": "integer",
                                "example": 614,
                                "description": "Total comment count."
                              },
                              "repost_count": {
                                "type": "integer",
                                "example": 1120,
                                "description": "Total repost / share count."
                              },
                              "media_type": {
                                "type": "string",
                                "example": "text"
                              },
                              "post_url": {
                                "type": "string",
                                "example": "https://www.linkedin.com/feed/update/urn:li:activity:7258991122334455667"
                              },
                              "posted_at": {
                                "type": "string",
                                "example": "2026-11-03T18:40:00Z",
                                "description": "ISO-8601 publication timestamp."
                              }
                            },
                            "description": "Array of returned search or feed records."
                          },
                          "description": "Array of returned search or feed records."
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page": {
                          "type": "integer",
                          "example": 1,
                          "description": "Current 1-indexed page number."
                        },
                        "limit": {
                          "type": "integer",
                          "example": 10,
                          "description": "Maximum records returned per page."
                        },
                        "has_more": {
                          "type": "boolean",
                          "example": true,
                          "description": "Whether additional pages are available."
                        },
                        "next_page": {
                          "type": "integer",
                          "example": 2,
                          "description": "Next page number to request (`null` if at end)."
                        },
                        "credits_charged": {
                          "type": "integer",
                          "example": 10,
                          "description": "Exact unified credits deducted for this call."
                        }
                      },
                      "description": "Pagination, freshness, and billing metadata."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "items": [
                      {
                        "post_id": "7258991122334455667",
                        "author_type": "person",
                        "author_slug": "darioamodei",
                        "author_name": "Dario Amodei",
                        "author_headline": "CEO and Co-Founder at Anthropic",
                        "text": "Enterprise adoption of tool-using AI agents requires reliable, deterministic APIs and verifiable guardrails.",
                        "like_count": 9320,
                        "comment_count": 614,
                        "repost_count": 1120,
                        "media_type": "text",
                        "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7258991122334455667",
                        "posted_at": "2026-11-03T18:40:00Z"
                      }
                    ]
                  },
                  "meta": {
                    "page": 1,
                    "limit": 10,
                    "has_more": true,
                    "next_page": 2,
                    "credits_charged": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/jobs/search": {
      "get": {
        "operationId": "v1_jobs_search",
        "tags": [
          "Hiring Signals & System"
        ],
        "summary": "Search active company job openings & technographic hiring signals",
        "description": "Detect departmental expansion, new office openings, and technographic buying intent by querying active job postings by company, role title, location, and workplace type.",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Company slug or name (`stripe`, `openai`, `anthropic`).",
            "example": "stripe"
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Role title or skill keyword (`Distributed Systems`, `Account Executive`, `Kubernetes`).",
            "example": "Distributed Systems"
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Geographic filter (`United States`, `San Francisco`, `London`).",
            "example": "United States"
          },
          {
            "name": "remote",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Filter for remote-eligible positions (`true` or `false`).",
            "example": false
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 1
            },
            "description": "Page number (1-indexed).",
            "example": 1
          }
        ],
        "x-price-per-request": "$0.20 / 1K jobs ($0.08 Business)",
        "x-credits-per-request": "2 Credits / job (min 10)",
        "responses": {
          "200": {
            "description": "Success (`code === 0`). Deducts 2 Credits per job returned (min 10 Credits on hit).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "job_id": {
                                "type": "string",
                                "example": "4062918273",
                                "description": "Unique job posting identifier."
                              },
                              "title": {
                                "type": "string",
                                "example": "Staff Distributed Systems Engineer \u2014 Payments Core",
                                "description": "Role or job title."
                              },
                              "company_name": {
                                "type": "string",
                                "example": "Stripe"
                              },
                              "company_slug": {
                                "type": "string",
                                "example": "stripe"
                              },
                              "company_url": {
                                "type": "string",
                                "example": "https://www.linkedin.com/company/stripe"
                              },
                              "location": {
                                "type": "string",
                                "example": "San Francisco, CA",
                                "description": "Human-readable geographic location (`Redmond, Washington, United States`)."
                              },
                              "country_code": {
                                "type": "string",
                                "example": "US",
                                "description": "ISO-2 country code (`US`, `GB`, `DE`, `CA`, etc.)."
                              },
                              "workplace_type": {
                                "type": "string",
                                "example": "Hybrid",
                                "description": "Workplace model (`Remote`, `Hybrid`, `On-site`)."
                              },
                              "employment_type": {
                                "type": "string",
                                "example": "FULL_TIME",
                                "description": "Contract type (`FULL_TIME`, `CONTRACT`, `INTERNSHIP`)."
                              },
                              "seniority_level": {
                                "type": "string",
                                "example": "Mid-Senior level"
                              },
                              "salary_range": {
                                "type": "string",
                                "example": "$228,000 - $315,000 USD"
                              },
                              "apply_url": {
                                "type": "string",
                                "example": "https://stripe.com/jobs/listing/staff-distributed-systems-engineer/4062918273",
                                "description": "Direct application or ATS URL."
                              },
                              "job_url": {
                                "type": "string",
                                "example": "https://www.linkedin.com/jobs/view/4062918273"
                              },
                              "posted_at": {
                                "type": "string",
                                "example": "2026-11-04T09:00:00Z",
                                "description": "ISO-8601 publication timestamp."
                              }
                            },
                            "description": "Array of returned search or feed records."
                          },
                          "description": "Array of returned search or feed records."
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page": {
                          "type": "integer",
                          "example": 1,
                          "description": "Current 1-indexed page number."
                        },
                        "limit": {
                          "type": "integer",
                          "example": 10,
                          "description": "Maximum records returned per page."
                        },
                        "has_more": {
                          "type": "boolean",
                          "example": true,
                          "description": "Whether additional pages are available."
                        },
                        "next_page": {
                          "type": "integer",
                          "example": 2,
                          "description": "Next page number to request (`null` if at end)."
                        },
                        "credits_charged": {
                          "type": "integer",
                          "example": 10,
                          "description": "Exact unified credits deducted for this call."
                        }
                      },
                      "description": "Pagination, freshness, and billing metadata."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "items": [
                      {
                        "job_id": "4062918273",
                        "title": "Staff Distributed Systems Engineer \u2014 Payments Core",
                        "company_name": "Stripe",
                        "company_slug": "stripe",
                        "company_url": "https://www.linkedin.com/company/stripe",
                        "location": "San Francisco, CA",
                        "country_code": "US",
                        "workplace_type": "Hybrid",
                        "employment_type": "FULL_TIME",
                        "seniority_level": "Mid-Senior level",
                        "salary_range": "$228,000 - $315,000 USD",
                        "apply_url": "https://stripe.com/jobs/listing/staff-distributed-systems-engineer/4062918273",
                        "job_url": "https://www.linkedin.com/jobs/view/4062918273",
                        "posted_at": "2026-11-04T09:00:00Z"
                      },
                      {
                        "job_id": "4062918991",
                        "title": "Enterprise Account Executive \u2014 Platform & API",
                        "company_name": "Stripe",
                        "company_slug": "stripe",
                        "company_url": "https://www.linkedin.com/company/stripe",
                        "location": "New York, NY",
                        "country_code": "US",
                        "workplace_type": "Hybrid",
                        "employment_type": "FULL_TIME",
                        "seniority_level": "Mid-Senior level",
                        "salary_range": "$185,000 - $270,000 USD + Commission",
                        "apply_url": "https://stripe.com/jobs/listing/enterprise-ae/4062918991",
                        "job_url": "https://www.linkedin.com/jobs/view/4062918991",
                        "posted_at": "2026-11-03T14:20:00Z"
                      }
                    ]
                  },
                  "meta": {
                    "page": 1,
                    "limit": 10,
                    "has_more": true,
                    "next_page": 2,
                    "credits_charged": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/health": {
      "get": {
        "operationId": "v1_health",
        "tags": [
          "Hiring Signals & System"
        ],
        "summary": "Gateway health & multi-provider upstream status check",
        "description": "Zero-cost health probe returning gateway status, active upstream provider count, and edge p50 latency.",
        "parameters": [],
        "x-price-per-request": "Free (0 Credits)",
        "x-credits-per-request": "0 Credits",
        "responses": {
          "200": {
            "description": "Gateway is healthy.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "healthy",
                          "description": "Human-readable status string (`ok` or `error`)."
                        },
                        "region": {
                          "type": "string",
                          "example": "eu-central-1"
                        },
                        "upstream_providers_healthy": {
                          "type": "integer",
                          "example": 5
                        },
                        "p50_latency_ms": {
                          "type": "integer",
                          "example": 18
                        },
                        "timestamp": {
                          "type": "string",
                          "example": "2026-11-04T23:00:00Z"
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "status": "healthy",
                    "region": "eu-central-1",
                    "upstream_providers_healthy": 5,
                    "p50_latency_ms": 18,
                    "timestamp": "2026-11-04T23:00:00Z"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/stats": {
      "get": {
        "operationId": "v1_stats",
        "tags": [
          "Hiring Signals & System"
        ],
        "summary": "Index coverage & latency telemetry",
        "description": "Zero-cost endpoint returning live counts of indexed B2B profiles, companies, decision-makers, and hiring signals.",
        "parameters": [],
        "x-price-per-request": "Free (0 Credits)",
        "x-credits-per-request": "0 Credits",
        "responses": {
          "200": {
            "description": "Index coverage statistics.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Application status code (`0` = success, non-zero = error)."
                    },
                    "status": {
                      "type": "string",
                      "example": "ok",
                      "description": "Human-readable status string (`ok` or `error`)."
                    },
                    "msg": {
                      "type": "string",
                      "example": "success",
                      "description": "Response status message (`success`)."
                    },
                    "provider": {
                      "type": "string",
                      "example": "https://linkedindataapi.com",
                      "description": "Canonical API provider URL (`https://linkedindataapi.com`)."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "profiles_indexed": {
                          "type": "integer",
                          "example": 640000
                        },
                        "companies_indexed": {
                          "type": "integer",
                          "example": 185000
                        },
                        "decision_makers_indexed": {
                          "type": "integer",
                          "example": 4200000
                        },
                        "active_hiring_signals": {
                          "type": "integer",
                          "example": 310000
                        },
                        "cache_hit_p50_ms": {
                          "type": "integer",
                          "example": 14
                        },
                        "live_upstream_p50_ms": {
                          "type": "integer",
                          "example": 920
                        }
                      },
                      "description": "Normalized B2B intelligence payload."
                    }
                  }
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "msg": "success",
                  "provider": "https://linkedindataapi.com",
                  "data": {
                    "profiles_indexed": 640000,
                    "companies_indexed": 185000,
                    "decision_makers_indexed": 4200000,
                    "active_hiring_signals": 310000,
                    "cache_hit_p50_ms": 14,
                    "live_upstream_p50_ms": 920
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "Pass your `b2b_live_...` API key in the `x-api-key` header."
      }
    }
  }
}
