{"openapi":"3.1.0","info":{"title":"LinkedIn Profile API","description":"Hosted API that extracts structured data from LinkedIn profile URLs.","version":"1.0.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/ui":{"get":{"summary":"Ui","operationId":"ui_ui_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"}]},"type":"object","title":"Response Health Health Get"}}}}}}},"/api/image":{"get":{"summary":"Proxy Linkedin Image","operationId":"proxy_linkedin_image_api_image_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"LinkedIn media image URL","title":"Url"},"description":"LinkedIn media image URL"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles":{"post":{"summary":"Scrape Profile Post","operationId":"scrape_profile_post_api_v1_profiles_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Scrape Profile Get","operationId":"scrape_profile_get_api_v1_profiles_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"LinkedIn /in/ or /pub/ profile URL","title":"Url"},"description":"LinkedIn /in/ or /pub/ profile URL"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/profile":{"get":{"summary":"Scrape Profile Compat Get","operationId":"scrape_profile_compat_get_api_profile_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"LinkedIn /in/ or /pub/ profile URL","title":"Url"},"description":"LinkedIn /in/ or /pub/ profile URL"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/session":{"post":{"summary":"Update Session","description":"Hot-swap the LinkedIn session cookie at runtime (no redeploy needed).","operationId":"update_session_api_auth_session_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Update Session Api Auth Session Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CertificationItem":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"issuer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer"},"issue_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issue Date"},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expiration Date"},"credential_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Id"},"credential_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Url"},"source_text":{"items":{"type":"string"},"type":"array","title":"Source Text"}},"type":"object","title":"CertificationItem"},"EducationItem":{"properties":{"school":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School"},"degree":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Degree"},"field_of_study":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field Of Study"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"description":{"items":{"type":"string"},"type":"array","title":"Description"},"source_text":{"items":{"type":"string"},"type":"array","title":"Source Text"}},"type":"object","title":"EducationItem"},"ExperienceItem":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"employment_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employment Type"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"description":{"items":{"type":"string"},"type":"array","title":"Description"},"source_text":{"items":{"type":"string"},"type":"array","title":"Source Text"}},"type":"object","title":"ExperienceItem"},"ExtractionMetadata":{"properties":{"requested_url":{"type":"string","title":"Requested Url"},"resolved_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved Url"},"public_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Identifier"},"authenticated":{"type":"boolean","title":"Authenticated","default":false},"strategies":{"items":{"type":"string"},"type":"array","title":"Strategies"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"scraped_at":{"type":"string","format":"date-time","title":"Scraped At"}},"type":"object","required":["requested_url"],"title":"ExtractionMetadata"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LanguageItem":{"properties":{"name":{"type":"string","title":"Name"},"proficiency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proficiency"},"source_text":{"items":{"type":"string"},"type":"array","title":"Source Text"}},"type":"object","required":["name"],"title":"LanguageItem"},"LinkedInProfile":{"properties":{"profile_url":{"type":"string","title":"Profile Url"},"public_identifier":{"type":"string","title":"Public Identifier"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"about":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"About"},"profile_images":{"items":{"$ref":"#/components/schemas/ProfileImage"},"type":"array","title":"Profile Images"},"experience":{"items":{"$ref":"#/components/schemas/ExperienceItem"},"type":"array","title":"Experience"},"education":{"items":{"$ref":"#/components/schemas/EducationItem"},"type":"array","title":"Education"},"skills":{"items":{"$ref":"#/components/schemas/SkillItem"},"type":"array","title":"Skills"},"certifications":{"items":{"$ref":"#/components/schemas/CertificationItem"},"type":"array","title":"Certifications"},"languages":{"items":{"$ref":"#/components/schemas/LanguageItem"},"type":"array","title":"Languages"},"raw_sections":{"additionalProperties":true,"type":"object","title":"Raw Sections"},"extraction":{"$ref":"#/components/schemas/ExtractionMetadata"}},"type":"object","required":["profile_url","public_identifier","extraction"],"title":"LinkedInProfile"},"ProfileImage":{"properties":{"url":{"type":"string","title":"Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["url"],"title":"ProfileImage"},"ProfileRequest":{"properties":{"url":{"type":"string","title":"Url","examples":["https://www.linkedin.com/in/example/"]}},"type":"object","required":["url"],"title":"ProfileRequest"},"SessionUpdate":{"properties":{"storage_state_b64":{"type":"string","title":"Storage State B64","description":"Base64-encoded Playwright storage state JSON"}},"type":"object","required":["storage_state_b64"],"title":"SessionUpdate"},"SkillItem":{"properties":{"name":{"type":"string","title":"Name"},"context":{"items":{"type":"string"},"type":"array","title":"Context"},"source_text":{"items":{"type":"string"},"type":"array","title":"Source Text"}},"type":"object","required":["name"],"title":"SkillItem"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}