{ "openapi": "3.0.0", "x-mint": { "mcp": { "enabled": true } }, "servers": [ { "url": "https://api.pubrio.com" } ], "info": { "description": "Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물 데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요.", "version": "1.0.0", "title": "Pubrio OpenAPI", "termsOfService": "https://pubrio.com/ko/terms-of-service", "contact": { "email": "king.lai@pubrio.com", "name": "King Lai", "url": "https://pubrio.com/ko/get-in-touch" }, "license": { "name": "Apache 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0.html" } }, "tags": [ { "name": "Profile", "description": "워크스페이스 프로필 정보 및 사용량 통계" }, { "name": "Enrichment", "description": "상세한 B2B 데이터로 인물 및 기업 레코드를 보강" }, { "name": "Lookalike", "description": "지정된 기업과 유사한 기업 검색" }, { "name": "Search", "description": "필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색" }, { "name": "Lookup", "description": "특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회" }, { "name": "LinkedIn", "description": "LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회" }, { "name": "Redeem", "description": "크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치)" }, { "name": "Channels", "description": "아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록)" }, { "name": "Monitor", "description": "웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리" }, { "name": "Filters", "description": "검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등)" }, { "name": "API Keys", "description": "API 키의 요청 로그 및 사용량 분석 조회" }, { "name": "Insights", "description": "회사의 신호 집계 인사이트(채용, 뉴스, 광고)." }, { "name": "Export", "description": "대량 데이터 내보내기(크레딧 차감)." }, { "name": "Expansion", "description": "회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기." } ], "paths": { "/people/enrichment": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": null } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "people_enrich", "summary": "인물 레코드 보강", "description": "상세한 연락처 정보, 경력 이력 및 소셜 프로필로 인물 레코드를 보강합니다.", "tags": [ "Enrichment" ] } }, "/companies/lookup/enrich": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "metadata": { "is_enrichment_available": false, "parameters": null }, "data": { "logo_url": "https://buckets.pubrio.com/company-logo/MTA4NjI1MTNzdHJpcGUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "estimated_revenue": 14400000000, "publicly_traded_symbol": null, "publicly_traded_exchange": null, "linkedin_name": "stripe", "domains": [ "stripe.com" ], "locations": [ "US" ], "categories": [ "1", "26", "28", "33", "37", "38", "39", "43", "56", "60", "64", "69", "71", "81", "116", "129", "147", "254", "979", "3014", "707847256" ], "verticals": [ "24076059", "24096599", "69085143", "69107205" ], "vertical_categories": [ "9", "16", "18" ], "vertical_sub_categories": [ "74", "103", "120" ], "company_ranking": 221, "title": "Help increase the GDP of the internet.", "company_type": "Privately Held", "description": "Stripe is a financial infrastructure platform for businesses. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.", "company_address": "South San Francisco, California", "linkedin_uid": "2135371", "company_name": "Stripe", "founded_year": 2010, "industry": "Technology, Information And Internet", "specialties": [ "Technology, Information And Internet", "Financial Services", "E-commerce", "Information Technology & Services" ], "domain": "stripe.com", "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee", "domain_id": 10862513, "parent_id": null, "linkedin_company_id": 1407685, "domain_ids": [ 10862513, 3254042745, 2617941789, 953909397, 368243151 ], "country_code": "US", "company_size": 11300, "company_keywords": [ "payments", "developer tools", "cloud infrastructure", "credit cards", "consumer internet", "enterprise software", "software", "internet", "information technology", "technology, information & internet", "global payments", "online payments", "payment links", "checkout solutions", "subscription billing", "invoicing", "fraud prevention", "identity verification", "financial automation", "business financing", "virtual cards", "embedded finance", "transaction monitoring", "data analytics", "payment methods" ], "is_company_url_active": true, "company_url": "https://stripe.com/", "youtube_url": null, "github_url": null, "x_url": null, "crunchbase_url": null, "linkedin_url": "https://www.linkedin.com/company/stripe", "instagram_url": null, "facebook_url": "https://facebook.com/stripehq", "twitter_url": "http://twitter.com/stripe", "country": "United States", "location": "United States", "sequences": null, "saved_lists": null, "company_addresses": [ "354 Oyster Point Blvd South San Francisco, California 94080, US", "1 Grand Canal Street Lower Dublin, County Dublin, IE", "920 5th Ave Seattle, Washington 98104, US", "211 Old Street London, England EC1V 9NR, GB", "10, Boulevard Haussmann Paris, Ile-de-France 75009, FR", "89 Neil Rd Central Business District, Singapore 088894, SG", "1-5-8 Jingumae Tokyo, Shibuya-ku 150-0001, JP", "515 N State St Chicago, Illinois 60610, US", "11 Park Pl New York, NY 10301, US", "Singel 542 Amsterdam, North Holland 1017, NL", "Avenida Paseo De La Reforma 296 Ciudad De Mexico, Colonia Juarez 06600, MX", "222 Exhibition St Melbourne, Victoria 3000, AU", "Avenida Paulista 1374 Paulínia, São Paulo 13140-000, BR", "Church Street Haridevpur, Shanthala Nagar, Ashok Nagar Bengaluru, Karnataka 560001, IN" ], "company_size_printed": "11,300+" }, "jobs": [ { "job_id": "e4077f8d-2b3d-4a9b-935e-123faae6f9a2", "job_search_id": "e4077f8d-2b3d-4a9b-935e-123faae6f9a2", "last_modified": "2025-06-05T08:04:00.294Z", "companies": { "logo_url": "https://buckets.pubrio.com/company-logo/MTA4NjI1MTNzdHJpcGUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee", "company_name": "Stripe", "linkedin_name": "stripe", "country_code": "US", "domain": "stripe.com" }, "location": "Toronto, Ontario, Canada", "job_url": "https://ca.linkedin.com/jobs/view/program-lead-stripe-startups-at-stripe-4244851093?position=9&pageNum=0&refId=dSWk2H9vKbZkQFgUb0YAqA%3D%3D&trackingId=tU1BYodLertdWt%2F7NIn4Tw%3D%3D", "posting_date": "2025-06-04", "country_code": "CA", "location_id": 395, "title": "Program Lead, Stripe Startups", "country": "Canada" }, "..." ], "news": [ { "news_id": "032606ce-46b6-4bf5-9aa9-8ecc96f126bc", "news_search_id": "15872966-7b73-4361-be8f-2415bf4c72d9", "domains": [ "openai.com", "microsoft.com", "anthropic.com", "perplexity.ai", "stripe.com", "github.com", "salesforce.com", "canva.com", "adobe.com", "atlassian.com", "zoom.us" ], "companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MzA2MTI3NThhdGxhc3NpYW4uY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "1437c841-a4b8-48c1-9be3-3dafb68dfd41", "country_code": "AU", "company_name": "Atlassian", "linkedin_name": "atlassian", "domain": "atlassian.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/NTU1MDU5MDdhbnRocm9waWMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "15dd54c6-12b4-494a-84f4-9fff676ac7e0", "country_code": "US", "company_name": "Anthropic", "linkedin_name": "anthropicresearch", "domain": "anthropic.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MjMzNDM2OTQxYWRvYmUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "1fda6cfb-dacd-40a9-bb77-21ebc81c79e2", "country_code": "US", "company_name": "Adobe", "linkedin_name": "adobe", "domain": "adobe.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MjY5OTUyODdzYWxlc2ZvcmNlLmNvbWxpbmtlZGluX3BfbG9nbzE1.jpg", "domain_search_id": "29437edb-9d9a-45a3-8f43-481cbfaab1bf", "country_code": "US", "company_name": "Salesforce", "linkedin_name": "salesforce", "domain": "salesforce.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MTA4NjI1MTNzdHJpcGUuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee", "country_code": "US", "company_name": "Stripe", "linkedin_name": "stripe", "domain": "stripe.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MzA2MTIzNTVvcGVuYWkuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "67c4696b-b7b0-46b5-b2af-9f434543661e", "country_code": "US", "company_name": "Openai", "linkedin_name": "openai", "domain": "openai.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MzY4MjQyNzQ4aWxqOXNzbmoxZ2l0aHViLmNvbWxpbmtlZGluXzE0MDY4NDg=.jpg", "domain_search_id": "838c52f2-ab18-4258-b37c-e00bc568f747", "country_code": "US", "company_name": "Github", "linkedin_name": "github", "domain": "github.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MTU0MDk4MjAxMHpvb20udXNsaW5rZWRpbl9wX2xvZ28xNQ==.jpg", "domain_search_id": "a90c7f40-ed1a-4675-b348-f36cbcf94481", "country_code": "US", "company_name": "Zoom", "linkedin_name": "zoom", "domain": "zoom.us" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MzA2MTIyODdjYW52YS5jb21saW5rZWRpbl9wX2xvZ28xNQ==.jpg", "domain_search_id": "b5405a6c-81a7-4f86-bd09-ebf728b667bf", "country_code": "AU", "company_name": "Canva", "linkedin_name": "canva", "domain": "canva.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MTQyMjQxMjk4bWljcm9zb2Z0LmNvbWxpbmtlZGluX3BfbG9nbzE1.jpg", "domain_search_id": "dd225537-283f-46bf-ba1c-cb0c6a1311bb", "country_code": "US", "company_name": "Microsoft", "linkedin_name": "microsoft", "domain": "microsoft.com" }, { "logo_url": "https://buckets.pubrio.com/company-logo/MTU0MDk4MjEyNnBlcnBsZXhpdHkuYWlsaW5rZWRpbl9wX2xvZ28xNQ==.jpg", "domain_search_id": "fe169c45-f426-4ec4-985e-c88b2d78d044", "country_code": "US", "company_name": "Perplexity", "linkedin_name": "perplexity-ai", "domain": "perplexity.ai" } ], "news_galleries": [ { "slug": "technology", "news_gallery_id": "9536114f-231a-489c-8a8a-1cbf82a327a4", "name": "Technology" } ], "locations": [ "China" ], "last_modified": "2025-06-04T07:43:14.260Z", "image_url": "https://analyticsindiamag.com/wp-content/uploads/2025/06/ai-monetisation-llm.jpg", "url": "https://analyticsindiamag.com/ai-features/llm-companies-vs-saas-giants-whos-winning-in-ai-monetisation/", "published_at": "2025-06-04T07:03:49.000000Z", "language": "en", "source": "analyticsindiamag.com", "category": "launches", "title": "LLM companies vs SaaS giants: AI monetization race", "summary": "LLM companies show rapid growth but struggle with profitability, while SaaS giants integrate AI cautiously into existing services, leveraging their large user base.", "news_category_name": "Launches" }, "..." ], "similar_companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MzY4MjQzODc3cmlwcGxlLmNvbWxpbmtlZGluX3BfbG9nbzE1.jpg", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "similarity_score": 0.6540610253955462, "estimated_revenue": 500000000, "publicly_traded_symbol": null, "publicly_traded_exchange": null, "linkedin_name": "rippleofficial", "domains": [ "ripple.com" ], "locations": [ "US" ], "categories": null, "verticals": [ "69086483", "24076059", "69085537", "69107205" ], "vertical_categories": [ "16", "18" ], "vertical_sub_categories": [ "103", "120" ], "company_ranking": 8133, "title": "We're building the Internet of Value.", "company_type": "Privately Held", "description": "Using proven crypto and blockchain technology honed over a decade, Ripple’s enterprise-grade solutions are faster, more transparent, and more cost-effective than traditional financial services. Our customers use these solutions to source crypto, facilitate instant payments, empower their treasury, engage new audiences, lower capital requirements, and drive new revenue. Founded in 2012, Ripple's vision is to enable a world where value moves as seamlessly as information flows today—an Internet of Value. Ripple is the only enterprise blockchain company today with products in commercial use. Ripple’s global payments network includes over 300 customers across 40+ countries and six continents.", "company_address": "San Francisco, CA", "linkedin_uid": "3249443", "company_name": "Ripple", "founded_year": 2012, "industry": "Technology, Information And Internet", "specialties": [ "Technology", "Technology, Information And Internet", "Financial Services", "Blockchain" ], "domain": "ripple.com", "domain_search_id": "eac9e802-d574-4f5f-b7d9-4daadbdcd630", "domain_id": 368243877, "parent_id": null, "linkedin_company_id": 1408892, "domain_ids": [ 368243877, 3252571626, 1758856012, 2617948464 ], "country_code": "US", "company_size": 1400, "company_keywords": [ "crossborder payments", "financial technology", "cryptography", "distributed ledgers", "fintech", "finance", "blockchain", "payments", "cryptocurrency", "fin tech", "blockchains", "blockchain / cryptocurrency", "technology, information & internet", "digital asset custody", "blockchain technology", "real-time settlement", "liquidity management", "stablecoin issuance", "enterprise blockchain", "xrp ledger", "secure custody solutions", "digital asset management", "financial institutions", "tokenization" ], "is_company_url_active": true, "company_url": "https://www.ripple.com/", "youtube_url": null, "github_url": null, "x_url": "https://x.com/ripple", "crunchbase_url": null, "linkedin_url": "https://www.linkedin.com/company/rippleofficial", "instagram_url": null, "facebook_url": null, "twitter_url": "https://twitter.com/ripple", "country": "United States", "location": "United States", "sequences": null, "saved_lists": null, "company_addresses": [ "San Francisco, CA 94104, US" ], "company_size_printed": "1,400+" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "domain": { "$ref": "#/components/schemas/domain" }, "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "Domain Search ID", "required": [ "domain_search_id" ] }, { "title": "도메인", "required": [ "domain" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] } ] } } } }, "operationId": "companies_enrich", "summary": "기업 레코드 보강", "description": "상세한 기업 특성 데이터, 기술 스택, 채용, 뉴스 및 유사 기업으로 기업 레코드를 보강합니다.", "tags": [ "Enrichment" ] } }, "/people/search": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "metadata": { "filters": { "management_levels": [ "c_suite" ] }, "profile": null }, "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 199616132, "total_pages": 100, "total_display_pages": 100, "is_timeout": false }, "peoples": [ { "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946", "name": "Doug McMillon", "first_name": "Doug", "last_name": "McMillon", "title": "President & CEO", "seniority": "c_suite", "functions": null, "headline": "President & CEO at Walmart Inc.", "tagline": null, "introduction": null, "description": null, "departments": [ "c_suite" ], "subdepartments": [ "executive" ], "keywords": null, "employment_history": [ { "title": "President & CEO", "current": true, "end_date": null, "start_date": "2014-02-01", "company_name": "Walmart" }, { "title": "President & CEO, Walmart International", "current": false, "end_date": "2014-01-01", "start_date": "2009-02-01", "company_name": "Walmart" }, { "title": "President & CEO", "current": false, "end_date": "2009-01-01", "start_date": "2005-08-01", "company_name": "Sam's Club" } ], "country": "United States", "country_code": "US", "location": "United States", "state": "Arkansas", "city": "Bentonville", "wantedly_name": null, "rocketpunch_name": null, "contacts": null, "contact_types": [], "emails": null, "phones": null, "facebook_url": null, "github_url": null, "twitter_url": null, "linkedin_url": "http://www.linkedin.com/in/dougmcmillon", "wantedly_url": null, "rocketpunch_url": null, "saved_lists": null, "sequences": null, "social_metadata": {}, "company": { "company_name": "Walmart", "company_url": "http://walmart.com", "is_company_url_active": true, "domain": "walmart.com", "domain_id": 26067151, "domain_ids": [ 757023267, 368242703, 26067151 ], "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6", "founded_year": 1962, "country": "United States", "country_code": "US", "location": "United States", "phones": null, "emails": [], "contacts": [], "wantedly_name": null, "rocketpunch_name": null, "tiktok_name": null, "company_size_printed": "466,000", "company_size": 466000, "industry": "Retail", "specialties": [ "Retail", "E-commerce" ], "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg", "linkedin_url": "http://www.linkedin.com/company/walmart", "facebook_url": "http://facebook.com/walmart", "twitter_url": "https://twitter.com/walmart", "crunchbase_url": null, "instagram_url": "http://instagram.com/walmart", "youtube_url": "http://youtube.com/user/walmart", "x_url": null, "github_url": null, "tiktok_url": null, "wantedly_url": null, "rocketpunch_url": null, "social_metadata": {} } }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "search_term": { "$ref": "#/components/schemas/search_term" }, "people_name": { "$ref": "#/components/schemas/people_name" }, "people_titles": { "$ref": "#/components/schemas/people_titles" }, "peoples": { "$ref": "#/components/schemas/peoples" }, "management_levels": { "$ref": "#/components/schemas/management_levels" }, "departments": { "$ref": "#/components/schemas/departments" }, "department_functions": { "$ref": "#/components/schemas/functions" }, "employees": { "$ref": "#/components/schemas/employees" }, "people_locations": { "$ref": "#/components/schemas/people_locations" }, "company_locations": { "$ref": "#/components/schemas/company_locations" }, "company_linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "linkedin_urls": { "$ref": "#/components/schemas/people_linkedin_urls" }, "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "company_filters": { "$ref": "#/components/schemas/company_filters" }, "filter_conditions": { "$ref": "#/components/schemas/people_filter_conditions" }, "is_enable_similarity_search": { "$ref": "#/components/schemas/is_enable_similarity_search" }, "similarity_score": { "$ref": "#/components/schemas/similarity_score" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "query": { "type": "string", "example": "decision makers in marketing", "description": "자연어 검색. 입력하면 Pubrio가 이를 아래의 인물 및 회사 필터(직무, 직급, 부서, 지역, 산업, 회사 규모 등)로 해석합니다. 함께 전달한 명시적 필터가 해석된 필터보다 우선합니다. 비워 두면 구조화된 필터만으로 검색합니다." }, "is_include_similar_people_titles": { "type": "boolean", "description": "활성화하면 `people_titles`가 정확히 일치하는 직함뿐 아니라 유사한 직함(예: `software engineer`가 `senior software engineer`와 일치)도 매칭합니다." }, "people_title_similarity_score": { "type": "number", "format": "float", "example": 0.9, "description": "`is_include_similar_people_titles`와 함께 사용합니다. 직함이 얼마나 근접하게 일치해야 하는지를 제어하며, 값이 클수록 더 엄격하게 일치합니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "people_search", "summary": "인물 검색", "description": "직책, 위치, 회사, 직급 등 지정된 조건에 맞는 인물을 Pubrio 데이터베이스에서 검색합니다.", "tags": [ "Search" ] } }, "/people/search/similar": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "metadata": { "filters": { "management_levels": [ "c_suite" ] }, "profile": null }, "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 199616132, "total_pages": 100, "total_display_pages": 100, "is_timeout": false }, "peoples": [ { "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946", "name": "Doug McMillon", "first_name": "Doug", "last_name": "McMillon", "title": "President & CEO", "seniority": "c_suite", "functions": null, "headline": "President & CEO at Walmart Inc.", "tagline": null, "introduction": null, "description": null, "departments": [ "c_suite" ], "subdepartments": [ "executive" ], "keywords": null, "employment_history": [ { "title": "President & CEO", "current": true, "end_date": null, "start_date": "2014-02-01", "company_name": "Walmart" }, { "title": "President & CEO, Walmart International", "current": false, "end_date": "2014-01-01", "start_date": "2009-02-01", "company_name": "Walmart" }, { "title": "President & CEO", "current": false, "end_date": "2009-01-01", "start_date": "2005-08-01", "company_name": "Sam's Club" } ], "country": "United States", "country_code": "US", "location": "United States", "state": "Arkansas", "city": "Bentonville", "wantedly_name": null, "rocketpunch_name": null, "contacts": null, "contact_types": [], "emails": null, "phones": null, "facebook_url": null, "github_url": null, "twitter_url": null, "linkedin_url": "http://www.linkedin.com/in/dougmcmillon", "wantedly_url": null, "rocketpunch_url": null, "saved_lists": null, "sequences": null, "social_metadata": {}, "company": { "company_name": "Walmart", "company_url": "http://walmart.com", "is_company_url_active": true, "domain": "walmart.com", "domain_id": 26067151, "domain_ids": [ 757023267, 368242703, 26067151 ], "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6", "founded_year": 1962, "country": "United States", "country_code": "US", "location": "United States", "phones": null, "emails": [], "contacts": [], "wantedly_name": null, "rocketpunch_name": null, "tiktok_name": null, "company_size_printed": "466,000", "company_size": 466000, "industry": "Retail", "specialties": [ "Retail", "E-commerce" ], "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg", "linkedin_url": "http://www.linkedin.com/company/walmart", "facebook_url": "http://facebook.com/walmart", "twitter_url": "https://twitter.com/walmart", "crunchbase_url": null, "instagram_url": "http://instagram.com/walmart", "youtube_url": "http://youtube.com/user/walmart", "x_url": null, "github_url": null, "tiktok_url": null, "wantedly_url": null, "rocketpunch_url": null, "social_metadata": {} }, "similarity_score": 0.92 }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "search_term": { "$ref": "#/components/schemas/search_term" }, "people_name": { "$ref": "#/components/schemas/people_name" }, "people_titles": { "$ref": "#/components/schemas/people_titles" }, "peoples": { "$ref": "#/components/schemas/peoples" }, "management_levels": { "$ref": "#/components/schemas/management_levels" }, "departments": { "$ref": "#/components/schemas/departments" }, "department_functions": { "$ref": "#/components/schemas/functions" }, "employees": { "$ref": "#/components/schemas/employees" }, "people_locations": { "$ref": "#/components/schemas/people_locations" }, "company_locations": { "$ref": "#/components/schemas/company_locations" }, "company_linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "linkedin_urls": { "$ref": "#/components/schemas/people_linkedin_urls" }, "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "filter_conditions": { "$ref": "#/components/schemas/people_filter_conditions" }, "is_enable_similarity_search": { "$ref": "#/components/schemas/is_enable_similarity_search" }, "similarity_score": { "$ref": "#/components/schemas/similarity_score" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" }, "company_filters": { "$ref": "#/components/schemas/company_filters" } } } } } }, "operationId": "people_search_similar", "summary": "유사 인물 검색", "description": "참조 인물과 유사한 인물을 찾습니다. 요청 본문은 `POST /people/search` 와 동일. `people_titles`、`people_search_id`、`linkedin_url`、`linkedin_urls` 또는 `peoples` 중 하나를 참조로 필요. 각 결과 행에는 `similarity_score`(0.0-1.0, 높을수록 가까움)가 포함되며 유사도 내림차순으로 정렬됩니다.", "tags": [ "Lookalike" ] } }, "/companies/search": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 45234700, "total_pages": 1809388 }, "companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg", "company_name": "Twitter", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "founded_year": 2006, "specialties": [ "Software Development" ], "industry": "Software Development", "domain": "twitter.com", "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a", "domain_id": 224475931, "linkedin_company_id": 44005587, "linkedin_name": "twitter", "is_company_url_active": true, "domain_ids": [ 224475931, 1758889566, 368242865 ], "company_keywords": [ "realtime information", "social commerce", "online shopping", "classifieds", "craigslist killers", "e-commerce", "killers", "consumer internet", "internet", "information technology", "edp services", "technology", "software development", "microblogging", "social networking", "public conversation", "user engagement", "content sharing", "advertising solutions", "monetization", "community building", "digital wallet", "ai integration", "user safety" ], "company_size": 1500, "youtube_url": null, "crunchbase_url": null, "linkedin_url": "http://www.linkedin.com/company/twitter", "instagram_url": null, "facebook_url": "http://facebook.com/twitterinc", "twitter_url": "https://twitter.com/x", "github_url": null, "x_url": null, "location": "United States", "company_ranking": null, "company_url": "http://twitter.com", "saved_lists": null, "company_size_printed": "1,500" }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_name": { "$ref": "#/components/schemas/company_name" }, "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "company_filters": { "$ref": "#/components/schemas/company_filters" }, "locations": { "$ref": "#/components/schemas/locations" }, "exclude_locations": { "$ref": "#/components/schemas/exclude_locations" }, "places": { "$ref": "#/components/schemas/places" }, "exclude_places": { "$ref": "#/components/schemas/exclude_places" }, "job_locations": { "$ref": "#/components/schemas/locations" }, "job_exclude_locations": { "$ref": "#/components/schemas/job_exclude_locations" }, "job_posted_dates": { "$ref": "#/components/schemas/posted_dates" }, "job_titles": { "$ref": "#/components/schemas/people_titles" }, "verticals": { "$ref": "#/components/schemas/verticals" }, "vertical_categories": { "$ref": "#/components/schemas/vertical_categories" }, "vertical_sub_categories": { "$ref": "#/components/schemas/vertical_sub_categories" }, "categories": { "$ref": "#/components/schemas/categories" }, "technologies": { "$ref": "#/components/schemas/technologies" }, "employees": { "$ref": "#/components/schemas/employees" }, "revenues": { "$ref": "#/components/schemas/revenues" }, "founded_dates": { "$ref": "#/components/schemas/founded_dates" }, "keywords": { "$ref": "#/components/schemas/keywords" }, "news_categories": { "$ref": "#/components/schemas/news_categories" }, "news_published_dates": { "$ref": "#/components/schemas/published_dates" }, "advertisement_search_terms": { "$ref": "#/components/schemas/advertisement_search_terms" }, "advertisement_target_locations": { "$ref": "#/components/schemas/advertisement_target_locations" }, "advertisement_exclude_target_locations": { "$ref": "#/components/schemas/advertisement_exclude_target_locations" }, "advertisement_start_dates": { "$ref": "#/components/schemas/advertisement_start_dates" }, "advertisement_end_dates": { "$ref": "#/components/schemas/advertisement_end_dates" }, "filter_conditions": { "$ref": "#/components/schemas/company_filter_conditions" }, "is_enable_similarity_search": { "$ref": "#/components/schemas/is_enable_similarity_search" }, "similarity_score": { "$ref": "#/components/schemas/similarity_score" }, "exclude_fields": { "$ref": "#/components/schemas/exclude_fields" }, "is_parameter_metadata_available": { "$ref": "#/components/schemas/is_parameter_metadata_available" }, "is_profile_metadata_available": { "$ref": "#/components/schemas/is_profile_metadata_available" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "companies_search", "summary": "기업 검색", "description": "업종, 규모, 위치, 기술 등 지정된 조건에 맞는 기업을 Pubrio 데이터베이스에서 검색합니다.", "tags": [ "Search" ] } }, "/companies/search/similar": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 45234700, "total_pages": 1809388 }, "companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg", "company_name": "Twitter", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "founded_year": 2006, "specialties": [ "Software Development" ], "industry": "Software Development", "domain": "twitter.com", "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a", "domain_id": 224475931, "linkedin_company_id": 44005587, "linkedin_name": "twitter", "is_company_url_active": true, "domain_ids": [ 224475931, 1758889566, 368242865 ], "company_keywords": [ "realtime information", "social commerce", "online shopping", "classifieds", "craigslist killers", "e-commerce", "killers", "consumer internet", "internet", "information technology", "edp services", "technology", "software development", "microblogging", "social networking", "public conversation", "user engagement", "content sharing", "advertising solutions", "monetization", "community building", "digital wallet", "ai integration", "user safety" ], "company_size": 1500, "youtube_url": null, "crunchbase_url": null, "linkedin_url": "http://www.linkedin.com/company/twitter", "instagram_url": null, "facebook_url": "http://facebook.com/twitterinc", "twitter_url": "https://twitter.com/x", "github_url": null, "x_url": null, "location": "United States", "company_ranking": null, "company_url": "http://twitter.com", "saved_lists": null, "company_size_printed": "1,500", "similarity_score": 0.87 }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_name": { "$ref": "#/components/schemas/company_name" }, "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "locations": { "$ref": "#/components/schemas/locations" }, "exclude_locations": { "$ref": "#/components/schemas/exclude_locations" }, "places": { "$ref": "#/components/schemas/places" }, "exclude_places": { "$ref": "#/components/schemas/exclude_places" }, "job_locations": { "$ref": "#/components/schemas/locations" }, "job_exclude_locations": { "$ref": "#/components/schemas/job_exclude_locations" }, "job_posted_dates": { "$ref": "#/components/schemas/posted_dates" }, "job_titles": { "$ref": "#/components/schemas/people_titles" }, "verticals": { "$ref": "#/components/schemas/verticals" }, "vertical_categories": { "$ref": "#/components/schemas/vertical_categories" }, "vertical_sub_categories": { "$ref": "#/components/schemas/vertical_sub_categories" }, "categories": { "$ref": "#/components/schemas/categories" }, "technologies": { "$ref": "#/components/schemas/technologies" }, "employees": { "$ref": "#/components/schemas/employees" }, "revenues": { "$ref": "#/components/schemas/revenues" }, "founded_dates": { "$ref": "#/components/schemas/founded_dates" }, "keywords": { "$ref": "#/components/schemas/keywords" }, "news_categories": { "$ref": "#/components/schemas/news_categories" }, "news_published_dates": { "$ref": "#/components/schemas/published_dates" }, "advertisement_search_terms": { "$ref": "#/components/schemas/advertisement_search_terms" }, "advertisement_target_locations": { "$ref": "#/components/schemas/advertisement_target_locations" }, "advertisement_exclude_target_locations": { "$ref": "#/components/schemas/advertisement_exclude_target_locations" }, "advertisement_start_dates": { "$ref": "#/components/schemas/advertisement_start_dates" }, "advertisement_end_dates": { "$ref": "#/components/schemas/advertisement_end_dates" }, "filter_conditions": { "$ref": "#/components/schemas/company_filter_conditions" }, "is_enable_similarity_search": { "$ref": "#/components/schemas/is_enable_similarity_search" }, "similarity_score": { "$ref": "#/components/schemas/similarity_score" }, "exclude_fields": { "$ref": "#/components/schemas/exclude_fields" }, "is_parameter_metadata_available": { "$ref": "#/components/schemas/is_parameter_metadata_available" }, "is_profile_metadata_available": { "$ref": "#/components/schemas/is_profile_metadata_available" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" }, "company_filters": { "$ref": "#/components/schemas/company_filters" } } } } } }, "operationId": "companies_search_similar", "summary": "유사 회사 검색", "description": "참조 회사와 유사한 회사를 찾습니다. 요청 본문은 `POST /companies/search` 와 동일. `domain_search_id`、`domain`、`domains` 또는 `linkedin_url` 중 하나를 참조로 필요. 각 결과 행에는 `similarity_score`(0.0-1.0, 높을수록 가까움)가 포함되며 유사도 내림차순으로 정렬됩니다.", "tags": [ "Lookalike" ] } }, "/companies/lookalikes/search": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 45234700, "total_pages": 1809388 }, "companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg", "company_name": "Twitter", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "founded_year": 2006, "specialties": [ "Software Development" ], "industry": "Software Development", "domain": "twitter.com", "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a", "domain_id": 224475931, "linkedin_company_id": 44005587, "linkedin_name": "twitter", "is_company_url_active": true, "domain_ids": [ 224475931, 1758889566, 368242865 ], "company_keywords": [ "realtime information", "social commerce", "online shopping", "classifieds", "craigslist killers", "e-commerce", "killers", "consumer internet", "internet", "information technology", "edp services", "technology", "software development", "microblogging", "social networking", "public conversation", "user engagement", "content sharing", "advertising solutions", "monetization", "community building", "digital wallet", "ai integration", "user safety" ], "company_size": 1500, "youtube_url": null, "crunchbase_url": null, "linkedin_url": "http://www.linkedin.com/company/twitter", "instagram_url": null, "facebook_url": "http://facebook.com/twitterinc", "twitter_url": "https://twitter.com/x", "github_url": null, "x_url": null, "location": "United States", "company_ranking": null, "company_url": "http://twitter.com", "saved_lists": null, "company_size_printed": "1,500" }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "locations": { "$ref": "#/components/schemas/locations" }, "exclude_locations": { "$ref": "#/components/schemas/exclude_locations" }, "technologies": { "$ref": "#/components/schemas/technologies" }, "categories": { "$ref": "#/components/schemas/categories" }, "verticals": { "$ref": "#/components/schemas/verticals" }, "vertical_categories": { "$ref": "#/components/schemas/vertical_categories" }, "vertical_sub_categories": { "$ref": "#/components/schemas/vertical_sub_categories" }, "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "domain": { "$ref": "#/components/schemas/domain" }, "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "employees": { "$ref": "#/components/schemas/employees" }, "founded_dates": { "$ref": "#/components/schemas/founded_dates" }, "revenues": { "$ref": "#/components/schemas/revenues" }, "job_locations": { "$ref": "#/components/schemas/locations" }, "job_posted_dates": { "$ref": "#/components/schemas/posted_dates" }, "job_titles": { "$ref": "#/components/schemas/people_titles" }, "news_categories": { "$ref": "#/components/schemas/news_categories" }, "news_published_dates": { "$ref": "#/components/schemas/published_dates" }, "is_enable_similarity_search": { "$ref": "#/components/schemas/is_enable_similarity_search" }, "similarity_score": { "$ref": "#/components/schemas/similarity_score" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "Domain Search ID", "required": [ "domain_search_id" ] }, { "title": "도메인", "required": [ "domain" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] } ] } } } }, "operationId": "companies_search_lookalikes", "summary": "유사 기업 검색", "description": "**더 이상 사용되지 않음.** 대신 `POST /companies/search/similar` 를 사용하세요 — 데이터와 본문 모두 동일합니다.\n\n기업 특성 및 기술 속성을 기반으로 지정된 대상 기업과 유사한 기업을 검색합니다.", "tags": [ "Lookalike" ], "deprecated": true } }, "/companies/jobs/search": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 2228628, "total_pages": 89146, "is_timeout": false }, "jobs": [ { "job_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848", "job_search_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848", "last_modified": "2025-05-31T20:41:27.894Z", "companies": { "logo_url": "https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "539e2c34-de6b-4613-8f5b-e3aa18b4ef47", "company_name": "Google", "linkedin_name": "google", "country_code": "US", "domain": "google.com" }, "location": "Seoul, Seoul, South Korea", "job_url": "https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D", "posting_date": "2025-05-31", "country_code": "KR", "location_id": 491, "title": "Software Engineer, gReach Program for People with Disabilities (장애인 채용)", "country": "South Korea" }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "locations": { "$ref": "#/components/schemas/locations" }, "exclude_locations": { "type": "array", "items": { "type": "string" }, "example": [ "TW" ], "description": "채용 결과에서 제외할 ISO 3166-1 alpha-2 (cca2) 지역 코드입니다. 유효한 코드는 필터 탭의 `location` 엔드포인트를 참조하세요." }, "company_locations": { "$ref": "#/components/schemas/company_locations" }, "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "search_term": { "$ref": "#/components/schemas/search_term" }, "search_terms": { "type": "array", "items": { "type": "string" }, "example": [ "Software Developer" ], "description": "채용 공고를 필터링하기 위한 키워드 문자열 배열입니다. 각 키워드는 채용 내용과 매칭됩니다. 단일 문자열에는 `search_term`을, 여러 키워드에는 `search_terms`를 사용하세요." }, "titles": { "$ref": "#/components/schemas/people_titles" }, "posted_dates": { "$ref": "#/components/schemas/posted_dates" }, "is_realtime_enrichment": { "$ref": "#/components/schemas/is_realtime_enrichment" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "companies_search_jobs", "summary": "채용 공고 검색", "description": "위치, 직책, 게시 날짜 등 지정된 조건에 맞는 기업 채용 공고를 검색합니다.", "tags": [ "Search" ] } }, "/companies/news/search": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 351800, "total_pages": 14072, "is_timeout": false }, "news": [ { "news_id": "0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd", "news_search_id": "4110b929-17cd-42aa-a159-906ead0c9b56", "country_codes": [ "CN", "SG" ], "company_country_codes": [ "CN", "FR" ], "domains": [ "insead.edu", "digitalchina.com" ], "companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "dfbe6797-5311-46f9-9518-bf1a7c3d09bc", "country_code": "FR", "company_name": "Insead", "linkedin_name": "insead", "domain": "insead.edu" }, { "logo_url": "https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "e13a9e24-a07d-4630-9b47-fceb778df74e", "country_code": "CN", "company_name": "Digital China", "linkedin_name": "digital-china", "domain": "digitalchina.com" } ], "news_galleries": [ { "slug": "banking-financial-service", "news_gallery_id": "7c8ec9cc-66c5-4153-82da-9c8f356c6c99", "name": "Banking/Financial Service" } ], "locations": [ "Singapore", "China" ], "expansion_signals": [ { "signal_type_slug": "HIRE", "signal_subtype_slug": null, "signal_strength_slug": "confirmed", "polarity": "expansion", "country_code": "SG", "domain_search_id": "bca54309-b804-48ac-b4f7-ff4d3796570c", "event_date": "2025-06-01T08:00:00.000Z" } ], "last_modified": "2025-06-01T08:15:23.945Z", "image_url": null, "url": "http://enold.prnasia.com/p/asia-story-125304015-0.shtml", "published_at": "2025-06-01T08:00:00.000Z", "language": "id", "source": "prnasia.com", "category": "launches", "title": "Digital China's AI-driven transformation showcased at INSEAD", "summary": "Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey.", "news_category_name": "Launches" }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "locations": { "$ref": "#/components/schemas/locations" }, "company_locations": { "$ref": "#/components/schemas/company_locations" }, "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "search_term": { "$ref": "#/components/schemas/search_term" }, "search_terms": { "type": "array", "items": { "type": "string" }, "example": [ "Trump" ], "description": "뉴스 기사를 필터링하기 위한 키워드 문자열 배열입니다. 각 키워드는 기사 내용과 매칭됩니다. 단일 문자열에는 `search_term`을, 여러 키워드에는 `search_terms`를 사용하세요." }, "categories": { "$ref": "#/components/schemas/news_categories" }, "news_gallery_ids": { "$ref": "#/components/schemas/news_gallery_ids" }, "published_dates": { "$ref": "#/components/schemas/published_dates" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "news_galleries": { "type": "array", "items": { "type": "string" }, "example": [ "electronic-commerce" ], "description": "갤러리별로 뉴스를 필터링하기 위한 `gallery slug` 목록입니다. slug를 확인하려면 필터 탭의 `news galleries` 엔드포인트를 호출하세요." }, "news_languages": { "type": "array", "items": { "type": "string" }, "example": [ "en" ], "description": "언어별로 뉴스를 필터링하기 위한 `locale_code` 값 목록입니다. 사용 가능한 코드를 확인하려면 필터 탭의 `news languages` 엔드포인트를 호출하세요." }, "profile_id": { "$ref": "#/components/schemas/profile_id" }, "is_expansion_signal_available": { "$ref": "#/components/schemas/is_expansion_signal_available" }, "expansion_signal_types": { "$ref": "#/components/schemas/expansion_signal_types" }, "expansion_signal_polarities": { "$ref": "#/components/schemas/expansion_signal_polarities" } } } } } }, "operationId": "companies_search_news", "summary": "기업 뉴스 검색", "description": "카테고리, 위치, 키워드 등 지정된 조건에 맞는 기업 관련 뉴스 기사를 검색합니다.", "tags": [ "Search" ] } }, "/redeem/people/batch/query": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "profile": { "credit": 450376, "topup_credit": 235237, "total_charged_credit": 465 }, "query": { "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701", "is_completed": true, "estimated_time": 6, "estimated_time_type": "second" }, "peoples": [ { "people_search_id": "540574d1-ff74-475b-aea2-f8ae643b806d", "emails": [ { "value": "example@gmail.com", "type": "email-personal", "status": null }, { "value": "example@pubrio.com", "type": "email-work", "status": "Verified" } ], "phones": [ { "value": "+1123456789", "type": "phone", "status": null } ] }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "redeem_query_id": { "$ref": "#/components/schemas/redeem_query_id" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "redeem_query_id" ] } } } }, "operationId": "redeem_people_batch_query", "summary": "배치 교환 상태 조회", "description": "이전에 제출한 배치 교환 요청의 상태와 결과를 확인합니다.", "tags": [ "Redeem" ] } }, "/redeem/people/batch": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701", "is_completed": false, "estimated_time": 6, "estimated_time_type": "second" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "peoples": { "$ref": "#/components/schemas/peoples" }, "people_contact_types": { "$ref": "#/components/schemas/people_contact_types" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "peoples", "people_contact_types" ] } } } }, "operationId": "redeem_people_batch", "summary": "인물 연락처 일괄 교환", "description": "여러 인물의 연락처 정보를 한 번에 잠금 해제하는 배치 요청을 제출합니다.", "tags": [ "Redeem" ] } }, "/redeem/people": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "profile": { "credit": 450376, "topup_credit": 235237, "total_credit_cost": 45 }, "peoples": [ { "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4", "emails": [ { "value": "example@gmail.com", "type": "email-personal", "status": null }, { "value": "example@pubrio.com", "type": "email-work", "status": "Verified" } ], "phones": [ { "value": "+1123456789", "type": "phone", "status": null } ] } ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "people_search_id": { "$ref": "#/components/schemas/people_search_id" }, "linkedin_url": { "$ref": "#/components/schemas/people_linkedin_url" }, "people_contact_types": { "$ref": "#/components/schemas/people_contact_types" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "People Search ID", "required": [ "people_search_id", "people_contact_types" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url", "people_contact_types" ] } ] } } } }, "operationId": "redeem_people", "summary": "인물 연락처 교환", "description": "크레딧을 사용하여 특정 인물의 전체 연락처 정보(이메일, 전화번호)를 잠금 해제합니다.", "tags": [ "Redeem" ] } }, "/redeem/people/contact/lookup": { "post": { "responses": { "200": { "description": "매칭된 인물과 매칭 메타데이터가 포함된 성공 응답.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "profile": { "credit": 450375, "topup_credit": 235236, "total_credit_cost": 1 }, "peoples": [ { "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4", "first_name": "King", "last_name": "Lai", "people_name": "King Lai", "company_name": "Pubrio", "domain": "pubrio.com", "match": { "confidence": "exact", "input": { "value": "king.lai@pubrio.com", "type": "email-work" }, "is_duplicate_input": false } } ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "$ref": "#/components/schemas/contact_lookup_email" }, "phone": { "$ref": "#/components/schemas/contact_lookup_phone" }, "first_name": { "$ref": "#/components/schemas/contact_lookup_first_name" }, "last_name": { "$ref": "#/components/schemas/contact_lookup_last_name" }, "domain": { "$ref": "#/components/schemas/contact_lookup_domain" }, "company": { "$ref": "#/components/schemas/contact_lookup_company" }, "is_enable_similarity_search": { "$ref": "#/components/schemas/contact_lookup_is_enable_similarity_search" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "이메일", "required": [ "email" ] }, { "title": "전화번호", "required": [ "phone" ] }, { "title": "이름 + 도메인(유사도 매칭)", "required": [ "first_name", "last_name", "domain", "is_enable_similarity_search" ] }, { "title": "이름 + 회사명(유사도 매칭)", "required": [ "first_name", "last_name", "company", "is_enable_similarity_search" ] } ] } } } }, "operationId": "redeem_people_contact_lookup", "summary": "연락처 식별자로 인물 조회", "description": "이메일, 전화번호, 또는 (유사도 검색이 활성화된 경우) 이름 + 성 + 도메인이나 회사명으로 인물을 역조회합니다. 매칭된 인물의 `people_search_id` 와 기본 정보, 매칭 방식을 설명하는 `match` 메타데이터를 반환합니다. 청구 가능한 매칭당 1 크레딧을 차감합니다.", "tags": [ "Redeem" ] } }, "/redeem/people/contact/lookup/batch": { "post": { "responses": { "200": { "description": "매칭된 인물과 항목별 매칭 메타데이터가 포함된 성공 응답.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "profile": { "credit": 450374, "topup_credit": 235236, "total_credit_cost": 2 }, "peoples": [ { "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4", "people_name": "King Lai", "company_name": "Pubrio", "domain": "pubrio.com", "match": { "confidence": "exact", "input": { "value": "king.lai@pubrio.com", "type": "email-work" }, "is_duplicate_input": false } }, { "people_search_id": "1c4f0a9d-9a8e-4ab0-9b07-2cd09c4a3a6b", "people_name": "John Smith", "company_name": "Example", "domain": "example.com", "match": { "confidence": "similarity_domain", "input": { "value": "example.com", "type": "domain" }, "is_duplicate_input": false } } ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "peoples": { "$ref": "#/components/schemas/contact_lookup_peoples" }, "is_enable_similarity_search": { "$ref": "#/components/schemas/contact_lookup_is_enable_similarity_search" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "peoples" ] } } } }, "operationId": "redeem_people_contact_lookup_batch", "summary": "연락처 식별자로 인물 일괄 조회", "description": "`/redeem/people/contact/lookup` 의 일괄 버전입니다. 한 요청에서 구독의 일괄 크기 제한까지 제출할 수 있습니다. `peoples` 의 각 항목은 단일 조회 본문과 동일한 식별자를 허용합니다. 청구 가능한 매칭당 1 크레딧을 차감합니다 — 중복 입력 및 일치하지 않는 항목은 과금되지 않습니다.", "tags": [ "Redeem" ] } }, "/locations": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "location_id": 472, "flag": "🇦🇩", "idd": { "root": "+3", "suffixes": [ "76" ] }, "dial_code": "+376", "iso_code": "AD", "location_name": "Andorra" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_locations", "summary": "사용 가능한 지역 목록", "description": "검색 필터에 사용할 수 있는 지역 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/technologies": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "icon": "Cart-generic.svg", "name": "Cart Functionality", "tag_id": 6630, "website": "https://www.shopify.com/blog/shopping-cart", "logo_url": "https://buckets.pubrio.com/technology-logo/NjYzMGIyOXNtYjhheGNhcnQtZnVuY3Rpb25hbGl0eQ==.jpg", "categories": [ { "name": "Ecommerce", "category_id": 26 }, { "name": "Programming languages", "category_id": 707847256 } ] }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keyword": { "$ref": "#/components/schemas/keyword" } } } } } }, "operationId": "filters_list_technologies", "summary": "사용 가능한 기술 목록", "description": "검색 필터에 사용할 수 있는 기술 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/technologies/categories": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "category_id": 2159464, "slug": "remote-access", "name": "Remote access" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keyword": { "$ref": "#/components/schemas/keyword" } } } } } }, "operationId": "filters_list_technology_categories", "summary": "기술 카테고리 목록", "description": "필터링에 사용할 기술 카테고리 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/verticals": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "vertical_id": 69276002, "slug": "ai", "vertical_identifier": "99b5d4d2-ca62-4193-a4de-6b20be4bdf8d", "vertical_sub_category_id": 120, "vertical_category_id": 18, "name": "AI", "name_en": "AI" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keyword": { "$ref": "#/components/schemas/keyword" } } } } } }, "operationId": "filters_list_verticals", "summary": "산업 버티컬 목록", "description": "필터링에 사용할 산업 버티컬 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/verticals/categories": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "vertical_category_id": 6, "gics_sector_code": 25, "gics_industry_group_code": 2510, "vertical_category_identifier": "d968669f-9379-4027-98d9-f4df49da1d4d", "description": null, "slug": "automobiles-components", "name": "Automobiles & Components", "name_en": "Automobiles & Components" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keyword": { "$ref": "#/components/schemas/keyword" } } } } } }, "operationId": "filters_list_vertical_categories", "summary": "버티컬 카테고리 목록", "description": "필터링에 사용할 버티컬 카테고리 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/verticals/sub_categories": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "vertical_sub_category_id": 134, "gics_sector_code": 50, "gics_industry_group_code": 5020, "gics_sub_industry_group_code": 50201010, "vertical_sub_category_identifier": "dd2dc328-9ff6-4f7a-aee8-fdf1d09d856d", "description": null, "slug": "advertising", "name": "Advertising" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keyword": { "$ref": "#/components/schemas/keyword" } } } } } }, "operationId": "filters_list_vertical_sub_categories", "summary": "버티컬 하위 카테고리 목록", "description": "필터링에 사용할 버티컬 하위 카테고리 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/companies/news/categories": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "news_category_id": "d1920fb3-977d-4a4d-8f7a-72e21d81e5b9", "slug": "acquires", "name": "Mergers & Acquisitions", "name_en": "Mergers & Acquisitions" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_news_categories", "summary": "뉴스 카테고리 목록", "description": "필터링에 사용할 뉴스 기사 카테고리 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/companies/news/galleries": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "news_gallery_id": "97a01204-cf56-43ad-98d2-e4991152b148", "slug": "art-fashion", "name": "Art/Fashion", "name_en": "Art/Fashion" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_news_galleries", "summary": "뉴스 갤러리 목록", "description": "필터링에 사용할 뉴스 갤러리 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/profile": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "profile_id": 1, "credit": 457499, "topup_credit": 235237, "name": "Pubrio", "description": null, "is_auto_top_up_credits_enabled": false, "auto_top_up_credit": 2500, "auto_top_up_balance_fall_below": 500, "subscription": { "id": 7, "credit": 2250, "max_api_monthly_query": 0, "max_api_daily_query": 0, "max_api_hourly_query": 0, "is_not_able_to_subscribe": false, "max_portal_monthly_query": 60000, "max_portal_daily_query": 2000, "max_portal_hourly_query": 1000, "amount": 59, "is_custom_plan": false, "currency_id": 14, "currency": "usd", "topup_credit_amount": 0.035, "name": "Business - Annual Subscription", "slug": "business-annual", "collection": "business", "is_annual": true, "is_default": null, "identifier": "2618b67a-cc4d-4fd1-bbe8-f906e4f6632d", "last_charged": "2024-11-09T03:40:41.995Z", "next_charge_date": "2025-11-09T03:40:41.995Z", "last_usage_charged": "2024-10-30T15:01:54.895Z", "next_usage_charge_date": "2024-11-13T15:01:54.895Z", "last_refill_date": "2024-11-09T03:40:41.995Z", "next_refill_date": "2024-12-09T03:40:41.995Z", "usage_charge_period": 2, "usage_charge_period_type": "week", "charge_period": 12, "charge_period_type": "month", "web_intent_signal_credit": 25, "max_search_page": 100, "max_search_per_page": 25, "phone_number_redeem_credit": 30, "email_redeem_credit": 15, "people_search_credit": 3, "company_search_credit": 1, "data_export_credit": 1, "max_session_per_page": 100, "max_export_limit": 25000, "max_select_limit": 5000, "max_record_upload_size": 100000, "max_company_search_select_limit": 1000, "max_people_search_select_limit": 25, "max_channel_email_account": 1, "max_channel_linkedin_account": 1, "max_channel_slack_account": 0, "is_full_export_available": true, "is_api_access_available": false, "is_add_user_available": true, "is_refill_without_charge": false, "is_skip_user_related_calculation": false, "is_credit_rollover_available": false, "is_quota_sharing_available": true, "last_modified": "2024-11-09T03:40:41.995Z", "total_credit_used": 7025, "total_charge_credit": 7000, "credit_refill": 459000, "total_amount": 8988, "products": [ { "currency_id": 14, "currency": "usd", "waived_quantity": 6, "is_full_waived": false, "id": 3, "name": "Additional User Licence", "slug": "additional-user-licence", "quantity": 16, "amount": 59, "prorated_amount": 11328, "metadata": { "next_charge_date": "2025-11-09T03:40:41.995Z", "is_annual": true, "charge_period": 12, "charge_period_type": "month", "total_used_subscription": 16, "total_user_subscriptions": 33 }, "total_amount": 7080 }, { "currency_id": 14, "currency": "usd", "waived_quantity": 0, "is_full_waived": false, "id": 5, "name": "Profile Subscription", "slug": "profile-subscription", "quantity": 1, "amount": 59, "prorated_amount": 708, "metadata": { "next_charge_date": "2025-11-09T03:40:41.995Z", "is_annual": true, "charge_period": 12, "charge_period_type": "month" }, "total_amount": 708 } ], "usage_products": [ { "currency_id": 14, "currency": "usd", "waived_quantity": 1, "is_full_waived": false, "id": 2, "name": "Website Intent Data", "slug": "website-intent-data", "quantity": 281, "amount": 0.88, "prorated_amount": 245.88, "metadata": { "web_intent_signal_credit": 25, "topup_credit_amount": 0.035 }, "total_amount": 245, "total_credit_used": 7025, "total_charge_credit": 7000 } ] } } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "profile_get", "summary": "워크스페이스 프로필 조회", "description": "플랜 정보 및 설정을 포함한 현재 워크스페이스 프로필 상세 정보를 조회합니다.", "tags": [ "Profile" ] } }, "/profile/usage": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "api_monthly_usage": 0, "api_daily_usage": 0, "api_hourly_usage": 0, "api_last_refreshed": "2024-11-13T10:01:13.051Z", "portal_monthly_usage": 848, "portal_daily_usage": 163, "portal_hourly_usage": 4, "portal_last_refreshed": "2024-11-13T10:01:13.051Z", "max_api_monthly_query": 0, "max_api_daily_query": 0, "max_api_hourly_query": 0, "max_portal_monthly_query": 60000, "max_portal_daily_query": 2000, "max_portal_hourly_query": 1000, "total_max_api_monthly_query": 0, "total_max_api_daily_query": 0, "total_max_api_hourly_query": 0, "total_max_portal_monthly_query": 2040000, "total_max_portal_daily_query": 68000, "total_max_portal_hourly_query": 34000, "is_api_access_available": false, "is_quota_sharing_enabled": true, "is_quota_sharing_available": true } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "profile_get_usage", "summary": "워크스페이스 사용량 통계 조회", "description": "현재 워크스페이스 프로필의 크레딧 사용량 및 할당량 통계를 조회합니다.", "tags": [ "Profile" ] } }, "/user": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "timezone_id": 172, "language": "en", "referral_code": "f438ace", "email": "king.lai@pubrio.com", "user_id": "2981d4b3-f8b1-44d8-9759-8f3faf89bfa2", "nickname": "King Lai", "raw_phone_number": "12345679", "phone_number": "12345679", "company": "Pubrio", "profiles": [ { "profile_id": 1, "name": "Pubrio" } ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "user_get", "summary": "현재 사용자 정보 조회", "description": "현재 인증된 사용자의 상세 정보를 조회합니다.", "tags": [ "Profile" ] } }, "/timezones": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "timezone_id": 1, "timezone": "Africa/Abidjan", "utc_offset": "+00:00" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_timezones", "summary": "시간대 목록", "description": "지원되는 시간대 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/management_levels": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "management_level_id": 3, "slug": "c_suite", "name": "C suite" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_management_levels", "summary": "관리 직급 목록", "description": "필터링에 사용할 관리 및 직급 수준 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/departments/title": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "department_id": 10, "slug": "consulting", "name": "Consulting" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_department_titles", "summary": "부서 직함 목록", "description": "필터링에 사용할 부서 직함 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/departments/function": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "department_function_id": 53, "slug": "accounting", "name": "Accounting" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_department_functions", "summary": "부서 기능 목록", "description": "필터링에 사용할 부서 기능 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/company_sizes": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "company_size_id": 1, "slug": "1-20", "name": "1 - 20" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_company_sizes", "summary": "기업 규모 옵션 목록", "description": "필터링에 사용할 기업 규모 카테고리 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/people/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946", "name": "Doug McMillon", "first_name": "Doug", "last_name": "McMillon", "title": "President & CEO", "seniority": "c_suite", "functions": null, "headline": "President & CEO at Walmart Inc.", "departments": [ "c_suite" ], "subdepartments": [ "executive" ], "keywords": null, "employment_history": [ { "title": "President & CEO", "current": true, "end_date": null, "start_date": "2014-02-01", "company_name": "Walmart" }, { "title": "President & CEO, Walmart International", "current": false, "end_date": "2014-01-01", "start_date": "2009-02-01", "company_name": "Walmart" }, { "title": "President & CEO", "current": false, "end_date": "2009-01-01", "start_date": "2005-08-01", "company_name": "Sam's Club" } ], "location": "United States", "state": "Arkansas", "city": "Bentonville", "contacts": null, "emails": null, "phones": null, "facebook_url": null, "github_url": null, "twitter_url": null, "linkedin_url": "http://www.linkedin.com/in/dougmcmillon", "saved_lists": null, "company": { "company_name": "Walmart", "company_url": "http://walmart.com", "domain_id": 26067151, "domain_ids": [ 757023267, 368242703, 26067151 ], "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6", "founded_year": 1962, "location": "United States", "phones": null, "company_size_printed": "466,000", "company_size": 466000, "industry": "Retail", "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg", "linkedin_url": "http://www.linkedin.com/company/walmart", "facebook_url": "http://facebook.com/walmart", "twitter_url": "https://twitter.com/walmart", "crunchbase_url": null, "instagram_url": "http://instagram.com/walmart", "youtube_url": "http://youtube.com/user/walmart" } } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "people_search_id": { "$ref": "#/components/schemas/people_search_id" }, "linkedin_url": { "$ref": "#/components/schemas/people_linkedin_url" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "People Search ID", "required": [ "people_search_id" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] } ] } } } }, "operationId": "people_lookup", "summary": "ID로 인물 조회", "description": "Pubrio 검색 ID 또는 LinkedIn URL을 사용하여 특정 인물의 상세 정보를 조회합니다.", "tags": [ "Lookup" ] } }, "/people/linkedin/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "linkedin_name": "jeffweiner08", "linkedin_url": "https://www.linkedin.com/in/jeffweiner08", "name": "Jeff Weiner", "created_at": "2025-06-08T16:58:16.145Z", "image_url": "https://media.licdn.com/dms/image/v2/C4D16AQFJHyicpAYHXQ/profile-displaybackgroundimage-shrink_200_800/profile-displaybackgroundimage-shrink_200_800/0/1515797967677?e=2147483647&v=beta&t=bAdvQ-o7JZ1b7OKSKau1vB3DMZIHPtefC40_43yzasI", "logo_url": "https://media.licdn.com/dms/image/v2/C4D03AQFM3Y2r-OEStw/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1515623804978?e=2147483647&v=beta&t=8gxxYGav4qEN7hXdbULm_h_JbZKg9lreAZ7HPXDUbF0", "headline": "Executive Chairman at LinkedIn / Founding Partner Next Play Ventures", "description": "Jeff Weiner is the executive chairman of LinkedIn, where he continues to help LinkedIn realize its vision of creating economic opportunity for every member of the global workforce through mentorship, coaching and advising current leadership. \n\nPrior to becoming executive chairman in June 2020, Jeff was the CEO of LinkedIn. During his 11-year tenure, LinkedIn grew its membership base from 33M to more than 690M, increased its revenue from $78M to over $7.9B and expanded the team from 338 employees to over 16,000.\n\nIn addition to his ongoing work at LinkedIn, Jeff is the founding partner of Next Play Ventures, where he’s focused on investing in and coaching early stage start-ups and growth stage companies. \n\nHe is also a founding LP and serves on the Investment Committee of Concrete Rose Capital, an early stage venture fund focused on investing in diverse founders, start-ups serving underserved communities and/or building diverse teams. \n\nJeff is also the co-founder of The Compassion Project, whose mission is to ensure compassion is taught in every elementary school in the U.S.\n\nHe presently resides on the board of directors of Donorschoose.org. \n\nPrior to LinkedIn, Jeff was an Executive in Residence at Accel Partners and Greylock Partners, primarily focused on advising the leadership teams of the firm's existing consumer technology portfolio companies while also working closely with the firm’s partners to evaluate new investment opportunities.\n\nPreviously, he served in key leadership roles at Yahoo! for over seven years, including Executive Vice President of Yahoo!'s Network Division managing Yahoo's consumer web product portfolio, including Yahoo's Front Page, Mail, Search, and Media products.", "country_code": "US", "location": null, "city": "United States", "linkedin_uid": "22330283", "company": { "linkedin_url": "https://www.linkedin.com/company/linkedin", "company_name": "LinkedIn", "linkedin_name": "linkedin", "location": null }, "employment_history": [ { "title": "LinkedIn", "company_name": "LinkedIn", "linkedin_name": "linkedin", "linkedin_url": "https://www.linkedin.com/company/linkedin?trk=public_profile_experience-group-header", "logo_url": null, "positions": [ { "subtitle": "LinkedIn", "meta": "Jul 2020 - Present 5 years", "start_date": "Jul 2020", "end_date": "Present", "title": "Executive Chairman", "description_html": null, "location": null }, { "subtitle": "LinkedIn", "meta": "Dec 2008 - Jun 2020 11 years 7 months", "start_date": "Dec 2008", "end_date": "Jun 2020", "title": "CEO", "description_html": null, "location": null } ], "duration": "16 years 7 months", "unformatted_description": null }, "..." ], "follower_size": 10410599, "connection_size": 500, "recommendations": [ "Akosua Boadi-Agyemang “Personally, Jeff, has impacted my journey so much during his tenure as CEO of LinkedIn. In so doing, he has shown me the true personification of servant leadership. Jeff has showed up for me in ways that have changed the trajectory of my career and life, and he did so without knowing me, initially. While I was searching for an internship in 2017, Jeff showed up (commented on my LinkedIn post) and said “Akosua, would be surprised if something doesn’t materialize.” This played a massive part in where I am in my career at Microsoft today. He showed up to support my first LinkedIn Live stream as a beta tester for the feature. I told him the day and time. I was nervous, had never beta tested anything before. I asked the audience “can anyone see and hear me?” and he showed up, saying, “can hear and see you perfectly”. His support is incredible. When I wrote my first article documenting #theBOLDjourney, Jeff showed up - “This is just the beginning.” Again with the encouragement. To say the least, Jeff has used his power and platform as CEO of LinkedIn to not only empower me but, to uplift millions, globally. In addition, through the #plusonepledge he initiated during his tenure, he ensured that others show up for one another, as well. Jeff, thank you for always showing up. And for embodying the true meaning of the Ngoni Bantu word, “Ubuntu” (I am, because we are).”", "Derek E. Baird, M.Ed. “While I was at Yahoo!, I had the honor of working for Jeff on the Yahoo! Teachers social networking product. Jeff was our executive sponsor on this project and he was our strongest and most passionate advocate. His knowledge of the consumer Internet and youth media space was invaluable and his strategic eye was instrumental in moving our product from a hack day idea into a full beta. On this project Jeff also demonstrated his deep and unwavering commitment to social responsibility. Jeff is a doer. Throughout his tenure on this project he was always more than willing to channel the many resources at Yahoo!, as well as his many connections, to help improve public education in this country. Jeff is a truly exceptional, visionary and inspiring leader. It was a true pleasure to have had the opportunity to work for Jeff Weiner. It was, and continues to be, a highlight of my career.”" ], "honors_and_awards": null, "education": null, "bio": [ { "title": "Company Website", "url": "http://www.linkedin.com/" }, "..." ], "people_also_viewed": [ { "linkedin_url": "https://www.linkedin.com/in/coppedge?trk=public_profile_browsemap-profile", "name": "Rob Coppedge", "headline": null, "location": "Portland, Oregon Metropolitan Area" }, "..." ], "similar_profiles": [ { "linkedin_url": "https://www.linkedin.com/in/coppedge", "name": "Rob Coppedge", "headline": null }, "..." ], "recent_activities": [ { "id": "7328934302337945608", "linkedin_url": "https://www.linkedin.com/posts/akothari_next-play-a-mindset-i-picked-up-from-activity-7328934302337945608-hfLO", "title": "“Next play!” —A mindset I picked up from Jeff, and I believe he got it from Coach K. Doesn’t matter if you just crushed it or slipped up — keep…", "interaction": "Liked by Jeff Weiner", "image_url": "https://media.licdn.com/dms/image/v2/D5605AQFsD_LNcQzcKA/videocover-high/B56ZbWa0QpH0B4-/0/1747354093631?e=2147483647&v=beta&t=cqAOZlz3UZdpiX7O-HSMwAROHRS_R8KzIbsp7nAUyfE" }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "linkedin_url": { "$ref": "#/components/schemas/people_linkedin_url" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "linkedin_url" ] } } } }, "operationId": "people_lookup_linkedin", "summary": "LinkedIn URL로 인물 조회", "description": "LinkedIn 프로필 URL을 사용하여 인물 상세 정보를 조회합니다. 실시간 데이터 조회를 제공합니다.", "tags": [ "LinkedIn" ] } }, "/companies/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "logo_url": "https://buckets.pubrio.com/company-logo/NzMwNTQzMzkzaWxqOXNzbmoxbmV0ZmxpeC5jb21saW5rZWRpbl8zMzMxMjk0OQ==.jpg", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "estimated_revenue": 38900000000, "publicly_traded_symbol": "NFLX", "publicly_traded_exchange": "nasdaq", "specialties": [ "Entertainment", "Entertainment Providers", "Telecommunications", "Media Production" ], "company_keywords": [ "consumer electronics", "games", "entertainment", "consumer internet", "hardware", "information technology", "internet", "revolutionizing the way people watch tv shows & movies" ], "company_ranking": 232, "title": "Netflix - Watch TV Shows Online, Watch Movies Online", "description": "Netflix is one of the world's leading entertainment services with over 247 million paid memberships in over 190 countries enjoying TV series, films and games across a wide variety of genres and languages. Members can play, pause and resume watching as much as they want, anytime, anywhere, and can change their plans at any time.", "company_address": "100 Winchester Circle, Los Gatos, Ca, Us", "company_name": "Netflix", "founded_year": 1997, "industry": "Entertainment", "domain": "netflix.com", "domain_search_id": "575463e2-474d-4f0a-acc3-fdc2be51e07e", "domain_id": 70635725, "linkedin_company_id": 33312949, "domain_ids": [ 585935484, 730543393, 368242675, 70635725 ], "company_size": 16000, "company_size_printed": "16,000", "youtube_url": null, "crunchbase_url": null, "linkedin_url": "http://www.linkedin.com/company/netflix", "instagram_url": "http://instagram.com/netflix", "facebook_url": "http://facebook.com/netflixus", "twitter_url": "https://twitter.com/netflix", "github_url": null, "x_url": null, "country_code": "US", "location": "United States", "company_url": "http://netflix.com", "company_addresses": [ "100 Winchester Circle Los Gatos, CA, US", "5808 W Sunset Blvd Los Angeles, CA 90028, US", "Alameda Xingu, 350 Barueri, SP 06455-030, BR", "245 W 17th St New York, 10011, US", "Stadhouderskade 55 Amsterdam, North Holland 1072 AB, NL", "9 Straits Vw Marina South, 01, SG", "Av. Paseo De La Reforma 483 Torre Reforma, Floor 37 Mexico City, Cuauhtémoc 06500, MX" ], "saved_lists": null } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "domain": { "$ref": "#/components/schemas/domain" }, "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "Domain Search ID", "required": [ "domain_search_id" ] }, { "title": "도메인", "required": [ "domain" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] } ] } } } }, "operationId": "companies_lookup", "summary": "ID로 기업 조회", "description": "Pubrio 검색 ID, 도메인 또는 LinkedIn URL을 사용하여 특정 기업의 상세 정보를 조회합니다.", "tags": [ "Lookup" ] } }, "/companies/linkedin/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "linkedin_name": "stripe", "linkedin_url": "https://www.linkedin.com/company/stripe", "created_at": "2025-06-01T10:13:03.994Z", "image_url": "https://media.licdn.com/dms/image/v2/C561BAQEd_16iHeIr1Q/company-background_10000/company-background_10000/0/1594068230381/stripe_cover?e=2147483647&v=beta&t=o62bVF0Z15cf0OFikrsuge1xW-iQR4Td6cSOXrMip6I", "logo_url": "https://media.licdn.com/dms/image/v2/D4E0BAQFqiwiSMcKk6A/company-logo_200_200/company-logo_200_200/0/1724937022726/stripe_logo?e=2147483647&v=beta&t=--CED0oRQUupcr1Q2MktzOErO8NMpjCjxa4-JiqrGzU", "company_type": "Privately Held", "company_name": "Stripe", "title": "Help increase the GDP of the internet.", "description": "Stripe builds programmable financial services. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.", "unformatted_description": "\n Stripe builds programmable financial services. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.\n ", "linkedin_uid": "2135371", "founded_year": 2010, "follower_size": 1045523, "company_addresses": [ "515 N State St, Chicago, Illinois 60610, US", "..." ], "unformatted_company_addresses": [ "515 N State St Chicago, Illinois 60610, US", "..." ], "headquarters": "South San Francisco, California", "company_address": "South San Francisco, California", "country_codes": [ "US", "..." ], "company_address_directions": [ { "directions_url": "https://www.bing.com/maps?where=354+Oyster+Point+Blvd+South+San+Francisco+94080+California+US&trk=org-locations_url" }, "..." ], "country_code": "US", "company_size": 11833, "unformatted_company_size": "5,001-10,000 employees", "company_size_printed": "11,900+", "industry": "Technology, Information And Internet", "funding_status": { "last_round_date": "2024-05-12T00:00:00.000Z", "last_round_type": "Secondary market", "rounds": 0, "last_round_raised": "US$ 694.2M" }, "additional_information": "Additional jobs info: Stripe (2,886 open jobs). Analyst (694,057 open jobs). Engineer (555,845 open jobs). Manager (1,880,925 open jobs). Account Executive (71,457 open jobs). Associate (1,091,945 open jobs). Director (1,220,357 open jobs). Marketing Manager (106,879 open jobs). Scientist (48,969 open jobs). Project Manager (253,048 open jobs). Account Manager (121,519 open jobs). Developer (258,935 open jobs). Software Engineer (300,699 open jobs). Product Manager (199,941 open jobs). Intern (71,196 open jobs). Specialist (768,666 open jobs). Vice President (235,270 open jobs). Executive (690,514 open jobs). Senior Software Engineer (78,145 open jobs). Solutions Architect (100,488 open jobs)", "alumni": null, "alumni_information": null, "crunchbase_url": "https://www.crunchbase.com/organization/stripe?utm_source=linkedin&utm_medium=referral&utm_campaign=linkedin_companies&utm_content=profile_cta_anon&trk=funding_crunchbase", "company_url": "https://stripe.com/", "domain": "stripe.com", "unique_domain": "stripe.com", "similar_companies": [ { "linkedin_url": "https://www.linkedin.com/company/joinsquare?trk=similar-pages", "company_name": "Square", "industry": "Software Development", "location": "San Francisco, CA" }, "..." ], "affiliated_pages": [ { "linkedin_url": "https://www.linkedin.com/showcase/stripe-partner-ecosystem/?trk=affiliated-pages", "title": "Stripe Partner Ecosystem", "subtitle": "Internet Publishing", "location": "South San Francisco, California" } ], "people": [ { "linkedin_url": "https://www.linkedin.com/in/krishnanrajagopalan?trk=org-employees", "name": "Krishnan Rajagopalan", "headline": "Founder/Global Expansion/Product Incubation | Stripe, Netflix,...", "logo_url": "https://media.licdn.com/dms/image/v2/C5603AQFZAI0yL2gFMg/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1604036687597?e=2147483647&v=beta&t=4XvEQpAzyC6VkTwjEJoipu-RzjVZlghMKRJ9T-bq7gg" }, "..." ], "recent_activities": [ { "likes_count": 229, "text": "For businesses, sending payouts can be slow, costly, and error-prone. One of the hardest parts about sending money is accurately collecting recipient information like bank account details. Global Payouts allows you to send money to third parties with only their email address. Recipients can instantly authenticate their bank details, decreasing failed payouts by 88%: https://lnkd.in/gCfPBKPH .", "time": "5d", "title": "Stacey Wong", "comments_count": 14, "images": [ "https://media.licdn.com/dms/image/sync/v2/D4D27AQG-wcPKYC6OSw/articleshare-shrink_800/B4DZcxj37wGcAM-/0/1748883180077?e=2147483647&v=beta&t=qf6nEEODJRERCfkaegnnDuc0zqIg7NOZX5SXzGsr9Pw" ], "post_url": "https://www.linkedin.com/posts/stripe_activity-7335388680838152194-vzX3", "post_id": "7335388680838152194", "date": "2025-06-03T10:13:03.854Z", "tagged_companies": null, "tagged_people": null, "repost": { "repost_url": null, "repost_id": null, "repost_text": null, "repost_date": null, "tagged_companies": null, "tagged_users": null, "images": null, "videos": null, "external_links": null, "repost_hangtags": null, "repost_followers": null, "repost_title": null } }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "linkedin_url" ] } } } }, "operationId": "companies_lookup_linkedin", "summary": "LinkedIn URL로 기업 조회", "description": "LinkedIn 회사 페이지 URL을 사용하여 기업 상세 정보를 조회합니다. 실시간 데이터 조회를 제공합니다.", "tags": [ "LinkedIn" ] } }, "/companies/similar/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "logo_url": "https://buckets.pubrio.com/company-logo/NzMwNTQzMzkzaWxqOXNzbmoxbmV0ZmxpeC5jb21saW5rZWRpbl8zMzMxMjk0OQ==.jpg", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "estimated_revenue": 38900000000, "publicly_traded_symbol": "NFLX", "publicly_traded_exchange": "nasdaq", "specialties": [ "Entertainment", "Entertainment Providers", "Telecommunications", "Media Production" ], "company_keywords": [ "consumer electronics", "games", "entertainment", "consumer internet", "hardware", "information technology", "internet", "revolutionizing the way people watch tv shows & movies" ], "company_ranking": 232, "title": "Netflix - Watch TV Shows Online, Watch Movies Online", "description": "Netflix is one of the world's leading entertainment services with over 247 million paid memberships in over 190 countries enjoying TV series, films and games across a wide variety of genres and languages. Members can play, pause and resume watching as much as they want, anytime, anywhere, and can change their plans at any time.", "company_address": "100 Winchester Circle, Los Gatos, Ca, Us", "company_name": "Netflix", "founded_year": 1997, "industry": "Entertainment", "domain": "netflix.com", "domain_search_id": "575463e2-474d-4f0a-acc3-fdc2be51e07e", "domain_id": 70635725, "linkedin_company_id": 33312949, "domain_ids": [ 585935484, 730543393, 368242675, 70635725 ], "company_size": 16000, "company_size_printed": "16,000", "youtube_url": null, "crunchbase_url": null, "linkedin_url": "http://www.linkedin.com/company/netflix", "instagram_url": "http://instagram.com/netflix", "facebook_url": "http://facebook.com/netflixus", "twitter_url": "https://twitter.com/netflix", "github_url": null, "x_url": null, "country_code": "US", "location": "United States", "company_url": "http://netflix.com", "company_addresses": [ "100 Winchester Circle Los Gatos, CA, US", "5808 W Sunset Blvd Los Angeles, CA 90028, US", "Alameda Xingu, 350 Barueri, SP 06455-030, BR", "245 W 17th St New York, 10011, US", "Stadhouderskade 55 Amsterdam, North Holland 1072 AB, NL", "9 Straits Vw Marina South, 01, SG", "Av. Paseo De La Reforma 483 Torre Reforma, Floor 37 Mexico City, Cuauhtémoc 06500, MX" ], "saved_lists": null } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "domain": { "$ref": "#/components/schemas/domain" }, "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "Domain Search ID", "required": [ "domain_search_id" ] }, { "title": "도메인", "required": [ "domain" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] } ] } } } }, "operationId": "companies_lookup_similar", "summary": "유사 기업 조회", "description": "Pubrio 검색 ID, 도메인 또는 LinkedIn URL을 사용하여 지정된 기업과 유사한 기업을 조회합니다.", "tags": [ "Lookup" ] } }, "/companies/jobs/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "job_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848", "job_search_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848", "last_modified": "2025-05-31T20:41:27.894Z", "companies": { "logo_url": "https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "539e2c34-de6b-4613-8f5b-e3aa18b4ef47", "company_name": "Google", "linkedin_name": "google", "country_code": "US", "domain": "google.com" }, "location": "Seoul, Seoul, South Korea", "job_url": "https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D", "posting_date": "2025-05-31", "country_code": "KR", "location_id": 491, "title": "Software Engineer, gReach Program for People with Disabilities (장애인 채용)", "country": "South Korea" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_search_id": { "$ref": "#/components/schemas/job_search_id" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "job_search_id" ] } } } }, "operationId": "companies_lookup_jobs", "summary": "기업 채용 공고 조회", "description": "채용 검색 ID를 사용하여 특정 기업의 채용 공고 상세 정보를 조회합니다.", "tags": [ "Lookup" ] } }, "/companies/news/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "news_id": "0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd", "news_search_id": "4110b929-17cd-42aa-a159-906ead0c9b56", "keywords": [ "AI", "Digital China", "INSEAD", "manajemen perusahaan", "transformasi digital", "studi kasus", "Guo Wei", "proses bisnis", "komputasi awan", "integrasi data" ], "summary_original": "Guo Wei, Chairman Digital China, memaparkan tentang manajemen perusahaan era AI di INSEAD 2025 Asia AI Conference, serta meluncurkan studi kasus tentang perjalanan transformasi AI Digital China.", "title_original": "Digital China membahas manajemen perusahaan era AI di INSEAD", "news_gallery_ids": [ "7c8ec9cc-66c5-4153-82da-9c8f356c6c99" ], "country_codes": [ "CN", "SG" ], "company_country_codes": [ "CN", "FR" ], "amount_normalized": null, "amount": null, "job_title_tags": [ "executive", "leadership" ], "job_title": "Chairman", "headcount": null, "financing_type_tags": null, "financing_type_normalized": null, "financing_type": null, "domains": [ "insead.edu", "digitalchina.com" ], "companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "dfbe6797-5311-46f9-9518-bf1a7c3d09bc", "country_code": "FR", "company_name": "Insead", "linkedin_name": "insead", "domain": "insead.edu" }, { "logo_url": "https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "e13a9e24-a07d-4630-9b47-fceb778df74e", "country_code": "CN", "company_name": "Digital China", "linkedin_name": "digital-china", "domain": "digitalchina.com" } ], "news_galleries": [ { "slug": "banking-financial-service", "news_gallery_id": "7c8ec9cc-66c5-4153-82da-9c8f356c6c99", "name": "Banking/Financial Service" } ], "locations": [ "Singapore", "China" ], "last_modified": "2025-06-01T10:12:25.284Z", "image_url": null, "url": "http://enold.prnasia.com/p/asia-story-125304015-0.shtml", "published_at": "2025-06-01T08:00:00.000Z", "language": "id", "source": "prnasia.com", "category": "launches", "title": "Digital China's AI-driven transformation showcased at INSEAD", "summary": "Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey.", "news_category_name": "Launches" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "news_search_id": { "$ref": "#/components/schemas/news_search_id" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "news_search_id" ] } } } }, "operationId": "companies_lookup_news", "summary": "기업 뉴스 조회", "description": "뉴스 검색 ID를 사용하여 특정 기업의 뉴스 기사 상세 정보를 조회합니다.", "tags": [ "Lookup" ] } }, "/companies/advertisements/search": { "post": { "responses": { "200": { "description": "회사 광고 검색 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 694356, "total_pages": 27775, "total_display_pages": 250, "is_timeout": false }, "advertisements": [ { "target_country_codes": [ "US", "GB", "SG" ], "advertisement_id": "3af8cb80-9a04-49a8-832d-333961d5f77a", "advertisement_search_id": "3af8cb80-9a04-49a8-832d-333961d5f77a", "created_at": "2026-03-03T01:46:35.909Z", "last_modified": "2026-03-03T12:46:25.289Z", "started_at": "2026-02-25T00:00:00.000Z", "ended_at": "2026-03-02T00:00:00.000Z", "title": "Thuraya-4 Satellite Solutions for Energy", "source_type": "linkedin", "advertisement_format": "Single Image Ad", "video_url": null, "image_url": "https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.jpg", "carousel_images": null, "destination_url": "https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content", "companies": { "logo_url": "https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg", "domain_search_id": "fe3963dc-87a4-4016-8c95-217ea68cd57a", "company_name": "Space42", "linkedin_name": "space42ai", "country_code": "AE", "domain": "space42.ai" }, "raw_link_url": null, "publisher_platforms": null }, { "target_country_codes": [ "US", "GB", "SG" ], "advertisement_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022", "advertisement_search_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022", "created_at": "2026-06-03T22:00:33.035Z", "last_modified": "2026-06-05T18:15:51.823Z", "started_at": "2026-05-25T07:00:00.000Z", "ended_at": "2026-06-03T07:00:00.000Z", "title": "Dubai Opportunities. One Exclusive Event", "source_type": "facebook", "advertisement_format": "DCO", "video_url": null, "image_url": "https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg", "carousel_images": null, "destination_url": "https://promotions.damacproperties.com/en/event-in-egypt-social-specific/", "raw_link_url": "http://fb.me/", "publisher_platforms": [ "facebook", "instagram" ], "companies": { "logo_url": "https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg", "domain_search_id": "9da7386c-5bdc-42b2-8fee-456e91024a3a", "company_name": "Damac Properties", "linkedin_name": "damac-properties", "country_code": "AE", "domain": "damacproperties.com" } }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "target_locations": { "$ref": "#/components/schemas/target_locations" }, "exclude_target_locations": { "$ref": "#/components/schemas/exclude_target_locations" }, "search_terms": { "$ref": "#/components/schemas/search_terms" }, "headlines": { "$ref": "#/components/schemas/headlines" }, "filter_conditions": { "$ref": "#/components/schemas/ads_filter_conditions" }, "start_dates": { "$ref": "#/components/schemas/start_dates" }, "end_dates": { "$ref": "#/components/schemas/end_dates" }, "company_locations": { "$ref": "#/components/schemas/company_locations" }, "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "is_realtime_enrichment": { "$ref": "#/components/schemas/is_realtime_enrichment" }, "source_types": { "$ref": "#/components/schemas/advertisement_source_types" }, "enrichment_mode": { "$ref": "#/components/schemas/advertisement_enrichment_mode" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" }, "publisher_platforms": { "$ref": "#/components/schemas/advertisement_publisher_platforms" }, "exclude_publisher_platforms": { "$ref": "#/components/schemas/advertisement_exclude_publisher_platforms" }, "is_include_unlinked_companies": { "$ref": "#/components/schemas/advertisement_is_include_unlinked_companies" } } } } } }, "operationId": "companies_search_advertisements", "summary": "기업 광고 검색", "description": "지정된 조건에 맞는 기업이 운영하는 광고를 검색합니다. `facebook` 광고의 경우 `source_type` 은 Meta 광고 라이브러리 전체(Facebook, Instagram, Messenger, Threads, Audience Network)를 포함하며, `publisher_platforms` 로 노출 위치별로 좁힐 수 있습니다. `destination_url` 은 해석된 랜딩 페이지를 반환합니다(`fb.me` 같은 Facebook 클릭 래퍼는 실제 퍼널 URL로 펼쳐집니다). `raw_link_url` 은 수집된 원본 링크를 그대로 보존합니다.", "tags": [ "Search" ] } }, "/companies/advertisements/lookup": { "post": { "responses": { "200": { "description": "회사 광고 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "headline": "Thuraya-4 Satellite Solutions for Government", "description": "Thuraya-4 provides secure, always-on connectivity for vehicles, aircraft and command centers, ensuring mission continuity. \n\nLearn more about our satellite-powered government solutions.", "poster": "Space42", "poster_title": "Promoted", "promoted_by": null, "cta": "Learn more", "target_country_codes": [ "MM", "..." ], "target_locations": [ "United Arab Emirates", "..." ], "total_impressions": "10k-20k", "impression_countries": [ { "country": "India", "impressions": "19%" }, "..." ], "advertisement_id": "a92643e8-9033-4029-aa65-ef929327cebb", "advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb", "created_at": "2026-03-03T01:01:31.134Z", "last_modified": "2026-03-03T13:01:22.805Z", "started_at": "2026-02-25T00:00:00.000Z", "ended_at": "2026-03-02T00:00:00.000Z", "title": "Thuraya-4 Satellite Solutions for Government", "source_type": "linkedin", "advertisement_format": "Single Image Ad", "video_url": null, "image_url": "https://buckets.pubrio.com/images/public/qDf8TrjHJw9o8xFoQJv7vhnkLXNYKy1ThNVCWSHPmgHG5j7U4EroKtH4cYJcHCzTSh.jpg", "carousel_images": null, "destination_url": "https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content", "companies": { "logo_url": "https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg", "domain_search_id": "fe3963dc-87a4-4016-8c95-217ea68cd57a", "company_name": "Space42", "linkedin_name": "space42ai", "country_code": "AE", "domain": "space42.ai" }, "raw_link_url": null, "publisher_platforms": null } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "advertisement_search_id": { "$ref": "#/components/schemas/advertisement_search_id" }, "profile_id": { "$ref": "#/components/schemas/profile_id" }, "is_include_unlinked_companies": { "$ref": "#/components/schemas/advertisement_is_include_unlinked_companies" } }, "required": [ "advertisement_search_id" ] } } } }, "operationId": "companies_lookup_advertisements", "summary": "기업 광고 조회", "description": "광고 검색 ID를 사용하여 특정 기업의 광고 상세 정보를 조회합니다. 응답에는 해석된 `destination_url`, 원본 `raw_link_url`, 그리고 Meta 광고의 경우 `publisher_platforms` 가 포함됩니다.", "tags": [ "Lookup" ] } }, "/technologies/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": [ { "category_id": 1, "technologies": [ { "icon": "Google Ads.svg", "name": "Google Ads", "tag_id": 4580, "version": null, "website": "https://ads.google.com/", "location": "pubrio.com", "logo_url": "https://buckets.pubrio.com/technology-logo/NDU4MGIyOXNtYjhheGdvb2dsZS1hZHM=.jpg", "last_detected": null, "first_detected": "2023-01-07T06:40:56.597287" } ], "category_name": "Advertising" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "domain": { "$ref": "#/components/schemas/domain" }, "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "domain_id": { "$ref": "#/components/schemas/domain_id" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "Domain Search ID", "required": [ "domain_search_id" ] }, { "title": "도메인", "required": [ "domain" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] }, { "title": "Domain ID", "required": [ "domain_id" ] } ] } } } }, "operationId": "technologies_lookup", "summary": "기술 조회", "description": "기업이 사용하는 특정 기술의 상세 정보를 조회합니다.", "tags": [ "Lookup" ] } }, "/channels/types/templates": { "get": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "channel_type_id": 1, "slug": "email", "channel_type_identifier": "db3ecea8-b838-4cfa-8aa1-c358223b0060", "logo_url": "https://buckets.pubrio.com/technology-logo/tdurnBxI97MV1hr2L1QaYgt.jpg", "node_type": "action", "channel_nodes": [ { "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c", "channel_node_identifier": "30896b66-7fc7-42bf-b5fe-ce7e1fdb9e30", "channel_type_id": 1, "slug": "send_email", "parameter_properties": [ { "name": "Subject", "slug": "subject", "hints": "My subject line", "field_type": "string", "max_length": 1000, "min_length": 1, "description": "Subject line of the email", "is_required": true, "display_type": "string", "supported_tools": [ "variables" ], "is_template_field": true, "is_verify_required": false, "is_display_as_snippet": true, "is_return_in_plain_text": true }, { "name": "Content", "slug": "content", "hints": "Write your email content", "field_type": "string", "max_length": 250000, "min_length": 0, "description": "HTML text message of email", "is_required": true, "display_type": "email_editor", "supported_tools": [ "formatting_options", "variables", "insert_link", "attachments", "insert_photo", "code_mode", { "slug": "insert_signature", "syntax": "{{insert_signature.signature_html}}" } ], "is_template_field": true, "is_verify_required": false, "is_attachment_allowed": true, "is_display_as_snippet": false, "is_return_in_plain_text": false }, { "name": "Attachments", "slug": "attachments", "hints": null, "field_type": "array", "max_length": 25, "min_length": 0, "description": null, "is_required": false, "display_type": null, "is_template_field": true, "is_verify_required": false, "is_attachment_allowed": true, "is_hide_from_control_panel": true } ], "is_template_available": true, "logo_url": "https://buckets.pubrio.com/technology-logo/tdurnBxI97MV1hr2L1QaYgt.jpg", "node_type": "action", "input_properties": [ { "name": "To email addresses [multiple comma-separated]", "slug": "to_email_addresses", "hints": "to@example.com", "field_type": "array", "max_length": 1000, "min_length": 1, "description": "Email address of the recipient", "is_required": true, "display_type": "email_input", "is_verify_required": false } ], "name": "Send Email", "description": "The Send Email node sends emails using the connected email provider." } ], "name": "Email", "description": "Sends automated emails based on triggers or events." }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "channels_get_template_types", "summary": "채널 템플릿 유형 목록", "description": "아웃리치 템플릿에 사용 가능한 채널 유형을 조회합니다.", "tags": [ "Channels" ] } }, "/channels/templates/lookup": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": [ { "channel_template_id": 245, "channel_template_identifier": "4f6f40cb-ed6d-4cca-99d8-616feef8de93", "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c", "channel_node_slug": "send_email", "channel_type_id": 1, "channel_type_slug": "email", "owner_email": "example@pubrio.com", "owner_name": "Owner", "name": "email", "description": null, "parameters": { "content": "

hello world

", "subject": "Hello World", "attachments": [] }, "default_values": null, "version_number": 1, "version_name": "version 1", "is_default": true, "is_personal": true, "created_at": "2025-07-29T09:07:11.969Z", "last_modified": "2025-07-29T09:07:11.969Z" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channel_template_identifier": { "$ref": "#/components/schemas/channel_template_identifier" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "channel_template_identifier" ] } } } }, "operationId": "channels_lookup_template", "summary": "채널 템플릿 조회", "description": "ID로 특정 채널 템플릿의 상세 정보를 조회합니다.", "tags": [ "Channels" ] } }, "/channels/templates": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 4, "total_pages": 1, "is_timeout": false }, "channel_templates": [ { "channel_template_id": 1, "channel_template_identifier": "4f6f40cb-ed6d-4cca-99d8-616feef8de93", "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c", "channel_node_slug": "send_email", "channel_type_id": 1, "channel_type_slug": "email", "owner_email": "example@pubrio.com", "owner_name": "Owner", "name": "email", "version_number": 1, "version_name": "version 1", "is_default": true, "is_personal": true, "created_at": "2025-07-29T09:07:11.969Z", "last_modified": "2025-07-29T09:07:11.969Z", "channel_template_versions": [ { "channel_template_id": 1, "channel_template_identifier": "4f6f40cb-ed6d-4cca-99d8-616feef8de93", "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c", "channel_node_slug": "send_email", "channel_type_id": 1, "channel_type_slug": "email", "owner_email": "example@pubrio.com", "owner_name": "Owner", "name": "email", "parameters": { "content": "

hello world

", "subject": "Hello World", "attachments": [] }, "version_number": 1, "version_name": "version 1", "default_values": null, "is_default": true, "is_personal": true, "created_at": "2025-07-29T09:07:11.969581", "last_modified": "2025-07-29T09:07:11.969581" } ] }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channel_template_name": { "$ref": "#/components/schemas/channel_template_name" }, "channel_nodes": { "$ref": "#/components/schemas/channel_nodes" }, "channel_types": { "$ref": "#/components/schemas/channel_types" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "page": { "$ref": "#/components/schemas/page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "channels_list_templates", "summary": "채널 템플릿 목록", "description": "워크스페이스의 모든 채널 아웃리치 템플릿 목록을 조회합니다.", "tags": [ "Channels" ] } }, "/channels/templates/create": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "channel_template_id": 248, "channel_template_identifier": "4c717a78-26e9-49eb-ab2e-e1ce0755674a", "created_at": "2025-08-07T17:22:11.344Z", "version_number": 1, "is_default": true, "name": "Email Template", "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c", "parameters": { "content": "

hello world

", "subject": "hello world" }, "version_name": "Default" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channel_template_name": { "$ref": "#/components/schemas/channel_template_name" }, "version_name": { "$ref": "#/components/schemas/version_name" }, "channel_node_id": { "$ref": "#/components/schemas/channel_node_id" }, "parameters": { "$ref": "#/components/schemas/channel_template_parameters" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "channel_template_name", "parameters", "channel_node_id" ] } } } }, "operationId": "channels_create_template", "summary": "채널 템플릿 생성", "description": "지정된 매개변수로 새 아웃리치 채널 템플릿을 생성합니다.", "tags": [ "Channels" ] } }, "/channels/templates/create_version": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "channel_template_id": 249, "channel_template_identifier": "4c717a78-26e9-49eb-ab2e-e1ce0755674a", "created_at": "2025-08-07T17:22:11.344Z", "version_number": 2, "is_default": true, "name": "Email Template", "channel_node_id": "93873c33-2635-4537-928c-6a4f3564164c", "parameters": { "content": "

hello world

", "subject": "hello world" }, "version_name": "Default 2" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channel_template_identifier": { "$ref": "#/components/schemas/channel_template_identifier" }, "channel_template_id": { "$ref": "#/components/schemas/channel_template_id" }, "version_name": { "$ref": "#/components/schemas/version_name" }, "is_default": { "$ref": "#/components/schemas/is_default" }, "parameters": { "$ref": "#/components/schemas/channel_template_parameters" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "channel_template_identifier" ] } } } }, "operationId": "channels_create_template_version", "summary": "템플릿 버전 생성", "description": "기존 채널 템플릿의 새 버전을 생성합니다.", "tags": [ "Channels" ] } }, "/channels/templates/default": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": [ { "channel_template_id": 251, "channel_template_identifier": "4c717a78-26e9-49eb-ab2e-e1ce0755674a", "is_default": true, "last_modified": "2025-08-07T17:58:54.105Z" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channel_template_id": { "$ref": "#/components/schemas/channel_template_id" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "channel_template_id" ] } } } }, "operationId": "channels_get_default_template", "summary": "기본 채널 템플릿 조회", "description": "워크스페이스의 기본 채널 템플릿을 조회합니다.", "tags": [ "Channels" ] } }, "/channels/templates/update": { "post": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": { "channel_template_id": 251, "last_modified": "2025-08-07T18:00:43.255Z", "name": "Email Template", "...": "..." } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channel_template_identifier": { "$ref": "#/components/schemas/channel_template_identifier" }, "channel_template_id": { "$ref": "#/components/schemas/channel_template_id" }, "channel_template_name": { "$ref": "#/components/schemas/channel_template_name" }, "version_name": { "$ref": "#/components/schemas/version_name" }, "parameters": { "$ref": "#/components/schemas/channel_template_parameters" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "channel_template_id", "channel_template_identifier" ] } } } }, "operationId": "channels_update_template", "summary": "채널 템플릿 수정", "description": "기존 채널 템플릿의 구성을 수정합니다.", "tags": [ "Channels" ] } }, "/channels/templates/delete": { "delete": { "responses": { "200": { "description": "관련 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data" } } }, "example": { "data": null } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "channel_templates": { "$ref": "#/components/schemas/channel_templates" }, "is_entire_templates": { "$ref": "#/components/schemas/is_entire_templates" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "channel_templates" ] } } } }, "operationId": "channels_delete_template", "summary": "채널 템플릿 삭제", "description": "워크스페이스에서 채널 템플릿을 삭제합니다.", "tags": [ "Channels" ] } }, "/monitors/statistics": { "post": { "responses": { "200": { "description": "모니터 통계 개요가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "total_monitors": { "type": "integer", "description": "워크스페이스의 전체 모니터 수입니다." }, "triggers_today": { "type": "integer", "description": "오늘의 모니터 트리거 수입니다." }, "triggers_yesterday": { "type": "integer", "description": "어제의 모니터 트리거 수입니다." }, "triggers_comparison_rate": { "type": "number", "description": "오늘과 어제의 트리거 변화율입니다. 음수 값은 감소를 나타냅니다." }, "success_today": { "type": "integer", "description": "오늘의 성공적인 트리거 수입니다." }, "success_yesterday": { "type": "integer", "description": "어제의 성공적인 트리거 수입니다." }, "success_rate_today": { "type": "number", "nullable": true, "description": "오늘 트리거의 성공률 (0~1)입니다. 오늘 트리거가 없었던 경우 null입니다." }, "success_rate_yesterday": { "type": "number", "nullable": true, "description": "어제 트리거의 성공률 (0~1)입니다. 어제 트리거가 없었던 경우 null입니다." }, "triggers_last_7_days": { "type": "integer", "description": "최근 7일간의 모니터 트리거 수입니다." }, "avg_triggers_per_day": { "type": "number", "description": "최근 7일간의 일평균 트리거 수입니다(올림)." }, "success_rate_last_7_days": { "type": "number", "nullable": true, "description": "최근 7일간의 성공률 (0~1)입니다. 해당 기간에 트리거가 없었던 경우 null입니다." } } } } }, "example": { "data": { "total_monitors": 8, "triggers_today": 3, "triggers_yesterday": 46, "triggers_comparison_rate": -0.935, "triggers_last_7_days": 112, "avg_triggers_per_day": 16, "success_today": 3, "success_yesterday": 46, "success_rate_today": 1, "success_rate_yesterday": 1, "success_rate_last_7_days": 0.982 } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "monitors_get_statistics", "summary": "모니터 통계 조회", "description": "워크스페이스 전체의 모니터 트리거 통계 개요를 조회합니다. monitor_id 매개변수는 없으며, 수치는 워크스페이스의 모든 모니터에 걸쳐 집계됩니다(관심 목록 기반 모니터는 제외).", "tags": [ "Monitor" ] } }, "/monitors/statistics/logs": { "post": { "responses": { "200": { "description": "성공적인 응답입니다. 응답 구조는 `{ metadata: { filters }, data: { pagination, monitor_logs } }`이며, `metadata.filters`는 검색에 적용된 필터를 그대로 반환합니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "filters": { "type": "object", "description": "이 검색에 적용된 필터를 그대로 반환합니다." } } }, "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "page": { "type": "integer", "description": "현재 페이지 번호입니다." }, "per_page": { "type": "integer", "description": "페이지당 결과 수입니다." }, "total_entries": { "type": "integer", "description": "전체 로그 항목 수입니다." }, "total_pages": { "type": "integer", "description": "전체 페이지 수입니다." }, "total_display_pages": { "type": "integer", "description": "전체 표시 페이지 수입니다." }, "is_timeout": { "type": "boolean", "description": "쿼리 시간 초과 여부입니다." } } }, "monitor_logs": { "type": "array", "items": { "type": "object", "properties": { "monitor_log_id": { "type": "string", "format": "uuid", "description": "이 로그 항목의 고유 식별자입니다." }, "monitor_id": { "type": "string", "format": "uuid", "description": "이 로그를 생성한 모니터의 식별자입니다." }, "parent_monitor_log_id": { "type": "string", "description": "재시도인 경우 상위 로그 항목의 식별자입니다." }, "detection_mode": { "type": "string", "description": "사용된 감지 모드입니다. 'company_first' 또는 'signal_first'입니다." }, "signal_type": { "type": "array", "items": { "type": "string" }, "description": "모니터링된 신호 유형입니다 (예: 'jobs', 'news', 'advertisements')." }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다 (예: 'email', 'webhook')." }, "response_status_code": { "type": "integer", "description": "대상 응답의 HTTP 상태 코드입니다." }, "status": { "type": "string", "description": "트리거 실행 상태입니다 (예: 'success', 'failed')." }, "error_message": { "type": "string", "description": "트리거 실패 시 오류 메시지입니다. 성공 시 빈 문자열입니다." }, "total_signals": { "type": "integer", "description": "감지된 전체 신호 수입니다." }, "total_companies": { "type": "integer", "description": "발견된 전체 기업 수입니다." }, "total_people": { "type": "integer", "description": "발견된 전체 인물 수입니다." }, "trigger_credit": { "type": "integer", "description": "트리거 자체에 소비된 크레딧입니다." }, "total_company_credit": { "type": "integer", "description": "기업 보강에 소비된 크레딧입니다." }, "total_people_credit": { "type": "integer", "description": "인물 보강에 소비된 크레딧입니다." }, "redeem_email_credit": { "type": "integer", "description": "이메일 교환에 소비된 크레딧입니다." }, "redeem_phone_credit": { "type": "integer", "description": "전화번호 교환에 소비된 크레딧입니다." }, "total_credit": { "type": "integer", "description": "이 트리거에 소비된 전체 크레딧입니다." }, "retry_attempt": { "type": "integer", "description": "재시도 횟수입니다." }, "processing_time_ms": { "type": "integer", "description": "총 처리 시간(밀리초)입니다." }, "created_at": { "type": "string", "format": "date-time", "description": "로그 항목 생성 타임스탬프입니다." }, "retry_logs": { "type": "array", "items": { "type": "object" }, "description": "재시도 로그 항목 배열입니다 (있는 경우)." }, "is_retry_succeed": { "type": "boolean", "description": "재시도 성공 여부입니다." } } } } } } } }, "example": { "metadata": { "filters": { "statuses": [ "failure" ], "language": "en" } }, "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 45, "total_pages": 2, "total_display_pages": 2, "is_timeout": false }, "monitor_logs": [ { "monitor_log_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "parent_monitor_log_id": "", "detection_mode": "company_first", "signal_type": [ "jobs", "news", "advertisements" ], "destination_type": "email", "response_status_code": 200, "status": "success", "error_message": "", "total_signals": 25, "total_companies": 11, "total_people": 32, "trigger_credit": 15, "total_company_credit": 11, "total_people_credit": 33, "redeem_email_credit": 0, "redeem_phone_credit": 0, "total_credit": 59, "retry_attempt": 0, "processing_time_ms": 97952, "created_at": "2026-04-05T18:28:05.000Z", "retry_logs": [], "is_retry_succeed": false }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "로그를 조회할 모니터의 고유 식별자입니다." }, "monitor_ids": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "이 모니터들의 로그로 필터링합니다." }, "monitor_log_ids": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "이 특정 로그 항목들로 필터링합니다." }, "search_term": { "type": "string", "description": "error_message, destination_type, detection_mode를 대상으로 매칭되는 검색어입니다(대소문자 구분 없는 부분 문자열)." }, "start_date": { "type": "string", "format": "date", "description": "created_at 날짜 범위의 시작입니다(ISO 날짜 문자열). end_date와 함께 사용합니다." }, "end_date": { "type": "string", "format": "date", "description": "created_at 날짜 범위의 종료입니다(ISO 날짜 문자열). start_date와 함께 사용합니다." }, "order_by": { "type": "string", "enum": [ "created_at", "total_credit", "processing_time_ms", "total_signals", "status", "retry_attempt" ], "description": "정렬 기준 필드입니다. 기본값은 created_at입니다.", "default": "created_at" }, "is_ascending_order": { "type": "boolean", "description": "오름차순으로 정렬합니다. 기본값은 false(내림차순)입니다.", "default": false }, "statuses": { "type": "array", "items": { "type": "string" }, "description": "트리거 상태로 필터링합니다 (예: 'success', 'failure'). 가상 값 'recovered'도 허용됩니다 — 이후 재시도가 성공한 실패 트리거입니다." }, "signal_types": { "type": "array", "items": { "type": "string" }, "description": "신호 유형에 이 값들 중 하나라도 포함된 로그로 필터링합니다." }, "destination_types": { "type": "array", "items": { "type": "string" }, "description": "전달 대상 유형으로 필터링합니다 (예: ['email', 'webhook'])." }, "detection_modes": { "type": "array", "items": { "type": "string" }, "description": "감지 모드로 필터링합니다 (예: ['company_first', 'signal_first'])." }, "per_page": { "type": "integer", "description": "페이지당 결과 수입니다. 기본값은 25입니다.", "default": 25 }, "page": { "type": "integer", "description": "페이지네이션을 위한 페이지 번호입니다. 기본값은 1입니다.", "default": 1 }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "monitors_list_statistics_logs", "summary": "모니터 통계 로그 목록", "description": "특정 모니터의 페이지네이션된 감지 로그 목록을 조회합니다.", "tags": [ "Monitor" ] } }, "/monitors/statistics/logs/lookup": { "post": { "responses": { "200": { "description": "전체 요청 및 응답 페이로드를 포함한 단일 모니터 로그 항목의 상세 정보가 포함된 성공적인 응답입니다. 응답 구조는 `{ metadata: { monitor_log_id }, data: {...} }`입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "monitor_log_id": { "type": "string", "format": "uuid", "description": "조회된 모니터 로그 식별자입니다." } } }, "data": { "type": "object", "properties": { "monitor_log_id": { "type": "string", "format": "uuid", "description": "이 로그 항목의 고유 식별자입니다." }, "monitor_id": { "type": "string", "format": "uuid", "description": "이 로그를 생성한 모니터의 식별자입니다." }, "parent_monitor_log_id": { "type": "string", "description": "재시도인 경우 상위 로그 항목의 식별자입니다." }, "detection_mode": { "type": "string", "description": "사용된 감지 모드입니다. 'company_first' 또는 'signal_first'입니다." }, "signal_type": { "type": "array", "items": { "type": "string" }, "description": "모니터링된 신호 유형입니다." }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다." }, "response_status_code": { "type": "integer", "description": "대상 응답의 HTTP 상태 코드입니다." }, "status": { "type": "string", "description": "트리거 실행 상태입니다." }, "error_message": { "type": "string", "description": "트리거 실패 시 오류 메시지입니다." }, "total_signals": { "type": "integer", "description": "감지된 전체 신호 수입니다." }, "total_companies": { "type": "integer", "description": "발견된 전체 기업 수입니다." }, "total_people": { "type": "integer", "description": "발견된 전체 인물 수입니다." }, "trigger_credit": { "type": "integer", "description": "트리거에 소비된 크레딧입니다." }, "total_company_credit": { "type": "integer", "description": "기업 보강에 소비된 크레딧입니다." }, "total_people_credit": { "type": "integer", "description": "인물 보강에 소비된 크레딧입니다." }, "redeem_email_credit": { "type": "integer", "description": "이메일 교환에 소비된 크레딧입니다." }, "redeem_phone_credit": { "type": "integer", "description": "전화번호 교환에 소비된 크레딧입니다." }, "total_credit": { "type": "integer", "description": "소비된 전체 크레딧입니다." }, "retry_attempt": { "type": "integer", "description": "재시도 횟수입니다." }, "processing_time_ms": { "type": "integer", "description": "총 처리 시간(밀리초)입니다." }, "created_at": { "type": "string", "format": "date-time", "description": "로그 항목 생성 타임스탬프입니다." }, "retry_logs": { "type": "array", "items": { "type": "object" }, "description": "재시도 로그 항목 배열입니다." }, "is_retry_succeed": { "type": "boolean", "description": "재시도 성공 여부입니다." }, "request_payload": { "type": "object", "description": "이 트리거 실행에 전송된 전체 모니터 구성 및 데이터입니다." }, "response_payload": { "type": "object", "description": "대상으로부터 수신된 응답 페이로드입니다." }, "attributes": { "type": "object", "description": "이 트리거에 대해 캡처된 실행 속성입니다(대상 스냅샷 및 관련 메타데이터). 웹훅 서명 시크릿은 제거됩니다." } } } } }, "example": { "metadata": { "monitor_log_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }, "data": { "monitor_log_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "parent_monitor_log_id": "", "detection_mode": "company_first", "signal_type": [ "jobs", "news" ], "destination_type": "webhook", "response_status_code": 200, "status": "success", "error_message": "", "total_signals": 10, "total_companies": 5, "total_people": 12, "trigger_credit": 8, "total_company_credit": 5, "total_people_credit": 12, "redeem_email_credit": 0, "redeem_phone_credit": 0, "total_credit": 25, "retry_attempt": 0, "processing_time_ms": 45230, "created_at": "2026-04-05T18:28:05.000Z", "retry_logs": [], "is_retry_succeed": false, "request_payload": {}, "response_payload": {}, "attributes": {} } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_log_id": { "type": "string", "format": "uuid", "description": "조회할 모니터 로그 항목의 고유 식별자입니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "monitor_log_id" ] } } } }, "operationId": "monitors_lookup_statistics_log", "summary": "모니터 통계 로그 조회", "description": "특정 모니터 감지 로그 항목의 상세 정보를 조회합니다.", "tags": [ "Monitor" ] } }, "/monitors/statistics/chart": { "post": { "responses": { "200": { "description": "시간에 따른 모니터 트리거 통계 차트 데이터 포인트가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date_series": { "type": "string", "format": "date", "description": "이 데이터 포인트의 날짜입니다." }, "total_triggers": { "type": "integer", "description": "이 날짜의 전체 트리거 수입니다." }, "total_success": { "type": "integer", "description": "이 날짜의 성공적인 트리거 수입니다." }, "total_failure": { "type": "integer", "description": "이 날짜의 실패한 트리거 수입니다." }, "total_credit": { "type": "number", "description": "이 날짜에 소비된 전체 크레딧입니다." } } } } } }, "example": { "data": [ { "date_series": "2026-04-01", "total_triggers": 12, "total_success": 11, "total_failure": 1, "total_credit": 236 }, { "date_series": "2026-04-02", "total_triggers": 8, "total_success": 8, "total_failure": 0, "total_credit": 154 }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "선택 사항. 차트 범위를 한정할 모니터의 고유 식별자입니다. 생략하면 워크스페이스의 모든 모니터에 걸쳐 집계된 차트를 반환합니다." }, "start_date": { "type": "string", "format": "date", "description": "차트 범위의 시작 날짜입니다 (YYYY-MM-DD)." }, "end_date": { "type": "string", "format": "date", "description": "차트 범위의 종료 날짜입니다 (YYYY-MM-DD)." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "start_date", "end_date" ] } } } }, "operationId": "monitors_get_statistics_chart", "summary": "모니터 통계 차트 데이터 조회", "description": "모니터의 차트용 시계열 통계 데이터를 조회합니다.", "tags": [ "Monitor" ] } }, "/monitors/process/try": { "post": { "responses": { "200": { "description": "트리거 실행 결과가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "트리거된 모니터의 식별자입니다." }, "status": { "type": "string", "description": "트리거 실행 상태입니다." }, "total_signals": { "type": "integer", "description": "감지된 전체 신호 수입니다." }, "total_credit": { "type": "integer", "description": "소비된 전체 크레딧입니다." }, "processing_time_ms": { "type": "integer", "description": "전체 처리 시간(밀리초)입니다." }, "delivery_result": { "type": "object", "properties": { "is_success": { "type": "boolean", "description": "전달 성공 여부입니다." }, "error_message": { "type": "string", "nullable": true, "description": "전달 실패 시 오류 메시지입니다." }, "response_status_code": { "type": "integer", "description": "대상에서 반환된 HTTP 상태 코드입니다." }, "response_payload": { "type": "string", "description": "대상에서 반환된 응답 본문입니다." }, "retry_attempt": { "type": "integer", "description": "재시도 횟수입니다." } }, "description": "전달 결과 세부 정보입니다." } } } } }, "example": { "data": { "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "status": "success", "total_signals": 25, "total_credit": 59, "processing_time_ms": 99050, "delivery_result": { "is_success": true, "error_message": null, "response_status_code": 200, "response_payload": "OK", "retry_attempt": 0 } } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "선택 사항. 트리거할 저장된 모니터의 고유 식별자입니다. 생략하면 인라인으로 전달한 저장되지 않은 임시 구성을 실행합니다." }, "tried_at": { "type": "string", "format": "date-time", "description": "스캔 기준점으로 사용할 타임스탬프입니다. 테스트 시 데이터가 사용 가능하도록 최근 과거 날짜를 사용하세요. 현재 시간을 사용하면 결과가 0건이 될 수 있습니다." }, "name": { "type": "string", "description": "실행 구성의 이름입니다." }, "detection_mode": { "type": "string", "enum": [ "company_first", "signal_first" ], "description": "실행의 감지 모드입니다." }, "signal_types": { "type": "array", "items": { "type": "string" }, "description": "스캔할 신호 유형입니다 (jobs, news, advertisements, expansions)." }, "signal_filters": { "type": "array", "items": { "type": "object" }, "description": "신호 유형별 필터 객체로, 모니터 생성과 동일한 형식입니다." }, "company_filters": { "type": "object", "description": "글로벌 기업 필터로, Company Search와 동일한 매개변수입니다." }, "companies": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "스캔할 기업 domain_search_id UUID 목록입니다." }, "domains": { "type": "array", "items": { "type": "string" }, "description": "스캔할 기업 도메인 목록입니다 — 회사로 변환됩니다." }, "linkedin_urls": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "스캔할 LinkedIn 기업 URL 목록입니다 — 회사로 변환됩니다." }, "is_company_enrichment": { "type": "boolean", "description": "결과에서 기업 데이터를 보강할지 여부입니다." }, "is_people_enrichment": { "type": "boolean", "description": "결과에서 인물 데이터를 보강할지 여부입니다." }, "people_enrichment_configs": { "type": "array", "items": { "type": "object" }, "description": "인물 보강 레이어로, 모니터 생성과 동일한 형식입니다." }, "destination_type": { "type": "string", "enum": [ "webhook", "email", "sequences" ], "description": "실행의 전달 대상 유형입니다." }, "destination_config": { "type": "object", "description": "실행의 대상 구성으로, 모니터 생성과 동일한 형식입니다." }, "max_records_per_trigger": { "type": "integer", "description": "이 실행이 전달하는 최대 레코드 수입니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "monitors_process_try", "summary": "모니터 처리 시도", "description": "저장된 모니터를 id로 실행하거나, 구성을 인라인으로 전달하여 저장되지 않은 임시 구성을 실행합니다. monitor_id와 함께 사용하면 인라인 필드가 이번 실행에 한해 저장된 모니터 설정을 재정의합니다.", "tags": [ "Monitor" ] } }, "/monitors/process/retry": { "post": { "responses": { "200": { "description": "재시도 실행 결과가 포함된 성공적인 응답입니다. 응답 구조는 `{ metadata: { monitor_log_id, status }, data: {...} }`입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "monitor_log_id": { "type": "string", "format": "uuid", "description": "재시도된 모니터 로그 항목입니다." }, "status": { "type": "string", "enum": [ "success", "failure", "skipped" ], "description": "재시도 결과입니다. 'skipped'는 원래 트리거가 이미 성공했음을 의미합니다." } } }, "data": { "type": "object", "properties": { "monitor_log_id": { "type": "string", "format": "uuid", "description": "재시도된 모니터 로그 항목입니다." }, "status": { "type": "string", "enum": [ "success", "failure", "skipped" ], "description": "재시도 결과입니다." }, "monitor_id": { "type": "string", "format": "uuid", "description": "모니터의 식별자입니다." }, "delivery_result": { "type": "object", "properties": { "is_success": { "type": "boolean", "description": "전달 성공 여부입니다." }, "error_message": { "type": "string", "nullable": true, "description": "전달 실패 시 오류 메시지입니다." }, "response_status_code": { "type": "integer", "description": "대상에서 반환된 HTTP 상태 코드입니다." }, "response_payload": { "type": "string", "description": "대상에서 반환된 응답 본문입니다." }, "retry_attempt": { "type": "integer", "description": "재시도 횟수입니다." } }, "description": "전달 결과 세부 정보입니다." }, "total_credit": { "type": "integer", "description": "소비된 전체 크레딧입니다." }, "processing_time_ms": { "type": "integer", "description": "전체 처리 시간(밀리초)입니다." } } } } }, "example": { "metadata": { "monitor_log_id": "c3d4e5f6-a7b8-9012-cdef-123456789012", "status": "success" }, "data": { "monitor_log_id": "c3d4e5f6-a7b8-9012-cdef-123456789012", "status": "success", "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "delivery_result": { "is_success": true, "error_message": null, "response_status_code": 200, "response_payload": "...", "retry_attempt": 0 }, "total_credit": 59, "processing_time_ms": 7541 } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_log_id": { "type": "string", "format": "uuid", "description": "재시도할 모니터 로그 항목의 고유 식별자입니다." }, "is_use_original_destination": { "type": "boolean", "description": "true일 경우 현재 모니터 구성 대신 원래 로그 항목의 대상 구성 스냅샷을 사용합니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "monitor_log_id" ] } } } }, "operationId": "monitors_process_retry", "summary": "모니터 처리 재시도", "description": "실패한 모니터 처리 실행을 재시도합니다.", "tags": [ "Monitor" ] } }, "/monitors": { "post": { "responses": { "200": { "description": "페이지네이션된 모니터 목록이 포함된 성공적인 응답입니다. 관심 목록 기반 모니터는 이 목록에서 제외됩니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "page": { "type": "integer", "description": "현재 페이지 번호입니다." }, "per_page": { "type": "integer", "description": "페이지당 결과 수입니다." }, "total_entries": { "type": "integer", "description": "전체 모니터 수입니다." }, "total_pages": { "type": "integer", "description": "전체 페이지 수입니다." }, "total_display_pages": { "type": "integer", "description": "전체 표시 페이지 수입니다." }, "is_timeout": { "type": "boolean", "description": "쿼리 시간 초과 여부입니다." } } }, "monitors": { "type": "array", "items": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "모니터의 고유 식별자입니다." }, "name": { "type": "string", "description": "모니터의 이름입니다." }, "description": { "type": "string", "description": "모니터의 설명입니다." }, "detection_mode": { "type": "string", "description": "감지 모드: 'company_first' 또는 'signal_first'입니다." }, "signal_types": { "type": "array", "items": { "type": "string" }, "description": "모니터링할 신호 유형입니다 (예: 'jobs', 'news', 'advertisements')." }, "signal_filters": { "type": "object", "description": "신호에 적용되는 필터입니다. 검색 엔드포인트와 동일한 필터 구조를 사용합니다." }, "company_filters": { "type": "object", "description": "기업에 적용되는 필터입니다. 검색 엔드포인트와 동일한 필터 구조를 사용합니다." }, "companies": { "type": "array", "items": { "type": "string" }, "description": "모니터링할 도메인 검색 식별자 배열입니다." }, "is_company_enrichment": { "type": "boolean", "description": "결과에서 기업 데이터를 보강할지 여부입니다." }, "is_people_enrichment": { "type": "boolean", "description": "결과에서 인물 데이터를 보강할지 여부입니다." }, "people_enrichment_configs": { "type": "object", "description": "필터 및 제한을 포함한 인물 보강 구성입니다.", "properties": { "max_people_to_return": { "type": "integer", "description": "기업당 반환할 최대 인물 수입니다. 최소: 1, 최대: 25." } } }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다 (예: 'email', 'webhook')." }, "destination_config": { "type": "object", "description": "전달 대상 구성입니다 (예: 웹훅 URL, 이메일 주소)." }, "frequency_minute": { "type": "integer", "description": "트리거 빈도(분)입니다. 최소: 0, 최대: 10080, 기본값: 0." }, "max_retry_per_trigger": { "type": "integer", "description": "트리거당 최대 재시도 횟수입니다. 최소: 0, 최대: 3, 기본값: 1." }, "max_records_per_trigger": { "type": "integer", "description": "트리거당 최대 레코드 수입니다. 최소: 1, 최대: 100, 기본값: 25." }, "retry_delay_second": { "type": "integer", "description": "재시도 간 지연 시간(초)입니다. 최소: 1, 최대: 5, 기본값: 1." }, "max_daily_trigger": { "type": "integer", "description": "일일 최대 트리거 수입니다. 최소: 0, 최대: 86400, 기본값: 500." }, "max_failure_trigger": { "type": "integer", "description": "일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10, 기본값: 5." }, "masked_signature": { "type": "string", "description": "표시용 마스킹된 웹훅 서명입니다." }, "status": { "type": "string", "enum": [ "draft", "active", "paused", "inactive" ], "description": "모니터의 라이프사이클 상태입니다." }, "notification_email": { "type": "string", "description": "모니터 알림 이메일 주소입니다." }, "repeated_failure_count": { "type": "integer", "description": "현재 연속 실패 횟수입니다." }, "last_trigger_at": { "type": "string", "format": "date-time", "nullable": true, "description": "마지막 트리거 타임스탬프입니다." }, "last_processed_at": { "type": "string", "format": "date-time", "nullable": true, "description": "마지막 처리 완료 타임스탬프입니다." }, "created_at": { "type": "string", "format": "date-time", "description": "모니터 생성 타임스탬프입니다." }, "last_modified": { "type": "string", "format": "date-time", "description": "모니터 최종 수정 타임스탬프입니다." }, "user": { "type": "object", "properties": { "user_id": { "type": "string", "description": "모니터를 생성한 사용자의 식별자입니다." }, "nickname": { "type": "string", "description": "사용자의 표시 이름입니다." }, "email": { "type": "string", "description": "사용자의 이메일입니다." } }, "description": "모니터를 생성한 사용자입니다." }, "total_trigger_today": { "type": "integer", "description": "오늘 실행된 트리거 수입니다." }, "success_rate": { "type": "string", "nullable": true, "description": "전체 성공률 (0~1)을 소수점 문자열로 나타낸 값입니다 (예: \"0.983\"). 모니터가 한 번도 트리거되지 않은 경우 null입니다." } } } } } } } }, "example": { "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 8, "total_pages": 1, "total_display_pages": 1, "is_timeout": false }, "monitors": [ { "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Company First Monitor", "description": null, "detection_mode": "company_first", "signal_types": [ "jobs", "news", "advertisements" ], "signal_filters": [ { "filters": { "locations": [ "US" ] }, "signal_type": "jobs" }, { "filters": { "locations": [ "US" ] }, "signal_type": "news" }, { "filters": { "target_locations": [ "US" ] }, "signal_type": "advertisements" } ], "company_filters": { "locations": [ "US" ] }, "companies": [ "67c4696b-b7b0-46b5-b2af-9f434543661e" ], "is_company_enrichment": true, "is_people_enrichment": true, "people_enrichment_configs": [ { "filters": { "people_locations": [ "US" ] }, "max_people_to_return": 3, "people_contact_types": [ "email-work" ] } ], "destination_type": "webhook", "destination_config": { "webhook_url": "https://usewebhook.com/example", "headers": { "X-Custom-Auth": "your-token" }, "body": { "source": "pubrio" } }, "notification_email": "team@example.com", "max_retry_per_trigger": 1, "retry_delay_second": 1, "max_records_per_trigger": 25, "max_daily_trigger": 500, "frequency_minute": 0, "status": "active", "max_failure_trigger": 5, "repeated_failure_count": 0, "last_trigger_at": "2026-04-05T22:29:36.349Z", "last_processed_at": "2026-04-05T18:28:05.715Z", "masked_signature": "9••••••••••••••••f09", "created_at": "2026-04-03T18:49:20.048Z", "last_modified": "2026-04-05T22:29:36.349Z", "user": { "user_id": "a1b2c3d4-0000-0000-0000-000000000000", "nickname": "Jane Smith", "email": "jane@example.com" }, "total_trigger_today": 4, "success_rate": "1.000" }, "..." ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "destination_types": { "type": "array", "items": { "type": "string" }, "description": "전달 대상 유형으로 필터링합니다 (예: ['email', 'webhook']). 빈 배열은 전체를 반환합니다." }, "detection_modes": { "type": "array", "items": { "type": "string" }, "description": "감지 모드로 필터링합니다 (예: ['company_first', 'signal_first']). 빈 배열은 전체를 반환합니다." }, "status": { "type": "string", "enum": [ "draft", "active", "paused", "inactive" ], "description": "모니터 상태로 필터링합니다." }, "is_ascending_order": { "type": "boolean", "description": "오름차순으로 정렬합니다. 기본값은 false(내림차순)입니다.", "default": false }, "order_by": { "type": "string", "enum": [ "name", "last_trigger_at", "last_modified" ], "description": "정렬 기준 필드입니다. 허용 값: 'name', 'last_trigger_at', 'last_modified'. 생략하면 created_at 내림차순으로 정렬됩니다." }, "search_term": { "type": "string", "nullable": true, "description": "모니터 이름만을 대상으로 매칭되는 검색어입니다(정규 표현식, 대소문자 구분 없음)." }, "per_page": { "type": "integer", "description": "페이지당 결과 수입니다. 기본값은 25입니다.", "default": 25 }, "page": { "type": "integer", "description": "페이지네이션을 위한 페이지 번호입니다. 기본값은 1입니다.", "default": 1 }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "operationId": "monitors_list", "summary": "모니터 목록", "description": "워크스페이스의 모든 모니터 목록을 조회합니다.", "tags": [ "Monitor" ] } }, "/monitors/create": { "post": { "responses": { "200": { "description": "새로 생성된 모니터 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "새로 생성된 모니터의 고유 식별자입니다." }, "name": { "type": "string", "description": "모니터의 이름입니다." }, "description": { "type": "string", "description": "모니터의 설명입니다." }, "detection_mode": { "type": "string", "description": "감지 모드: 'company_first' 또는 'signal_first'입니다." }, "signal_types": { "type": "array", "items": { "type": "string" }, "description": "이 모니터가 감시하는 시그널 유형." }, "signal_filters": { "type": "array", "items": { "type": "object" }, "description": "시그널 유형별로 저장된 필터입니다. `query`로 생성한 경우 입력한 문장이 어떻게 해석되었는지 여기에서 확인해 의도와 맞는지 검증하세요." }, "company_filters": { "type": "object", "description": "일치한 모든 시그널에 적용되는 회사 프로필 필터." }, "companies": { "type": "array", "items": { "type": "string" }, "description": "감시 대상 회사(company_first)." }, "is_company_enrichment": { "type": "boolean", "description": "일치 결과에 회사 상세를 보강할지 여부." }, "is_people_enrichment": { "type": "boolean", "description": "일치 결과에 인물 및 연락처를 보강할지 여부." }, "people_enrichment_configs": { "type": "array", "items": { "type": "object" }, "description": "저장된 인물 보강 설정." }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다." }, "destination_config": { "type": "object", "description": "전달 대상 상세(이메일 또는 webhook URL)." }, "frequency_minute": { "type": "integer", "description": "모니터 실행 주기(분)." }, "notification_email": { "type": "string", "nullable": true, "description": "모니터 자체 알림을 받을 주소." }, "max_retry_per_trigger": { "type": "integer", "description": "트리거당 허용되는 재시도 횟수." }, "retry_delay_second": { "type": "integer", "description": "재시도 간격(초)." }, "max_records_per_trigger": { "type": "integer", "description": "트리거당 전달되는 최대 레코드 수." }, "max_daily_trigger": { "type": "integer", "description": "하루 최대 트리거 횟수." }, "max_failure_trigger": { "type": "integer", "description": "모니터가 중지되기까지의 연속 실패 횟수." }, "status": { "type": "string", "enum": [ "draft", "active", "paused", "inactive" ], "description": "모니터가 생성된 라이프사이클 상태." }, "masked_signature": { "type": "string", "description": "표시용 마스킹된 웹훅 서명입니다." }, "created_at": { "type": "string", "format": "date-time", "description": "모니터 생성 타임스탬프입니다." }, "signature": { "type": "string", "format": "uuid", "description": "페이로드 확인을 위한 웹훅 서명입니다. 생성 시에만 반환됩니다." } } } } }, "example": { "data": { "monitor_id": "c9cd5421-b327-4243-9cd7-8b341b3da8bd", "name": "Expansion signals → JP", "description": null, "detection_mode": "signal_first", "signal_types": [ "expansions" ], "signal_filters": [ { "signal_type": "expansions", "filters": { "tos": [ "JP" ] } } ], "company_filters": {}, "companies": [], "is_company_enrichment": false, "is_people_enrichment": true, "people_enrichment_configs": [ { "max_people_to_return": 5, "filters": { "management_levels": [ "c_suite" ] }, "people_contact_types": [ "email-work" ] } ], "destination_type": "email", "destination_config": { "emails": [ "me@company.com" ] }, "frequency_minute": 5, "notification_email": null, "max_retry_per_trigger": 3, "retry_delay_second": 60, "max_records_per_trigger": 100, "max_daily_trigger": 24, "max_failure_trigger": 5, "status": "active", "masked_signature": "5••••••••••••••8b8", "created_at": "2026-07-16T10:27:40.469Z", "signature": "52209a0d-f1c8-4111-a685-ac86edc678b8" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "모니터의 이름입니다." }, "description": { "type": "string", "description": "모니터의 설명입니다." }, "status": { "type": "string", "description": "모니터를 생성할 때의 라이프사이클 상태입니다. 기본값은 `active`. `draft`를 사용하면 미완성 모니터를 저장할 수 있습니다(필수는 `name`뿐이며, 검증은 활성화 시점으로 미뤄지고 초안은 실행되지 않습니다).", "enum": [ "draft", "active", "paused", "inactive" ], "default": "active" }, "detection_mode": { "type": "string", "description": "감지 모드: 'company_first'는 기업을 먼저 찾은 다음 신호를 확인하고, 'signal_first'는 신호를 먼저 찾은 다음 기업을 매칭합니다.", "enum": [ "company_first", "signal_first" ] }, "signal_types": { "type": "array", "items": { "type": "string", "enum": [ "jobs", "news", "advertisements", "expansions" ] }, "description": "모니터링할 신호 유형입니다." }, "signal_filters": { "type": "array", "items": { "type": "object" }, "description": "신호 필터 객체 배열입니다. 각 객체는 `signal_type` (jobs, news, advertisements 중 하나)과 `filters` (신호별 매개변수가 포함된 객체)로 구성됩니다. 사용 가능한 필터 매개변수는 [Job Search](/ko/api-reference/endpoint/companies/job_search), [News Search](/ko/api-reference/endpoint/companies/news_search) 또는 [Advertisement Search](/ko/api-reference/endpoint/companies/advertisements_search) 엔드포인트를 참조하세요.", "example": [ { "filters": { "locations": [ "US" ] }, "signal_type": "jobs" }, { "filters": { "locations": [ "US" ] }, "signal_type": "news" }, { "filters": { "target_locations": [ "US" ] }, "signal_type": "advertisements" } ] }, "company_filters": { "type": "object", "description": "글로벌 기업 필터로 두 번째 레이어로 적용됩니다. [Company Search](/ko/api-reference/endpoint/companies/search) 엔드포인트와 동일한 매개변수 — locations, employees, technologies, verticals 등을 허용합니다.", "example": { "locations": [ "US" ], "employees": [ [ 501, 1000 ], [ 1001, 5000 ] ] } }, "companies": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "모니터링할 기업 domain_search_id UUID 목록입니다. 주로 company_first 모드에서 대상 기업을 지정하는 데 사용됩니다. `domains` 또는 `linkedin_urls`를 대안으로 사용할 수 있습니다 — 셋 중 하나만 입력하면 됩니다." }, "domains": { "type": "array", "items": { "type": "string" }, "description": "모니터링할 회사 도메인 목록 (예: [\"openai.com\", \"google.com\"]). `companies`의 대안으로 사용 가능 — Pubrio가 해당 회사를 자동으로 확인합니다. `companies`, `domains`, `linkedin_urls` 중 하나만 입력하면 됩니다." }, "linkedin_urls": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "LinkedIn 회사 페이지 URL 목록 (예: [\"https://linkedin.com/company/pubrio\"]). `companies`의 대안으로 사용 가능합니다. 셋 중 하나만 입력하면 됩니다." }, "is_company_enrichment": { "type": "boolean", "description": "결과에서 기업 데이터를 보강할지 여부입니다." }, "is_people_enrichment": { "type": "boolean", "description": "결과에서 인물 데이터를 보강할지 여부입니다." }, "people_enrichment_configs": { "type": "array", "items": { "type": "object" }, "description": "인물 보강 레이어 배열입니다. 각 레이어는 독립적인 인물 검색을 수행합니다. `max_people_to_return` (1-25), `people_contact_types` (배열 — [Redeem](/ko/api-reference/endpoint/redeem/people) 엔드포인트의 연락처 유형 참조: email-work, email-personal, phone), `filters` ([People Search](/ko/api-reference/endpoint/people/search) 엔드포인트와 동일한 매개변수)를 포함합니다. 사용 가능한 필터 매개변수는 인물 검색(People Search)을, 연락처 유형 세부 정보는 Redeem을 참조하세요.", "example": [ { "filters": { "people_locations": [ "US" ] }, "max_people_to_return": 3, "people_contact_types": [ "email-work" ] } ] }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다.", "enum": [ "webhook", "email", "sequences" ] }, "destination_config": { "type": "object", "description": "대상 구성입니다. 웹훅의 경우: `webhook_url` (문자열) 필수, `headers` (객체) 및 `body` (객체) 선택 사항. 이메일의 경우: `email` (문자열) 또는 `emails` (문자열 배열)을 허용합니다. sequences 유형은 `sequence_identifier`(문자열)와 함께 `is_people_search_enrolled` / `is_company_contact_enrolled` 중 최소 하나를 true로 설정해야 합니다.", "example": { "webhook_url": "https://your-webhook.com/endpoint", "headers": { "Authorization": "Bearer token" }, "body": { "pipeline": "my-webhook" } } }, "frequency_minute": { "type": "integer", "description": "트리거 빈도(분)입니다. 최소: 0, 최대: 10080, 기본값: 0.", "minimum": 0, "maximum": 10080, "default": 0 }, "max_failure_trigger": { "type": "integer", "description": "모니터 일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10, 기본값: 5.", "minimum": 1, "maximum": 10, "default": 5 }, "max_daily_trigger": { "type": "integer", "description": "일일 최대 트리거 수입니다. 최소: 0, 최대: 86400, 기본값: 500.", "minimum": 0, "maximum": 86400, "default": 500 }, "max_records_per_trigger": { "type": "integer", "description": "트리거당 최대 전달 레코드 수를 제어합니다. 값을 낮추면 전달당 페이로드 크기가 줄어들며, 결과 세트가 크거나 속도 제한이 있는 통합에 권장됩니다. 최소값: 1, 최대값: 100, 기본값: 25. 자세한 내용은 [Webhook 설정](/ko/developer-guides/setting-up-webhooks)을 참조하세요.", "minimum": 1, "maximum": 100, "default": 25 }, "notification_email": { "type": "string", "format": "email", "description": "모니터 실패 알림 이메일 주소입니다." }, "max_retry_per_trigger": { "type": "integer", "description": "트리거당 최대 재시도 횟수입니다. 최소: 0, 최대: 3, 기본값: 1.", "minimum": 0, "maximum": 3, "default": 1 }, "retry_delay_second": { "type": "integer", "description": "재시도 간 지연 시간(초)입니다. 최소: 1, 최대: 5, 기본값: 1.", "minimum": 1, "maximum": 5, "default": 1 }, "profile_id": { "$ref": "#/components/schemas/profile_id" }, "query": { "type": "string", "maxLength": 2000, "description": "모니터에 대한 자연어 설명(모든 언어). 예: \"일본에 진출하는 기업을 모니터링하고 C-레벨 인물의 업무용 이메일을 받아 me@company.com으로 실시간 알림 전송\". 동일한 요청에서 아래 필드(detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute)로 해석됩니다. 명시적으로 전달한 필드는 해석된 값보다 우선합니다. 텍스트가 모니터 요청이 아니면 400을 반환합니다. 최대 2000자." }, "deep": { "type": "boolean", "description": "선택 사항, `query`와 함께 사용할 때만 적용됩니다. 정확도를 높이는 리플렉션 패스 실행(기본 true, 해석 지연 약 2배). false로 설정하면 단일 패스로 더 빠르게 해석합니다." } }, "anyOf": [ { "title": "자연어", "required": [ "query" ] }, { "title": "구조화 필드", "required": [ "name", "detection_mode", "signal_types", "destination_type", "destination_config" ] }, { "title": "초안", "required": [ "name", "status" ] } ] } } } }, "operationId": "monitors_create", "summary": "모니터 생성", "description": "데이터 모니터를 생성합니다. 지정한 회사와 필터에서 관심 있는 비즈니스 시그널(새 채용 공고, 뉴스, 광고, 시장 확장 동향)을 상시 포착하고, 각 매치에 회사·담당자 데이터를 보강하여 설정한 일정에 따라 대상(이메일 또는 Webhook)으로 전달하는 상시 가동 모니터입니다. 항목별로 구성하거나 `query`에 자연어 한 문장을 전달해 모니터 전체를 설명하면 동일한 요청에서 구성으로 해석됩니다.", "tags": [ "Monitor" ] } }, "/monitors/interpret": { "post": { "operationId": "interpretMonitor", "summary": "자연어로 모니터 해석", "description": "모니터를 만들기 전에 미리 볼 수 있습니다. 자연어 요청(어떤 언어든)을 검증된 **초안** 구성으로 변환하여 검토·조정한 뒤 [모니터 생성](/ko/api-reference/endpoint/monitors/create)에 제출할 수 있습니다. 얼마든지 안전하게 호출할 수 있습니다. 초안만 생성할 뿐 모니터를 저장하거나 알림을 보내거나 크레딧을 소모하지 않습니다. `intent`로 동작을 지정하며, 생략하면 영어 키워드 추론이 적용되고 인식되지 않으면 `create_monitor`가 기본값입니다.", "tags": [ "Monitor" ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "maxLength": 2000, "description": "자연어 요청(모든 언어). 예: \"일본에 진출하는 기업을 모니터링하고 C-레벨 인물의 업무용 이메일을 받아 me@company.com으로 실시간 알림 전송\". 최대 2000자." }, "intent": { "type": "string", "enum": [ "create_monitor", "dry_test", "execute", "analyze" ], "description": "수행할 동작(언어 무관). `create_monitor`(기본): 초안 구성 반환. `dry_test`: 초안과 현재 일치하는 시그널 수의 읽기 전용 카운트. `execute`: 초안과 미리보기를 반환하고 확인 대기로 표시(자동 활성화 안 함). `analyze`(예: \"싱가포르 vs 일본?\"): 모니터를 만들지 않고 확장 분석 에이전트가 답변. 생략 시 영어 키워드 추론 사용, 인식 불가 시 `create_monitor`가 기본값." }, "deep": { "type": "boolean", "description": "정확도를 높이는 리플렉션 패스 실행(기본 true, 지연 약 2배). false로 설정하면 단일 패스로 더 빠르게 해석합니다." } } }, "example": { "query": "monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time" } } } }, "responses": { "200": { "description": "해석된 초안입니다. 아무것도 저장되지 않습니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "intent": { "type": "string", "enum": [ "create_monitor", "dry_test", "execute", "analyze" ], "description": "해석된 동작(create_monitor / dry_test / execute / analyze)." }, "no_intent": { "type": "boolean", "description": "요청이 모니터 설정이 아닐 때(인사, 주제 무관, 무의미) true이며 이때 `config`는 null입니다." }, "config": { "type": "object", "nullable": true, "description": "초안 모니터 구성으로 [모니터 생성](/ko/api-reference/endpoint/monitors/create) 요청 본문과 동일한 형태입니다(detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute, status \"draft\" 등). 모니터 생성에 제출하면 활성화됩니다. `domains`/`linkedin_urls`/`company_names`를 포함할 수 있으며 모니터 생성이 이를 회사로 해석합니다. `no_intent`가 true이면 null입니다." }, "missing_fields": { "type": "array", "items": { "type": "string" }, "description": "모니터를 활성화하기 전에 아직 필요한 필드(예: \"destination\", \"signal_types\", \"companies\"). 모니터 생성에 제출하기 전에 UI에서 수집하세요." }, "requires_confirmation": { "type": "boolean", "description": "`execute` 인텐트일 때 true — 구성은 준비되었지만 활성화 전에 사용자 확인이 필요합니다." }, "preview": { "type": "object", "nullable": true, "description": "`dry_test`와 `execute`에서 제공됩니다. 지난 30일 동안 현재 일치하는 시그널 수의 읽기 전용 추정치(시그널 유형별, 샘플링). 크레딧이 소모되지 않습니다." }, "interpretation": { "type": "object", "description": "쿼리에서 추출된 원시 필드의 에코로 표시 또는 디버깅용입니다." } } } } }, "example": { "data": { "intent": "create_monitor", "no_intent": false, "config": { "detection_mode": "signal_first", "signal_types": [ "expansions" ], "signal_filters": [ { "signal_type": "expansions", "filters": { "tos": [ "JP" ], "stage_slug_list": [ "exploring", "committing" ] } } ], "company_filters": {}, "companies": [], "is_company_enrichment": false, "is_people_enrichment": true, "people_enrichment_configs": [ { "max_people_to_return": 5, "filters": { "management_levels": [ "c_suite" ] }, "people_contact_types": [ "email-work" ] } ], "name": "Expansion signals → JP", "destination_type": "email", "destination_config": { "emails": [ "me@company.com" ] }, "frequency_minute": 5, "status": "draft" }, "missing_fields": [], "requires_confirmation": false, "preview": null, "interpretation": { "signal_types": [ "expansions" ], "tos": [ "JP" ], "management_levels": [ "c_suite" ], "people_contact_types": [ "email-work" ], "destination_email": "me@company.com", "is_realtime": true } } } } } } } } }, "/monitors/update": { "post": { "responses": { "200": { "description": "업데이트된 모니터가 포함된 성공적인 응답입니다. 응답에는 monitor_id, name, detection_mode, destination_type, status, masked_signature, last_modified가 항상 포함되며, 업데이트에 포함된 다른 컬럼도 함께 반환됩니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "모니터의 고유 식별자입니다." }, "name": { "type": "string", "description": "모니터의 이름입니다." }, "detection_mode": { "type": "string", "description": "감지 모드입니다." }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다." }, "status": { "type": "string", "enum": [ "draft", "active", "paused", "inactive" ], "description": "모니터의 라이프사이클 상태입니다." }, "masked_signature": { "type": "string", "description": "마스킹된 웹훅 서명입니다." }, "last_modified": { "type": "string", "format": "date-time", "description": "모니터 최종 수정 타임스탬프입니다." } }, "description": "업데이트된 모니터입니다. 업데이트에 포함된 다른 컬럼도 함께 반환됩니다." } } }, "example": { "data": { "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "name": "Updated Monitor Name", "detection_mode": "company_first", "destination_type": "webhook", "status": "active", "masked_signature": "9••••••••••••••••f09", "last_modified": "2026-04-05T21:00:00.000Z" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "업데이트할 모니터의 고유 식별자입니다." }, "name": { "type": "string", "description": "모니터의 이름입니다." }, "description": { "type": "string", "description": "모니터의 설명입니다." }, "detection_mode": { "type": "string", "description": "감지 모드입니다.", "enum": [ "company_first", "signal_first" ] }, "signal_types": { "type": "array", "items": { "type": "string", "enum": [ "jobs", "news", "advertisements", "expansions" ] }, "description": "모니터링할 신호 유형입니다." }, "signal_filters": { "type": "array", "items": { "type": "object" }, "description": "신호 필터 객체 배열입니다. 각 객체는 `signal_type` (jobs, news, advertisements 중 하나)과 `filters` (신호별 매개변수가 포함된 객체)로 구성됩니다. 사용 가능한 필터 매개변수는 [Job Search](/ko/api-reference/endpoint/companies/job_search), [News Search](/ko/api-reference/endpoint/companies/news_search) 또는 [Advertisement Search](/ko/api-reference/endpoint/companies/advertisements_search) 엔드포인트를 참조하세요.", "example": [ { "filters": { "locations": [ "US" ] }, "signal_type": "jobs" }, { "filters": { "locations": [ "US" ] }, "signal_type": "news" }, { "filters": { "target_locations": [ "US" ] }, "signal_type": "advertisements" } ] }, "company_filters": { "type": "object", "description": "글로벌 기업 필터로 두 번째 레이어로 적용됩니다. [Company Search](/ko/api-reference/endpoint/companies/search) 엔드포인트와 동일한 매개변수 — locations, employees, technologies, verticals 등을 허용합니다.", "example": { "locations": [ "US" ], "employees": [ [ 501, 1000 ], [ 1001, 5000 ] ] } }, "companies": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "기업 domain_search_id UUID 목록입니다. `domains` 또는 `linkedin_urls`를 대안으로 사용할 수 있습니다." }, "domains": { "type": "array", "items": { "type": "string" }, "description": "회사 도메인 목록입니다. `companies`의 대안으로 사용 가능합니다." }, "linkedin_urls": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "LinkedIn 회사 페이지 URL 목록입니다. `companies`의 대안으로 사용 가능합니다." }, "is_company_enrichment": { "type": "boolean", "description": "기업 데이터를 보강할지 여부입니다." }, "is_people_enrichment": { "type": "boolean", "description": "인물 데이터를 보강할지 여부입니다." }, "people_enrichment_configs": { "type": "array", "items": { "type": "object" }, "description": "인물 보강 레이어 배열입니다. 각 레이어는 독립적인 인물 검색을 수행합니다. `max_people_to_return` (1-25), `people_contact_types` (배열 — [Redeem](/ko/api-reference/endpoint/redeem/people) 엔드포인트의 연락처 유형 참조: email-work, email-personal, phone), `filters` ([People Search](/ko/api-reference/endpoint/people/search) 엔드포인트와 동일한 매개변수)를 포함합니다. 사용 가능한 필터 매개변수는 인물 검색(People Search)을, 연락처 유형 세부 정보는 Redeem을 참조하세요.", "example": [ { "filters": { "people_locations": [ "US" ] }, "max_people_to_return": 3, "people_contact_types": [ "email-work" ] } ] }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다.", "enum": [ "webhook", "email", "sequences" ] }, "destination_config": { "type": "object", "description": "대상 구성입니다. 웹훅의 경우: `webhook_url` (문자열) 필수, `headers` (객체) 및 `body` (객체) 선택 사항. 이메일의 경우: `email` (문자열) 또는 `emails` (문자열 배열)을 허용합니다. sequences 유형은 `sequence_identifier`(문자열)와 함께 `is_people_search_enrolled` / `is_company_contact_enrolled` 중 최소 하나를 true로 설정해야 합니다.", "example": { "webhook_url": "https://your-webhook.com/endpoint", "headers": { "Authorization": "Bearer token" }, "body": { "pipeline": "my-webhook" } } }, "frequency_minute": { "type": "integer", "description": "트리거 빈도(분)입니다. 최소: 0, 최대: 10080, 기본값: 0.", "minimum": 0, "maximum": 10080 }, "max_failure_trigger": { "type": "integer", "description": "일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10, 기본값: 5.", "minimum": 1, "maximum": 10 }, "max_daily_trigger": { "type": "integer", "description": "일일 최대 트리거 수입니다. 최소: 0, 최대: 86400, 기본값: 500.", "minimum": 0, "maximum": 86400 }, "max_records_per_trigger": { "type": "integer", "description": "트리거당 최대 전달 레코드 수를 제어합니다. 값을 낮추면 전달당 페이로드 크기가 줄어들며, 결과 세트가 크거나 속도 제한이 있는 통합에 권장됩니다. 최소값: 1, 최대값: 100, 기본값: 25. 자세한 내용은 [Webhook 설정](/ko/developer-guides/setting-up-webhooks)을 참조하세요.", "minimum": 1, "maximum": 100 }, "notification_email": { "type": "string", "format": "email", "description": "실패 알림 이메일입니다." }, "max_retry_per_trigger": { "type": "integer", "description": "트리거당 최대 재시도 횟수입니다. 최소: 0, 최대: 3, 기본값: 1.", "minimum": 0, "maximum": 3 }, "retry_delay_second": { "type": "integer", "description": "재시도 간 지연 시간(초)입니다. 최소: 1, 최대: 5, 기본값: 1.", "minimum": 1, "maximum": 5 }, "status": { "type": "string", "enum": [ "draft", "active", "paused", "inactive" ], "description": "설정할 라이프사이클 상태입니다. 상태를 변경하면 실패 카운터가 초기화됩니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "monitor_id" ] } } } }, "operationId": "monitors_update", "summary": "모니터 수정", "description": "기존 모니터의 구성 및 감지 규칙을 수정합니다.", "tags": [ "Monitor" ] } }, "/monitors/duplicate": { "post": { "responses": { "200": { "description": "복제된 모니터가 포함된 성공적인 응답입니다. 전체 모니터 구성(signal_types, signal_filters, company_filters, companies, 보강 설정, 대상, 트리거 제한)이 반환되며, 복사본에 대해 새로 생성된 `signature`도 포함됩니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "복제된 모니터의 고유 식별자입니다." }, "name": { "type": "string", "description": "복제된 모니터의 이름입니다." }, "description": { "type": "string", "description": "복제된 모니터의 설명입니다." }, "detection_mode": { "type": "string", "description": "감지 모드입니다." }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다." }, "status": { "type": "string", "enum": [ "draft", "active", "paused", "inactive" ], "description": "복제된 모니터의 라이프사이클 상태입니다." }, "masked_signature": { "type": "string", "description": "마스킹된 웹훅 서명입니다." }, "created_at": { "type": "string", "format": "date-time", "description": "복제본 생성 타임스탬프입니다." }, "signature": { "type": "string", "format": "uuid", "description": "복제된 모니터의 웹훅 서명입니다." } }, "description": "복제된 모니터입니다. 전체 구성(signal_types, signal_filters, company_filters, companies, 보강 설정, destination_config, 트리거 제한)도 함께 반환됩니다." } } }, "example": { "data": { "monitor_id": "e5f6a7b8-c9d0-1234-efab-345678901234", "name": "My Monitor (Copy)", "description": "Monitors news and job signals for target companies", "detection_mode": "signal_first", "destination_type": "webhook", "status": "active", "masked_signature": "7••••••••••••••••8df", "created_at": "2026-04-05T21:15:00.000Z", "signature": "f6a7b8c9-d0e1-2345-fabc-456789012345" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "복제할 모니터의 고유 식별자입니다." }, "name": { "type": "string", "description": "복제된 모니터의 이름입니다. 생략하면 복사본 이름은 \"<원본 이름> <복제 접미사>\"가 됩니다 — 원본 이름 뒤에 기본 복제 접미사가 붙습니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "monitor_id" ] } } } }, "operationId": "monitors_duplicate", "summary": "모니터 복제", "description": "동일한 구성으로 기존 모니터의 복사본을 생성합니다.", "tags": [ "Monitor" ] } }, "/monitors/delete": { "delete": { "responses": { "200": { "description": "성공적인 응답입니다. 모니터가 삭제되었습니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "nullable": true, "description": "삭제 성공 시 null을 반환합니다." } } }, "example": { "data": null } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "삭제할 모니터의 고유 식별자입니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "monitor_id" ] } } } }, "operationId": "monitors_delete", "summary": "모니터 삭제", "description": "워크스페이스에서 모니터를 삭제합니다.", "tags": [ "Monitor" ] } }, "/monitors/lookup": { "post": { "responses": { "200": { "description": "구성 및 대상 설정을 포함한 전체 모니터 세부 정보가 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "모니터의 고유 식별자입니다." }, "profile_id": { "type": "integer", "description": "프로필 식별자입니다." }, "user_id": { "type": "string", "description": "사용자 식별자입니다." }, "name": { "type": "string", "description": "모니터의 이름입니다." }, "description": { "type": "string", "description": "모니터의 설명입니다." }, "detection_mode": { "type": "string", "description": "감지 모드입니다." }, "signal_types": { "type": "array", "items": { "type": "string" }, "description": "모니터링된 신호 유형입니다." }, "signal_filters": { "type": "array", "items": { "type": "object" }, "description": "신호 필터 구성입니다." }, "company_filters": { "type": "object", "description": "기업 필터 구성입니다." }, "companies": { "type": "array", "items": { "type": "string" }, "description": "도메인 검색 식별자입니다." }, "is_company_enrichment": { "type": "boolean", "description": "기업 보강 활성화 여부입니다." }, "is_people_enrichment": { "type": "boolean", "description": "인물 보강 활성화 여부입니다." }, "people_enrichment_configs": { "type": "array", "items": { "type": "object" }, "description": "인물 보강 구성입니다." }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다." }, "destination_config": { "type": "object", "description": "전체 대상 구성 세부 정보입니다." }, "frequency_minute": { "type": "integer", "description": "트리거 빈도(분)입니다." }, "max_retry_per_trigger": { "type": "integer", "description": "트리거당 최대 재시도 횟수입니다." }, "max_records_per_trigger": { "type": "integer", "description": "트리거당 최대 레코드 수입니다." }, "retry_delay_second": { "type": "integer", "description": "재시도 간 지연 시간(초)입니다." }, "max_daily_trigger": { "type": "integer", "description": "일일 최대 트리거 수입니다." }, "max_failure_trigger": { "type": "integer", "description": "일시 중지 전 최대 연속 실패 횟수입니다." }, "masked_signature": { "type": "string", "description": "마스킹된 웹훅 서명입니다." }, "signature": { "type": "string", "format": "uuid", "description": "전체 웹훅 서명입니다. is_signature_reveal이 true일 때만 포함됩니다." }, "repeated_failure_count": { "type": "integer", "description": "현재 연속 실패 횟수입니다." }, "status": { "type": "string", "enum": [ "draft", "active", "paused", "inactive" ], "description": "모니터의 라이프사이클 상태입니다." }, "language_code": { "type": "string", "nullable": true, "description": "이 모니터의 전달 내용을 렌더링하는 데 사용되는 언어 코드입니다." }, "notification_email": { "type": "string", "description": "알림 이메일 주소입니다." }, "last_trigger_at": { "type": "string", "format": "date-time", "nullable": true, "description": "마지막 트리거 타임스탬프입니다." }, "last_processed_at": { "type": "string", "format": "date-time", "nullable": true, "description": "마지막 처리 완료 타임스탬프입니다." }, "created_at": { "type": "string", "format": "date-time", "description": "모니터 생성 타임스탬프입니다." }, "last_modified": { "type": "string", "format": "date-time", "description": "모니터 최종 수정 타임스탬프입니다." }, "last_processed": { "type": "string", "format": "date-time", "nullable": true, "description": "마지막 처리 이벤트의 타임스탬프입니다." }, "user": { "type": "object", "properties": { "user_id": { "type": "string", "description": "모니터를 생성한 사용자의 식별자입니다." }, "nickname": { "type": "string", "description": "사용자의 표시 이름입니다." }, "email": { "type": "string", "description": "사용자의 이메일입니다." } }, "description": "모니터를 생성한 사용자입니다." } } } } }, "example": { "data": { "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "profile_id": 1, "user_id": "a1b2c3d4-0000-0000-0000-000000000000", "name": "Signal First Monitor", "description": "Tracking AI job postings", "detection_mode": "signal_first", "signal_types": [ "jobs", "news", "advertisements" ], "signal_filters": [ { "filters": { "locations": [ "US" ], "titles": [ "AI Engineer" ] }, "signal_type": "jobs" }, "..." ], "company_filters": { "locations": [ "US" ], "employees": [ [ 501, 1000 ] ], "...": "..." }, "companies": [ "67c4696b-b7b0-46b5-b2af-9f434543661e" ], "is_company_enrichment": true, "is_people_enrichment": true, "people_enrichment_configs": [ { "filters": { "management_levels": [ "founder", "vp" ], "...": "..." }, "max_people_to_return": 25, "people_contact_types": [ "email-work", "email-personal", "phone" ] } ], "destination_type": "webhook", "destination_config": { "webhook_url": "https://usewebhook.com/example", "headers": { "X-Custom-Auth": "your-token" }, "body": { "source": "pubrio" } }, "frequency_minute": 0, "notification_email": "team@example.com", "max_retry_per_trigger": 2, "max_records_per_trigger": 10, "retry_delay_second": 5, "max_daily_trigger": 500, "masked_signature": "7••••••••••••••••8df", "signature": "710a69f6-aaaf-449d-b3f6-78ba66d648df", "repeated_failure_count": 0, "status": "active", "language_code": "en", "max_failure_trigger": 5, "last_processed_at": null, "last_trigger_at": null, "created_at": "2026-04-05T20:30:17.792Z", "last_modified": "2026-04-05T20:30:17.792Z", "last_processed": null, "user": { "user_id": "a1b2c3d4-0000-0000-0000-000000000000", "nickname": "Jane Smith", "email": "jane@example.com" } } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "조회할 모니터의 고유 식별자입니다." }, "is_signature_reveal": { "type": "boolean", "description": "true일 경우 전체 웹훅 서명이 응답에 포함됩니다. 기본값은 false입니다.", "default": false }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "monitor_id" ] } } } }, "operationId": "monitors_lookup", "summary": "모니터 조회", "description": "특정 모니터의 상세 정보를 조회합니다.", "tags": [ "Monitor" ] } }, "/monitors/signature/reveal": { "post": { "responses": { "200": { "description": "모니터의 전체 웹훅 서명이 포함된 성공적인 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "모니터의 고유 식별자입니다." }, "signature": { "type": "string", "format": "uuid", "description": "페이로드 확인을 위한 전체 웹훅 서명입니다." } } } } }, "example": { "data": { "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "signature": "d4e5f6a7-b8c9-0123-defa-234567890123" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "모니터의 고유 식별자입니다." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "monitor_id" ] } } } }, "operationId": "monitors_reveal_signature", "summary": "모니터 웹훅 서명 조회", "description": "모니터의 웹훅 서명 시크릿을 조회합니다.", "tags": [ "Monitor" ] } }, "/monitors/webhook/validate": { "post": { "responses": { "200": { "description": "웹훅 검증 결과(대상 구성 및 테스트 요청/응답 페이로드)가 포함된 성공적인 응답입니다. 웹훅 실패 시 이 엔드포인트는 오류 세부 정보에 웹훅의 응답을 담아 400 (MONITOR_WEBHOOK_URL_INVALID)으로 응답합니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "destination_config": { "type": "object", "description": "테스트된 대상 구성입니다." }, "request_payload": { "type": "object", "description": "검증 중 웹훅에 전송된 요청 페이로드입니다." }, "response_payload": { "type": "object", "description": "웹훅으로부터 수신된 응답 페이로드입니다." } } } } }, "example": { "data": { "destination_config": { "webhook_url": "https://usewebhook.com/example", "headers": { "X-Custom-Auth": "your-token" }, "body": { "source": "pubrio" } }, "request_payload": { "monitor": { "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "My Monitor", "detection_mode": "signal_first", "signal_types": [ "jobs", "news", "advertisements" ], "signal_filters": [ "..." ], "company_filters": { "...": "..." }, "is_company_enrichment": true, "is_people_enrichment": true, "people_enrichment_configs": [ "..." ] }, "metadata": { "total_signals": 3, "total_companies": 1, "total_people": 0 }, "triggered_at": "2026-04-05T22:43:06.973Z", "signals": [ { "signal_type": "jobs", "signal": { "signal_type": "jobs", "job_search_id": "...", "companies": [ "..." ] }, "companies": [ "..." ] }, "..." ], "source": "pubrio" }, "response_payload": "OK" } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "monitor_id": { "type": "string", "format": "uuid", "description": "테스트할 기존 모니터의 고유 식별자입니다. 새 구성 테스트 시 선택 사항입니다." }, "name": { "type": "string", "description": "모니터의 이름입니다." }, "description": { "type": "string", "description": "모니터의 설명입니다." }, "detection_mode": { "type": "string", "description": "감지 모드입니다.", "enum": [ "company_first", "signal_first" ] }, "signal_types": { "type": "array", "items": { "type": "string", "enum": [ "jobs", "news", "advertisements", "expansions" ] }, "description": "모니터링할 신호 유형입니다." }, "signal_filters": { "type": "array", "items": { "type": "object" }, "description": "신호 필터 객체 배열입니다. 각 객체는 `signal_type`과 `filters`로 구성됩니다. [Job Search](/ko/api-reference/endpoint/companies/job_search), [News Search](/ko/api-reference/endpoint/companies/news_search) 또는 [Advertisement Search](/ko/api-reference/endpoint/companies/advertisements_search)에서 필터 매개변수를 참조하세요.", "example": [ { "filters": { "locations": [ "US" ] }, "signal_type": "jobs" }, { "filters": { "locations": [ "US" ] }, "signal_type": "news" }, { "filters": { "target_locations": [ "US" ] }, "signal_type": "advertisements" } ] }, "company_filters": { "type": "object", "description": "글로벌 기업 필터입니다. [Company Search](/ko/api-reference/endpoint/companies/search) 엔드포인트와 동일한 매개변수를 허용합니다.", "example": { "locations": [ "US" ], "employees": [ [ 501, 1000 ], [ 1001, 5000 ] ] } }, "companies": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "모니터링할 기업 domain_search_id UUID 목록입니다. `domains` 또는 `linkedin_urls`를 대안으로 사용할 수 있습니다." }, "domains": { "type": "array", "items": { "type": "string" }, "description": "기업 도메인 목록입니다. `companies`의 대안입니다." }, "linkedin_urls": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "LinkedIn 기업 URL 목록입니다. `companies`의 대안입니다." }, "is_company_enrichment": { "type": "boolean", "description": "기업 데이터를 보강할지 여부입니다." }, "is_people_enrichment": { "type": "boolean", "description": "인물 데이터를 보강할지 여부입니다." }, "people_enrichment_configs": { "type": "array", "items": { "type": "object" }, "description": "인물 보강 레이어 배열입니다. `max_people_to_return` (1-25), `people_contact_types` ([Redeem](/ko/api-reference/endpoint/redeem/people) 참조), `filters` ([People Search](/ko/api-reference/endpoint/people/search) 참조)를 포함합니다.", "example": [ { "filters": { "people_locations": [ "US" ] }, "max_people_to_return": 3, "people_contact_types": [ "email-work" ] } ] }, "destination_type": { "type": "string", "description": "전달 대상 유형입니다.", "enum": [ "webhook", "email", "sequences" ] }, "destination_config": { "type": "object", "description": "대상 구성입니다. 웹훅의 경우: `webhook_url` (문자열) 필수, `headers` (객체) 및 `body` (객체) 선택 사항. 이메일의 경우: `email` (문자열) 또는 `emails` (문자열 배열)을 허용합니다. sequences 유형은 `sequence_identifier`(문자열)와 함께 `is_people_search_enrolled` / `is_company_contact_enrolled` 중 최소 하나를 true로 설정해야 합니다.", "example": { "webhook_url": "https://your-webhook.com/endpoint", "headers": { "Authorization": "Bearer token" }, "body": { "pipeline": "my-webhook" } } }, "frequency_minute": { "type": "integer", "description": "트리거 빈도(분)입니다. 최소: 0, 최대: 10080.", "minimum": 0, "maximum": 10080 }, "max_failure_trigger": { "type": "integer", "description": "일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10.", "minimum": 1, "maximum": 10 }, "max_daily_trigger": { "type": "integer", "description": "일일 최대 트리거 수입니다. 최소: 0, 최대: 86400.", "minimum": 0, "maximum": 86400 }, "max_records_per_trigger": { "type": "integer", "description": "트리거당 최대 전달 레코드 수를 제어합니다. 값을 낮추면 전달당 페이로드 크기가 줄어들며, 결과 세트가 크거나 속도 제한이 있는 통합에 권장됩니다. 최소값: 1, 최대값: 100, 기본값: 25. 자세한 내용은 [Webhook 설정](/ko/developer-guides/setting-up-webhooks)을 참조하세요.", "minimum": 1, "maximum": 100 }, "notification_email": { "type": "string", "format": "email", "description": "실패 알림 이메일입니다." }, "max_retry_per_trigger": { "type": "integer", "description": "트리거당 최대 재시도 횟수입니다. 최소: 0, 최대: 3.", "minimum": 0, "maximum": 3 }, "retry_delay_second": { "type": "integer", "description": "재시도 간 지연 시간(초)입니다. 최소: 1, 최대: 5.", "minimum": 1, "maximum": 5 }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "required": [ "destination_config" ] } } } }, "operationId": "monitors_validate_webhook", "summary": "모니터 웹훅 검증", "description": "모니터의 웹훅 엔드포인트 구성을 검증합니다.", "tags": [ "Monitor" ] } }, "/companies/news/languages": { "get": { "responses": { "200": { "description": "뉴스 언어 세부 정보를 포함한 성공 응답입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/data_array" } } }, "example": { "data": [ { "news_language_id": "77bb2cd2-fbea-4cd1-b860-78786c6b2343", "slug": "ar", "locale_code": "ar", "name": "Arabic", "name_en": "Arabic" }, "..." ] } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } }, "parameters": [], "operationId": "filters_list_news_languages", "summary": "뉴스 언어 목록", "description": "뉴스 필터링에 사용할 수 있는 언어 목록을 조회합니다.", "tags": [ "Filters" ] } }, "/api_keys/logs": { "post": { "tags": [ "API Keys" ], "summary": "API 요청 로그 목록 조회", "description": "워크스페이스에서 실행된 API 요청 로그를 페이지네이션 형식으로 조회합니다. 각 항목은 `pubrio-api-key`로 실행된 단일 요청을 의미하며, 경로, 메서드, 상태 코드, 소요 시간, 응답 크기, 사용 크레딧을 포함합니다. 특정 로그의 전체 요청 및 응답 본문을 확인하려면 [로그 상세 조회](/ko/api-reference/endpoint/api-keys/logs_lookup) 엔드포인트를 사용하세요.", "operationId": "api_keys_get_logs", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" }, "page": { "$ref": "#/components/schemas/page" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "order_by": { "type": "string", "enum": [ "created_at", "duration_ms", "status_code" ], "default": "created_at", "description": "로그 목록 정렬에 사용할 필드." }, "is_ascending_order": { "type": "boolean", "default": false, "description": "정렬 방향. `true`는 오름차순, `false`(기본값)는 내림차순." }, "search_term": { "type": "string", "description": "요청 경로, 로그 타입 슬러그, 원본 요청 본문에 대한 자유 검색." }, "log_types": { "type": "array", "items": { "type": "integer" }, "description": "로그 타입 ID로 필터링." }, "log_type_slugs": { "type": "array", "items": { "type": "string" }, "description": "로그 타입 슬러그로 필터링(예: `people_search`, `company_search`)." }, "status_codes": { "type": "array", "items": { "type": "integer" }, "description": "HTTP 상태 코드로 필터링(예: `[200, 400, 500]`)." }, "methods": { "type": "array", "items": { "type": "string" }, "description": "HTTP 메서드로 필터링(예: `[\"POST\", \"GET\"]`)." } } } } } }, "responses": { "200": { "description": "페이지네이션된 API 요청 로그를 반환하는 성공 응답.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "filters": { "type": "object", "description": "이 응답을 생성하는 데 사용된 요청 필터의 반환값(빈 값은 제거됨).", "additionalProperties": true } } }, "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "page": { "type": "integer", "description": "현재 페이지 번호." }, "per_page": { "type": "integer", "description": "페이지당 결과 수." }, "total_entries": { "type": "integer", "description": "전체 로그 항목 수." }, "total_pages": { "type": "integer", "description": "전체 페이지 수." }, "total_display_pages": { "type": "integer", "description": "현재 플랜에서 표시 가능한 최대 페이지 수." }, "is_timeout": { "type": "boolean", "description": "카운트 쿼리 시간 초과 여부." } } }, "query_logs": { "type": "array", "items": { "type": "object", "properties": { "query_log_id": { "type": "string", "format": "uuid", "description": "로그 항목의 고유 식별자. 전체 내용을 조회하려면 `/api_keys/logs/lookup`에 전달합니다." }, "created_at": { "type": "string", "description": "요청 수신 시각(UTC)." }, "profile_id": { "type": "integer", "description": "요청과 연결된 워크스페이스 프로필 ID." }, "user_id": { "type": "string", "format": "uuid", "description": "API 키와 연결된 사용자 ID." }, "method": { "type": "string", "description": "요청의 HTTP 메서드." }, "path": { "type": "string", "description": "요청 경로." }, "status_code": { "type": "integer", "description": "반환된 HTTP 상태 코드." }, "duration_ms": { "type": "integer", "description": "요청 처리 시간(밀리초)." }, "log_type_id": { "type": "integer", "description": "내부 로그 타입 ID. 청구 대상 로그 타입에 매핑되지 않은 요청은 `0`." }, "log_type_slug": { "type": "string", "nullable": true, "description": "로그 타입 슬러그(예: `people_search`). 청구 대상이 아닌 요청은 `null`." }, "log_type_name": { "type": "string", "nullable": true, "description": "사람이 읽을 수 있는 로그 타입 이름." }, "authentication_type": { "type": "string", "description": "사용된 인증 방식. API 키 요청은 항상 `pubrio-api-key`." }, "authentication_type_name": { "type": "string", "description": "사람이 읽을 수 있는 인증 방식 이름." }, "masked_authentication": { "type": "string", "description": "이 요청에 사용된 API 키의 마스킹된 표현." }, "response_size": { "type": "integer", "description": "응답 본문 크기(바이트)." }, "credits": { "type": "number", "description": "이 요청에서 차감된 총 크레딧." }, "ip": { "type": "string", "description": "호출자의 클라이언트 IP 주소." }, "email": { "type": "string", "description": "API 키 소유 사용자의 이메일." }, "nickname": { "type": "string", "description": "API 키 소유 사용자의 닉네임." }, "user": { "type": "object", "properties": { "user_id": { "type": "string", "format": "uuid" }, "nickname": { "type": "string" }, "email": { "type": "string" } } } } } } } } } }, "example": { "metadata": { "filters": { "page": 1, "per_page": 3, "status_codes": [ 200 ] } }, "data": { "pagination": { "page": 1, "per_page": 3, "total_entries": 1109, "total_pages": 370, "total_display_pages": 250, "is_timeout": false }, "query_logs": [ { "query_log_id": "fc1ce3dd-39f7-4fbd-9d22-569a17115c11", "created_at": "2026-05-14 12:04:32.243", "profile_id": 1, "user_id": "2981d4b3-f8b1-44d8-9759-889f3bfa2faf", "method": "POST", "path": "/api_keys/usage/daily", "status_code": 200, "duration_ms": 1821, "log_type_id": 0, "authentication_type": "pubrio-api-key", "masked_authentication": "0••••••••••••••••f39", "response_size": 2180, "ip": "127.0.0.1", "email": "you@example.com", "nickname": "Example User", "user": { "user_id": "2981d4b3-f8b1-44d8-9759-889f3bfa2faf", "nickname": "Example User", "email": "you@example.com" }, "log_type_slug": null, "credits": 0, "log_type_name": null, "authentication_type_name": "API Key" } ] } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } } } }, "/api_keys/logs/lookup": { "post": { "tags": [ "API Keys" ], "summary": "API 요청 로그 상세 조회", "description": "특정 API 요청 로그 항목의 전체 요청 본문, 요청 헤더, 응답 본문, 응답 크기를 조회합니다. 목록 엔드포인트에서 확인한 `query_log_id`로 송수신된 실제 내용을 확인할 때 사용합니다.", "operationId": "api_keys_lookup_log", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "query_log_id" ], "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" }, "query_log_id": { "type": "string", "format": "uuid", "description": "조회할 로그 항목의 고유 식별자. `/api_keys/logs`에서 가져옵니다." } } } } } }, "responses": { "200": { "description": "전체 요청 및 응답 본문을 반환하는 성공 응답.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "query_log_id": { "type": "string", "format": "uuid", "description": "조회한 로그 항목의 식별자." } } }, "data": { "type": "object", "nullable": true, "properties": { "query_log_id": { "type": "string", "format": "uuid", "description": "로그 항목의 식별자." }, "request_body": { "type": "string", "nullable": true, "description": "원본 요청 본문의 JSON 문자열." }, "request_headers": { "type": "string", "nullable": true, "description": "원본 요청 헤더의 JSON 문자열. API 키 등 민감한 헤더는 마스킹되어 저장됩니다." }, "response_body": { "type": "string", "nullable": true, "description": "호출자에게 반환된 응답 본문의 JSON 문자열." }, "response_size": { "type": "integer", "description": "응답 본문 크기(바이트)." } } } } }, "example": { "metadata": { "query_log_id": "fc1ce3dd-39f7-4fbd-9d22-569a17115c11" }, "data": { "query_log_id": "fc1ce3dd-39f7-4fbd-9d22-569a17115c11", "request_body": "{\"start_date\":\"2026-05-01\",\"end_date\":\"2026-05-14\"}", "request_headers": "{\"host\":\"api.pubrio.com\",\"user-agent\":\"curl/8.7.1\",\"accept\":\"*/*\",\"pubrio-api-key\":\"***\",\"content-type\":\"application/json\",\"content-length\":\"51\"}", "response_body": "{\"metadata\":{\"filters\":{\"start_date\":\"2026-05-01\",\"end_date\":\"2026-05-14\"}},\"data\":{\"series\":[...],\"by_log_type\":[...],\"totals\":{\"credits\":41892,\"requests\":4896}}}", "response_size": 2346 } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } } } }, "/api_keys/usage/daily": { "post": { "tags": [ "API Keys" ], "summary": "API 일별 사용량 시계열 조회", "description": "지정한 기간 동안 워크스페이스의 일별 API 요청 수와 크레딧 소비량을 조회합니다. 응답에는 일별 집계 시계열과 엔드포인트별 누적 데이터가 포함되어 사용량 차트 구성에 활용할 수 있습니다.", "operationId": "api_keys_get_usage_daily", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "start_date", "end_date" ], "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" }, "start_date": { "type": "string", "example": "2026-05-01", "description": "기간 시작일. `YYYY-MM-DD` 형식이며 워크스페이스 시간대 기준입니다." }, "end_date": { "type": "string", "example": "2026-05-14", "description": "기간 종료일. `YYYY-MM-DD` 형식이며 워크스페이스 시간대 기준입니다." }, "keys": { "type": "array", "items": { "type": "string" }, "description": "선택 사항. 마스킹된 API 키 식별자(예: `0••••••••••••••••f39`)로 결과를 필터링합니다. `/api_keys` 엔드포인트 응답이나 로그 항목의 `masked_authentication` 필드 값을 지정할 수 있습니다." }, "log_type_slugs": { "type": "array", "items": { "type": "string" }, "description": "선택 사항. 로그 타입 슬러그(예: `people_search`, `company_search`, `people_redeem`)로 결과를 필터링하여 특정 엔드포인트로 제한합니다." } } } } } }, "responses": { "200": { "description": "일별 사용량 시계열을 반환하는 성공 응답.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "filters": { "type": "object", "description": "이 응답을 생성하는 데 사용된 요청 필터의 반환값(빈 값은 제거됨).", "additionalProperties": true } } }, "data": { "type": "object", "properties": { "series": { "type": "array", "description": "모든 엔드포인트의 일별 합계. 날짜 오름차순 정렬.", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "날짜. `YYYY-MM-DD` 형식." }, "credits": { "type": "number", "description": "해당 날짜에 소비된 크레딧." }, "requests": { "type": "integer", "description": "해당 날짜의 API 요청 수." } } } }, "by_log_type": { "type": "array", "description": "엔드포인트별 누적 시리즈. 크레딧, 요청 수 순으로 내림차순 정렬.", "items": { "type": "object", "properties": { "slug": { "type": "string", "description": "로그 타입 슬러그. `__unknown__`은 청구 대상 로그 타입에 매핑되지 않은 요청을 의미합니다." }, "name": { "type": "string", "description": "사람이 읽을 수 있는 로그 타입 이름." }, "totals": { "type": "object", "properties": { "credits": { "type": "number" }, "requests": { "type": "integer" } } }, "series": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "credits": { "type": "number" }, "requests": { "type": "integer" } } } } } } }, "totals": { "type": "object", "properties": { "credits": { "type": "number" }, "requests": { "type": "integer" } } } } } } }, "example": { "metadata": { "filters": { "start_date": "2026-05-01", "end_date": "2026-05-14" } }, "data": { "series": [ { "date": "2026-05-01", "credits": 26352, "requests": 2827 }, { "date": "2026-05-05", "credits": 798, "requests": 402 }, { "date": "2026-05-11", "credits": 187, "requests": 187 } ], "by_log_type": [ { "slug": "people_redeem", "name": "Redeem People", "totals": { "credits": 40835, "requests": 4083 }, "series": [ { "date": "2026-05-01", "credits": 26140, "requests": 2614 }, { "date": "2026-05-11", "credits": 185, "requests": 15 } ] }, { "slug": "people_search", "name": "People Search", "totals": { "credits": 633, "requests": 212 }, "series": [ { "date": "2026-05-05", "credits": 594, "requests": 199 } ] } ], "totals": { "credits": 41892, "requests": 4896 } } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } } } }, "/api_keys/usage/breakdown": { "post": { "tags": [ "API Keys" ], "summary": "API 키 및 엔드포인트별 사용량 상세 조회", "description": "지정한 기간 동안의 API 요청 수와 크레딧 소비량을 API 키별(`by_key`)과 엔드포인트별(`by_endpoint`)로 나누어 조회합니다. 트래픽이 많은 키 또는 크레딧 소비가 큰 엔드포인트를 식별하는 데 유용합니다.", "operationId": "api_keys_get_usage_breakdown", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "start_date", "end_date" ], "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" }, "start_date": { "type": "string", "example": "2026-05-01", "description": "기간 시작일. `YYYY-MM-DD` 형식이며 워크스페이스 시간대 기준입니다." }, "end_date": { "type": "string", "example": "2026-05-14", "description": "기간 종료일. `YYYY-MM-DD` 형식이며 워크스페이스 시간대 기준입니다." }, "keys": { "type": "array", "items": { "type": "string" }, "description": "선택 사항. 마스킹된 API 키 식별자(예: `0••••••••••••••••f39`)로 결과를 필터링합니다. `/api_keys` 엔드포인트 응답이나 로그 항목의 `masked_authentication` 필드 값을 지정할 수 있습니다." }, "log_type_slugs": { "type": "array", "items": { "type": "string" }, "description": "선택 사항. 로그 타입 슬러그(예: `people_search`, `company_search`, `people_redeem`)로 결과를 필터링하여 특정 엔드포인트로 제한합니다." } } } } } }, "responses": { "200": { "description": "API 사용량 상세 정보를 반환하는 성공 응답.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "filters": { "type": "object", "description": "이 응답을 생성하는 데 사용된 요청 필터의 반환값(빈 값은 제거됨).", "additionalProperties": true } } }, "data": { "type": "object", "properties": { "by_key": { "type": "array", "description": "API 키별 사용량(상위 100건, 크레딧/요청 수 내림차순).", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "마스킹된 API 키 식별자." }, "requests": { "type": "integer", "description": "해당 키로 실행된 요청 수." }, "credits": { "type": "number", "description": "해당 키가 소비한 크레딧." }, "last_used": { "type": "string", "nullable": true, "description": "해당 키의 마지막 요청 시각. 기간 내 미사용 시 `null`." }, "percent_of_requests": { "type": "number", "description": "전체 요청 수 대비 비율(퍼센트)." }, "percent_of_credits": { "type": "number", "description": "전체 크레딧 대비 비율(퍼센트)." } } } }, "by_endpoint": { "type": "array", "description": "엔드포인트별 사용량(상위 100건, 크레딧/요청 수 내림차순).", "items": { "type": "object", "properties": { "slug": { "type": "string", "nullable": true, "description": "로그 타입 슬러그. 청구 대상 로그 타입에 매핑되지 않은 요청은 `null`." }, "name": { "type": "string", "description": "사람이 읽을 수 있는 로그 타입 이름." }, "requests": { "type": "integer" }, "credits": { "type": "number" }, "cost_per_call": { "type": "number", "description": "해당 엔드포인트의 요청당 평균 크레딧." }, "percent_of_requests": { "type": "number", "description": "전체 요청 수 대비 비율(퍼센트)." }, "percent_of_credits": { "type": "number", "description": "전체 크레딧 대비 비율(퍼센트)." } } } }, "totals": { "type": "object", "properties": { "credits": { "type": "number" }, "requests": { "type": "integer" } } } } } } }, "example": { "metadata": { "filters": { "start_date": "2026-04-01", "end_date": "2026-05-14" } }, "data": { "by_key": [ { "name": "2••••••••••••••••a37", "requests": 929, "credits": 42766, "last_used": "2026-05-05 11:09:42.508", "percent_of_requests": 17.892, "percent_of_credits": 99.425 }, { "name": "0••••••••••••••••f39", "requests": 175, "credits": 187, "last_used": "2026-05-14 12:04:21.651", "percent_of_requests": 3.37, "percent_of_credits": 0.434 } ], "by_endpoint": [ { "slug": "people_redeem", "name": "Redeem People", "requests": 4088, "credits": 41215, "cost_per_call": 10.08, "percent_of_requests": 78.73, "percent_of_credits": 95.82 }, { "slug": "people_search", "name": "People Search", "requests": 368, "credits": 1101, "cost_per_call": 2.99, "percent_of_requests": 7.08, "percent_of_credits": 2.55 } ], "totals": { "credits": 43013, "requests": 5192 } } } } } }, "400": { "$ref": "#/components/responses/general_error" }, "429": { "$ref": "#/components/responses/rate_limit_error" }, "500": { "$ref": "#/components/responses/server_error" } } } }, "/companies/jobs/insights": { "post": { "tags": [ "Insights" ], "summary": "채용 게시 인사이트", "description": "지정한 기간 동안의 회사 채용 신호 집계 인사이트: 게시량, 직급(seniority) 분포, 상위 기능/부서/지역, 그리고 주별 시계열.", "operationId": "companies_jobs_insights", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "domain_search_id" ], "properties": { "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "date_from": { "$ref": "#/components/schemas/date_from" }, "date_to": { "$ref": "#/components/schemas/date_to" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "해당 회사와 기간에 대한 채용 인사이트 밴드.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "요청한 회사와 기간에 대한 인사이트 밴드." } } }, "example": { "data": { "totals": { "open": 124, "new_in_window": 31, "functions": 6, "locations": 4 }, "seniority": { "classified": 28, "leadership": 5, "tiers": [ { "key": "leadership", "rank": 5, "count": 5 }, { "key": "senior", "rank": 3, "count": 12 } ] }, "postings": [ { "title": "Country Manager", "country_code": "GB", "posted_at": "2026-02-14" } ], "weekly_series": [ { "week_start": "2026-02-09", "count": 8 } ], "breakdown_function": [ { "key": "sales", "count": 11 }, { "key": "engineering", "count": 7 } ], "breakdown_department": [ { "key": "go_to_market", "count": 9 } ], "breakdown_location": [ { "key": "GB", "count": 14 } ], "window_days": 90 } } } } } } } }, "/companies/jobs/export": { "post": { "tags": [ "Export" ], "summary": "채용 게시 내보내기", "description": "지정한 회사의 채용 게시를 다운로드 가능한 데이터셋으로 내보냅니다. `data_export_credit`를 소비합니다.", "operationId": "companies_jobs_export", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "companies" ], "properties": { "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "exclude_fields": { "$ref": "#/components/schemas/exclude_fields" }, "exclude_data_export_fields": { "type": "array", "items": { "type": "string" }, "example": [ "raw_html" ], "description": "생성된 내보내기 파일에서 제외할 열입니다(각 레코드에서 필드를 제거하는 `exclude_fields`와는 별개입니다)." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "내보낸 레코드입니다. `data_export_credit` 잔액에서 차감됩니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object" }, "description": "내보낸 레코드이며, `exclude_fields`에서 지정한 필드는 제거되었습니다." } } } } } } } } }, "/companies/news/insights": { "post": { "tags": [ "Insights" ], "summary": "뉴스 인사이트", "description": "지정한 기간 동안의 회사 뉴스 신호 집계 인사이트: 언급량, 상위 토픽 및 출처, 카테고리 및 시장별 분류, 그리고 주별 시계열.", "operationId": "companies_news_insights", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "domain_search_id" ], "properties": { "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "date_from": { "$ref": "#/components/schemas/date_from" }, "date_to": { "$ref": "#/components/schemas/date_to" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "해당 회사와 기간에 대한 뉴스 인사이트 밴드.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "요청한 회사와 기간에 대한 인사이트 밴드." } } }, "example": { "data": { "totals": { "mentions": 42, "sources": 9 }, "mentions": 42, "topics": [ { "key": "funding", "count": 6 }, { "key": "partnership", "count": 4 } ], "sources": [ { "key": "TechCrunch", "count": 3 } ], "top_source": { "key": "TechCrunch", "count": 3 }, "weekly_series": [ { "week_start": "2026-02-09", "count": 5 } ], "category_breakdown": [ { "key": "business", "count": 18 } ], "market_breakdown": [ { "key": "GB", "count": 7 } ], "window_days": 90 } } } } } } } }, "/companies/news/export": { "post": { "tags": [ "Export" ], "summary": "뉴스 내보내기", "description": "지정한 회사의 뉴스 레코드를 다운로드 가능한 데이터셋으로 내보냅니다. `data_export_credit`를 소비합니다.", "operationId": "companies_news_export", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "companies" ], "properties": { "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "exclude_fields": { "$ref": "#/components/schemas/exclude_fields" }, "exclude_data_export_fields": { "type": "array", "items": { "type": "string" }, "example": [ "raw_html" ], "description": "생성된 내보내기 파일에서 제외할 열입니다(각 레코드에서 필드를 제거하는 `exclude_fields`와는 별개입니다)." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "내보낸 레코드입니다. `data_export_credit` 잔액에서 차감됩니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object" }, "description": "내보낸 레코드이며, `exclude_fields`에서 지정한 필드는 제거되었습니다." } } } } } } } } }, "/companies/advertisements/insights": { "post": { "tags": [ "Insights" ], "summary": "광고 인사이트", "description": "지정한 기간 동안의 회사 광고 신호 집계 인사이트: 활성 및 게재된 광고 수, 채널 및 게재 위치 구성, 크리에이티브 샘플, 티어 분포로 표현된 잠재 고객 도달 범위, 그리고 주별 시계열. 도달 범위는 단일 합산 수치가 아니라 항상 티어 전반의 분포로 보고됩니다.", "operationId": "companies_advertisements_insights", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "domain_search_id" ], "properties": { "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "date_from": { "$ref": "#/components/schemas/date_from" }, "date_to": { "$ref": "#/components/schemas/date_to" }, "profile_id": { "$ref": "#/components/schemas/profile_id" }, "is_include_unlinked_companies": { "type": "boolean", "example": false, "description": "아직 검증된 회사 프로필에 연결되지 않은 광고를 포함합니다." } } } } } }, "responses": { "200": { "description": "해당 회사와 기간에 대한 광고 인사이트 밴드.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "요청한 회사와 기간에 대한 인사이트 밴드." } } }, "example": { "data": { "totals": { "total": 88, "launched": 20, "active": 34, "markets": 5, "channels": 3 }, "weekly_series": [ { "week_start": "2026-02-09", "count": 12 } ], "postings": [ { "headline": "Try our platform", "format": "video", "started_at": "2026-02-10" } ], "placement_mix": [ { "key": "facebook", "count": 22 }, { "key": "instagram", "count": 14 } ], "creatives": [ { "headline": "Try our platform", "format": "video" } ], "reach_tiers": [ { "key": "10k-50k", "count": 9 }, { "key": "50k-100k", "count": 4 } ], "window_days": 90 } } } } } } } }, "/companies/advertisements/export": { "post": { "tags": [ "Export" ], "summary": "광고 내보내기", "description": "지정한 회사의 광고 레코드를 다운로드 가능한 데이터셋으로 내보냅니다. `data_export_credit`를 소비합니다.", "operationId": "companies_advertisements_export", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "companies" ], "properties": { "companies": { "$ref": "#/components/schemas/companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "exclude_fields": { "$ref": "#/components/schemas/exclude_fields" }, "exclude_data_export_fields": { "type": "array", "items": { "type": "string" }, "example": [ "raw_html" ], "description": "생성된 내보내기 파일에서 제외할 열입니다(각 레코드에서 필드를 제거하는 `exclude_fields`와는 별개입니다)." }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "내보낸 레코드입니다. `data_export_credit` 잔액에서 차감됩니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object" }, "description": "내보낸 레코드이며, `exclude_fields`에서 지정한 필드는 제거되었습니다." } } } } } } } } }, "/expansions/dashboard": { "post": { "tags": [ "Expansion" ], "summary": "확장 개요", "description": "시장 단위 확장 KPI — 시장별 단계 카운트와 주요 국경 간 흐름. 집계된 값이며 페이지네이션되지 않습니다.", "operationId": "expansions_dashboard", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "froms": { "$ref": "#/components/schemas/expansion_froms" }, "tos": { "$ref": "#/components/schemas/expansion_tos" }, "exclude_froms": { "$ref": "#/components/schemas/expansion_exclude_froms" }, "exclude_tos": { "$ref": "#/components/schemas/expansion_exclude_tos" }, "stages": { "$ref": "#/components/schemas/expansion_stages" }, "momentum": { "$ref": "#/components/schemas/expansion_momentum" }, "freshness": { "$ref": "#/components/schemas/expansion_freshness" }, "scopes": { "$ref": "#/components/schemas/expansion_scopes" }, "ahead_of_pace": { "type": "boolean", "example": false, "description": "해당 시장의 일반적인 속도보다 빠르게 움직이는 회사/시장 쌍으로 제한합니다." }, "signal_types": { "$ref": "#/components/schemas/expansion_signal_type_slugs" }, "signal_strengths": { "$ref": "#/components/schemas/signal_strengths" }, "min_signal_count": { "type": "integer", "example": 3, "description": "해당 기간 동안 회사가 보유해야 하는 최소 확장 신호 수입니다 — \"매우 활발함 / 활동 범위가 넓음\"을 걸러냅니다." }, "only_contraction": { "$ref": "#/components/schemas/only_contraction" }, "verticals": { "$ref": "#/components/schemas/verticals" }, "vertical_categories": { "$ref": "#/components/schemas/vertical_categories" }, "vertical_sub_categories": { "$ref": "#/components/schemas/vertical_sub_categories" }, "technologies": { "$ref": "#/components/schemas/technologies" }, "employees": { "$ref": "#/components/schemas/employees" }, "revenues": { "$ref": "#/components/schemas/revenues" }, "founded_dates": { "$ref": "#/components/schemas/founded_dates" }, "keywords": { "$ref": "#/components/schemas/keywords" }, "companies": { "$ref": "#/components/schemas/expansion_companies" }, "job_locations": { "$ref": "#/components/schemas/locations" }, "job_exclude_locations": { "$ref": "#/components/schemas/job_exclude_locations" }, "job_posted_dates": { "$ref": "#/components/schemas/posted_dates" }, "job_titles": { "$ref": "#/components/schemas/people_titles" }, "advertisement_target_locations": { "$ref": "#/components/schemas/advertisement_target_locations" }, "advertisement_exclude_target_locations": { "$ref": "#/components/schemas/advertisement_exclude_target_locations" }, "advertisement_search_terms": { "$ref": "#/components/schemas/advertisement_search_terms" }, "advertisement_start_dates": { "$ref": "#/components/schemas/advertisement_start_dates" }, "advertisement_end_dates": { "$ref": "#/components/schemas/advertisement_end_dates" }, "news_categories": { "$ref": "#/components/schemas/news_categories" }, "news_published_dates": { "$ref": "#/components/schemas/published_dates" }, "transitioned_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2026-06-01", "2026-06-29" ], "description": "표시 윈도우(지도, 흐름, 관심 목록 타임라인)의 ISO 날짜 범위 [start, end]입니다. 기본값은 최근 90일입니다. `new_transitions_30d` KPI는 이 범위와 무관하게 항상 자체 고정 30일 윈도우를 사용합니다." }, "window_days": { "$ref": "#/components/schemas/window_days" }, "min_markets": { "type": "integer", "example": 3, "description": "해당 기간 내에 회사가 진입해야 하는 신규 시장의 최소 개수입니다(광범위 확장 기업)." }, "home_country_code": { "type": "array", "items": { "type": "string" }, "example": [ "SG" ], "description": "회사의 본국으로 필터링합니다(ISO 3166-1 alpha-2). `froms`와 함께 제공되면 교집합이 적용됩니다." }, "industries": { "$ref": "#/components/schemas/industries" }, "exclude_industries": { "$ref": "#/components/schemas/exclude_industries" }, "select_size": { "type": "integer", "example": 250, "description": "반환할 시장의 최대 개수입니다(플랜별 상한 적용)." }, "flows_size": { "type": "integer", "example": 50, "description": "반환할 국경 간 흐름의 최대 개수입니다(플랜별 상한 적용)." }, "is_include_metadata": { "$ref": "#/components/schemas/expansion_is_include_metadata" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "시장 대시보드 집계 데이터입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object" }, "data": { "type": "object", "description": "대시보드 컨테이너: 순위가 매겨진 시장과 상위 코리도 흐름입니다.", "properties": { "countries": { "type": "array", "description": "시장별 신호 수와 함께 순위가 매겨진 시장입니다.", "items": { "type": "object" } }, "top_flows": { "type": "array", "items": { "type": "object" } } } } } }, "example": { "metadata": { "filters": { "froms": [ "CN" ], "tos": [ "GB" ] }, "select_size": 250, "flows_size": 50, "transitioned_dates": [ "2026-06-01", "2026-06-29" ] }, "data": { "countries": [ { "country_code": "US", "inbound_count": 18, "outbound_count": 5, "total_companies_with_signals": 23, "exploring_count": 8, "committing_count": 10, "expanding_count": 4, "scaling_count": 1, "new_transitions_30d": 3, "pairs_ahead_of_pace_30d": 1, "freshest_transition_at": "2026-06-27T14:32:10.000Z" } ], "top_flows": [ { "home_country_code": "SG", "country_code": "US", "company_count": 5, "new_transitions_30d": 1 } ] } } } } } } } }, "/expansions/search": { "post": { "tags": [ "Expansion" ], "summary": "확장 검색", "description": "하나 이상의 시장으로 확장 중인 회사를 기업·신호 필터 또는 자연어 쿼리로 검색하며, 각 회사의 실제 신호에 기반한 AI 매칭 설명을 선택적으로 생성합니다.", "operationId": "expansions_search", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "froms": { "$ref": "#/components/schemas/expansion_froms" }, "tos": { "$ref": "#/components/schemas/expansion_tos" }, "exclude_froms": { "$ref": "#/components/schemas/expansion_exclude_froms" }, "exclude_tos": { "$ref": "#/components/schemas/expansion_exclude_tos" }, "stages": { "$ref": "#/components/schemas/expansion_stages" }, "momentum": { "$ref": "#/components/schemas/expansion_momentum" }, "freshness": { "$ref": "#/components/schemas/expansion_freshness" }, "scopes": { "$ref": "#/components/schemas/expansion_scopes" }, "ahead_of_pace": { "type": "boolean", "example": false, "description": "해당 시장의 일반적인 속도보다 빠르게 움직이는 쌍으로 제한합니다." }, "signal_types": { "$ref": "#/components/schemas/expansion_signal_type_slugs" }, "signal_strengths": { "$ref": "#/components/schemas/signal_strengths" }, "min_signal_count": { "type": "integer", "example": 3, "description": "해당 기간 동안 회사가 보유해야 하는 최소 확장 신호 수입니다 — \"매우 활발함 / 활동 범위가 넓음\"을 걸러냅니다." }, "only_contraction": { "$ref": "#/components/schemas/only_contraction" }, "min_markets": { "type": "integer", "example": 3, "description": "해당 기간 내에 회사가 진입해야 하는 신규 시장의 최소 개수." }, "home_country_code": { "type": "array", "items": { "type": "string" }, "example": [ "SG" ], "description": "회사의 본국으로 필터링합니다(ISO 3166-1 alpha-2). `froms`와 함께 제공되면 교집합이 적용됩니다." }, "industries": { "$ref": "#/components/schemas/industries" }, "exclude_industries": { "$ref": "#/components/schemas/exclude_industries" }, "verticals": { "$ref": "#/components/schemas/verticals" }, "vertical_categories": { "$ref": "#/components/schemas/vertical_categories" }, "vertical_sub_categories": { "$ref": "#/components/schemas/vertical_sub_categories" }, "technologies": { "$ref": "#/components/schemas/technologies" }, "employees": { "$ref": "#/components/schemas/employees" }, "revenues": { "$ref": "#/components/schemas/revenues" }, "founded_dates": { "$ref": "#/components/schemas/founded_dates" }, "keywords": { "$ref": "#/components/schemas/keywords" }, "companies": { "$ref": "#/components/schemas/expansion_companies" }, "job_locations": { "$ref": "#/components/schemas/locations" }, "job_exclude_locations": { "$ref": "#/components/schemas/job_exclude_locations" }, "job_posted_dates": { "$ref": "#/components/schemas/posted_dates" }, "job_titles": { "$ref": "#/components/schemas/people_titles" }, "advertisement_target_locations": { "$ref": "#/components/schemas/advertisement_target_locations" }, "advertisement_exclude_target_locations": { "$ref": "#/components/schemas/advertisement_exclude_target_locations" }, "advertisement_search_terms": { "$ref": "#/components/schemas/advertisement_search_terms" }, "advertisement_start_dates": { "$ref": "#/components/schemas/advertisement_start_dates" }, "advertisement_end_dates": { "$ref": "#/components/schemas/advertisement_end_dates" }, "news_categories": { "$ref": "#/components/schemas/news_categories" }, "news_published_dates": { "$ref": "#/components/schemas/published_dates" }, "transitioned_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2026-04-01", "2026-06-29" ], "description": "타임라인 윈도우의 ISO 날짜 범위입니다. 기본값은 최근 90일입니다. A natural-language `query` may also set this from calendar phrases (\"this year\", \"last year\", \"Q2 2026\")." }, "window_days": { "$ref": "#/components/schemas/window_days" }, "query": { "type": "string", "example": "fintech companies expanding into the UK", "description": "Pubrio가 확장 및 회사 필터로 해석하는 자연어 쿼리." }, "is_explain_match": { "type": "boolean", "example": true, "description": "각 회사가 검색 조건에 부합하는 이유에 대한 AI 생성 설명을 회사의 실제 신호를 근거로 포함합니다. 자연어 쿼리와 함께 사용하는 것이 가장 좋습니다. 인용되는 신호의 수와 배치 크기는 모두 `per_page`에 따라 달라집니다. 채용 공고, 광고 캠페인처럼 발생 빈도가 높은 소스는 개별적으로 나열하지 않고 해당 기간 동안의 건수로 요약되어 표시됩니다(예: \"12건의 채용 공고\")." }, "sort_by": { "$ref": "#/components/schemas/expansion_sort_by" }, "is_include_metadata": { "$ref": "#/components/schemas/expansion_is_include_metadata" }, "page": { "$ref": "#/components/schemas/page" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "대상 시장에서 확장 중인 회사의 페이지네이션 목록입니다. `filters`는 적용된(또는 자연어로 해석된) 조건을 반영하며, `is_explain_match`가 true이면 각 회사에 `match_summary`가 포함됩니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "description": "검색 메타데이터: 실제 적용된 필터와 시장 롤업(aggregate, 지리 범위, top origins/destinations/industries, timeline). API 키 응답에는 `is_include_metadata`가 true일 때만 롤업이 포함됩니다.", "properties": { "filters": { "type": "object", "description": "실제 적용된 필터(`query` 사용 시 해석된 자연어 쿼리를 반영)." }, "relaxed_filters": { "type": "array", "description": "자연어 쿼리가 아무것도 일치하지 않을 때 자동으로 완화된 소프트 필터. 그 외에는 null.", "items": { "type": "string" } }, "nl_note": { "type": "string", "description": "자연어 쿼리에서 인식 가능한 조건을 찾지 못한 경우의 안내 문구입니다. 이 경우 목록은 비어 있습니다." }, "nl_note_code": { "type": "string", "description": "nl_note의 기계 판독용 코드입니다 (예: expansion.search.no_criteria)." }, "aggregate": { "type": "object", "description": "시장 수준 롤업. 메타데이터 요청 시 포함됩니다." }, "country_code": { "type": "string" }, "country_codes": { "type": "array", "items": { "type": "string" } }, "direction": { "type": "string" }, "is_global": { "type": "boolean" }, "is_multi": { "type": "boolean" }, "transitioned_dates": { "type": "array", "items": { "type": "string" } }, "top_origins": { "type": "array", "items": { "type": "object" } }, "top_destinations": { "type": "array", "items": { "type": "object" } }, "top_industries": { "type": "array", "items": { "type": "object" } }, "timeline": { "type": "array", "items": { "type": "object" } } } }, "data": { "type": "object", "description": "결과 컨테이너(표준 검색 엔벨로프): 회사 목록과 페이지네이션.", "properties": { "pagination": { "type": "object" }, "companies": { "type": "array", "description": "회사 목록. 각 항목은 중첩된 `stage`를 가지며, `is_explain_match`가 true이면 `match_summary`가 포함됩니다. API 키 응답에는 `presence`(`level`: established | emerging | none | no_data, `matched_rule`: office | headcount | share)와 `code`가 scaling | deepening | active | establishing 중 하나인 `read` 객체(판독할 현지 거점이 없으면 null)도 포함됩니다.", "items": { "type": "object" } } } } } }, "example": { "metadata": { "filters": { "tos": [ "GB" ], "verticals": [ "Financial Services" ] } }, "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 87, "total_pages": 4, "total_display_pages": 4, "is_timeout": false }, "companies": [ { "expansion_id": "6845525", "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB", "target_country_code": "GB", "domain": "example.com", "company_name": "Example Corp", "home_country_code": "CN", "industry": "Consumer Electronics", "founded_year": 2015, "employees_count": 320, "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 27, "distinct_type_count": 3, "last_transition_at": "2026-06-27T14:32:10.000Z" }, "presence": { "level": "established", "local_people_count": 12, "matched_rule": "headcount", "has_known_office": true, "established_min": 10, "share_of_detected": 0.54 }, "read": { "code": "establishing" } } ] } } } } } } } }, "/expansions/companies/compare": { "post": { "tags": [ "Expansion" ], "summary": "회사 확장 비교", "description": "여러 회사의 확장 현황을 나란히 비교하며, 대상 회사에 대해 비교 가능한 동종 기업을 선택적으로 추가합니다.", "operationId": "expansions_company_compare", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "companies": { "$ref": "#/components/schemas/expansion_companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "transitioned_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2026-04-01", "2026-06-29" ], "description": "신호/전환 윈도우에 대한 ISO `[from, to]` 날짜 범위입니다. `window_days`가 함께 제공된 경우 이 값이 우선합니다." }, "window_days": { "$ref": "#/components/schemas/window_days" }, "seed_target": { "type": "string", "example": "550e8400-e29b-41d4-a716-446655440002", "description": "대상 회사(domain_search_id)입니다. 제공하면 응답이 해당 회사에 가장 비교 가능한 피어를 시드합니다." }, "is_include_established": { "$ref": "#/components/schemas/expansion_is_include_established" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "domain_search_id를 키로 하는 회사별 비교 데이터입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "seeded_peers": { "type": "array", "items": { "type": "string" } } } }, "data": { "type": "object", "properties": { "companies": { "type": "array", "items": { "type": "object" } } } } } }, "example": { "metadata": { "seeded_peers": [ "550e8400-e29b-41d4-a716-446655440002" ] }, "data": { "companies": [ { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "home_country_code": "SG", "firmographics": { "company_name": "Example Corp", "country_code": "SG", "company_size": 350, "founded_year": 2015, "industry": "Software Development", "publicly_traded_symbol": null, "estimated_revenue": 25000000 }, "markets_summary": [ { "country_code": "US", "stage_slug": "committing", "signal_count": 12, "distinct_type_count": 4, "first_signal_at": "2026-04-02T08:00:00.000Z", "latest_signal_at": "2026-06-28T10:15:22.000Z", "last_transition_at": "2026-06-25T14:30:00.000Z", "expansion_score": 0.685, "signals": [ { "signal_type_slug": "EXEC", "signal_subtype_slug": "country_manager", "event_date": "2026-06-20T14:00:00.000Z", "display_label": "Hired Regional VP for North America" } ] } ] } ] } } } } } } } }, "/expansions/companies/summaries": { "post": { "tags": [ "Expansion" ], "summary": "회사 확장 요약 일괄 조회", "description": "여러 회사에 대해 바로 렌더링할 수 있는 확장 요약을 제공하며, 클라이언트 측 집계 없이 나란히 비교할 수 있습니다.", "operationId": "expansions_company_summaries", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "companies": { "$ref": "#/components/schemas/expansion_companies" }, "domains": { "$ref": "#/components/schemas/domains" }, "linkedin_urls": { "$ref": "#/components/schemas/company_linkedin_urls" }, "transitioned_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2026-04-01", "2026-06-29" ], "description": "신호/전환 윈도우에 대한 ISO `[from, to]` 날짜 범위입니다. `window_days`가 함께 제공된 경우 이 값이 우선합니다." }, "window_days": { "$ref": "#/components/schemas/window_days" }, "is_include_established": { "$ref": "#/components/schemas/expansion_is_include_established" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "description": "단일 `companies` 배열로 회사를 지정합니다. `domain_search_id`, 회사 도메인, LinkedIn URL을 혼합해 전달할 수 있으며 일치 결과는 합집합입니다(교집합 아님). 하위 호환성을 위해 기존 `domain_search_ids`, `domains`, `linkedin_urls` 키도 계속 지원됩니다. 요청당 최대 25개 회사까지 해석됩니다." } } } }, "responses": { "200": { "description": "회사별 확장 요약 배열입니다. 두 가지 점수를 제공합니다. 최상위 `expansion_score`는 모든 시장에 대한 전체 현재 상태(안정적)이고, `summary.window_expansion_score`는 선택한 기간으로 한정한 동일 지표입니다. 여기서는 둘 다 0~100 스케일입니다(검색 결과의 0~1 `stage.expansion_score`와 다름). 플랜에 직원 수가 포함되지 않은 경우 `firmographics`는 `company_size`, `employees_count`, `company_size_printed`를 null로 반환하고 `is_employees_locked: true`를 설정합니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object" }, "data": { "type": "object", "properties": { "companies": { "type": "array", "items": { "type": "object" } } } } } }, "example": { "metadata": {}, "data": { "companies": [ { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "home_country_code": "SG", "expansion_score": 82, "firmographics": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "company_name": "Example Corp", "domain": "example.com", "logo_url": "https://logo.pubrio.com/example.com.png", "country_code": "SG", "company_size": null, "employees_count": 350, "company_size_printed": "351+", "is_employees_locked": false, "founded_year": 2015, "industry": "Software Development", "publicly_traded_symbol": null, "estimated_revenue": 25000000 }, "markets_summary": [ { "country_code": "US", "stage_slug": "committing", "signal_count": 12, "distinct_type_count": 4, "first_signal_at": "2026-04-02T08:00:00.000Z", "latest_signal_at": "2026-06-28T10:15:22.000Z", "last_transition_at": "2026-06-25T14:30:00.000Z", "expansion_score": 0.685, "signals": [ { "signal_type_slug": "EXEC", "signal_subtype_slug": "country_manager", "event_date": "2026-06-20T14:00:00.000Z", "display_label": "Hired Regional VP for North America" } ] } ], "signal_weekly_totals": [ { "week_start": "2026-06-22", "signal_type_slug": "HIRE", "count": 5 } ], "summary": { "active_markets": 1, "total_markets": 1, "new_markets": 1, "momentum_pct": 22, "signal_count": 12, "window_expansion_score": 69, "scaling": 0, "pipeline": 1, "top_market": { "country_code": "US", "country": null, "stage": "committing" }, "newest_market": { "country_code": "US", "country": null, "stage": "committing" }, "activity_weekly": [ 3, 5, 4 ] } } ] } } } } } } } }, "/expansions/companies/lookup": { "post": { "tags": [ "Expansion" ], "summary": "회사 확장 상세", "description": "단일 회사의 심층 확장 프로파일(현재 단계, 신호, 시장 내 활동, 단계 전환 이력)로, 단일 시장 또는 전체 시장 통합 기준으로 조회합니다.", "operationId": "expansions_company_lookup", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "country_code": { "$ref": "#/components/schemas/expansion_country_code" }, "is_all_markets": { "$ref": "#/components/schemas/expansion_is_all_markets" }, "signal_type": { "type": "string", "enum": [ "AD", "NEWS", "DNS", "INFRA", "PARTNER", "EVENT_PLUS", "EXEC", "OFFICE", "HIRE", "SCALE", "PRODUCT" ], "example": "EXEC", "description": "반환되는 신호를 단일 유형으로 필터링합니다." }, "query": { "type": "string", "example": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.", "description": "판매하는 제품이나 이 회사를 평가하는 기준이 되는 이상적인 구매자 프로필을 자연어로 설명합니다. AI `summary`의 근거로만 사용되며(`is_explain_match` 참고), 회사 검색과 달리 여기서는 필터 조건으로 해석되지 않습니다." }, "is_explain_match": { "type": "boolean", "example": true, "description": "true이고 `query`가 제공되면, `summary`는 현재 범위(선택한 시장, 또는 `is_all_markets`가 true일 때 모든 해외 시장)에서 이 회사의 확장 활동을 당신의 `query`에 비추어 하나의 AI 요약으로 반환합니다. 회사의 실제 시그널에 근거하며 `[n]` 인용을 포함합니다." }, "window_days": { "type": "integer", "example": 90, "default": 90, "description": "선택 사항. AI `summary` 피드를 제한하는 롤링 윈도우(일). 본 파라미터와 `transitioned_dates`를 모두 생략하면 기본값 **90**. 페이지네이션된 `signals` 목록(전체 이력)에는 영향을 주지 않습니다." }, "transitioned_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2026-04-01", "2026-06-29" ], "description": "신호/전환 윈도우에 대한 ISO `[from, to]` 날짜 범위입니다. `window_days`가 함께 제공된 경우 이 값이 우선합니다." }, "domain": { "$ref": "#/components/schemas/domain" }, "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "is_include_established": { "$ref": "#/components/schemas/expansion_is_include_established" }, "page": { "$ref": "#/components/schemas/page" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "Domain Search ID", "required": [ "domain_search_id" ] }, { "title": "도메인", "required": [ "domain" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] } ] } } } }, "responses": { "200": { "description": "특정 시장 내 회사 상세 정보입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object" }, "data": {} } }, "example": { "metadata": { "filters": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "US" }, "country_code_auto_picked": false, "pagination": { "page": 1, "per_page": 25, "total_entries": 12, "total_pages": 1, "total_display_pages": 1, "is_timeout": false } }, "data": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "US", "country_name": "United States", "stage_rank": 3, "stage_name": "Expanding", "stage": { "slug": "expanding", "expansion_score": 0.721, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 5, "first_signal_at": "2026-05-30T09:00:00.000Z", "latest_signal_at": "2026-06-20T14:00:00.000Z", "last_transition_at": "2026-06-15T09:30:00.000Z" } }, "signals": [ { "signal_type_slug": "EXEC", "signal_subtype_slug": "country_manager", "signal_strength_slug": "high", "polarity": "expansion", "event_date": "2026-06-20T14:00:00.000Z", "source_type": "linkedin", "display_label": "Hired Regional VP for North America", "evidence_url": "https://linkedin.com/company/example-corp", "source_published_at": "2026-06-20T14:00:00.000Z", "lead_time_days": 0 } ], "presence": [ { "presence_type": "office", "presence_strength": "high", "address": "123 Market St, San Francisco, CA", "known_since": "2026-03-15T00:00:00.000Z" } ], "timeline": [ { "stage_slug": "expanding", "transitioned_at": "2026-06-15T09:30:00.000Z", "transition_kind": "advance" } ], "other_markets": [ { "country_code": "CA", "stage_slug": "committing", "signal_count": 8, "first_signal_at": "2026-04-10T00:00:00.000Z", "latest_signal_at": "2026-06-22T16:45:00.000Z", "last_transition_at": "2026-06-18T00:00:00.000Z" } ] } } } } } } }, "/expansions/companies/pulse_events": { "post": { "tags": [ "Expansion" ], "summary": "회사 신호 이벤트", "description": "단일 회사에 대해 확장을 이끄는 신호 이벤트를 보강된 형태로 페이지네이션하여 심층 조회합니다.", "operationId": "expansions_company_pulse_events", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "signal_types": { "$ref": "#/components/schemas/expansion_signal_type_slugs" }, "country_codes": { "type": "array", "items": { "type": "string" }, "example": [ "JP", "SG" ], "description": "선택 사항. 피드를 하나 이상의 해외 시장(ISO 3166-1 alpha-2, 예: `[\"JP\",\"SG\"]`)으로 좁힙니다. 생략하면 모든 해외 시장이 대상입니다(본국 시장은 항상 제외)." }, "transitioned_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2026-04-01", "2026-06-29" ], "description": "신호/전환 윈도우에 대한 ISO `[from, to]` 날짜 범위입니다. `window_days`가 함께 제공된 경우 이 값이 우선합니다." }, "window_days": { "type": "integer", "example": 90, "default": 90, "description": "선택 사항. 이벤트 롤링 윈도우의 일수입니다. 본 파라미터와 `transitioned_dates` 를 모두 생략하면 기본값으로 **90** 일(표준 표시 윈도우)이 사용됩니다. 둘 다 제공하면 `transitioned_dates` 가 우선합니다." }, "query": { "type": "string", "example": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.", "description": "판매하는 제품이나 이 회사를 평가하는 기준이 되는 이상적인 구매자 프로필을 자연어로 설명합니다. AI `summary`의 근거로만 사용되며(`is_explain_match` 참고), 회사 검색과 달리 여기서는 필터 조건으로 해석되지 않습니다." }, "is_explain_match": { "type": "boolean", "example": true, "description": "true이고 `query`가 제공되면 `data.summary`에 이 회사의 확장 활동을 `query`에 비추어 해석한 단일 AI 요약이 반환됩니다. 회사의 실제 시그널을 근거로 `[n]` 인용이 포함됩니다. 회사 검색의 회사별 `match_summary`와 달리, 이 요약은 해당 기간의 회사 전체 시그널(모든 시장, 모든 시그널)을 바탕으로 생성되므로 `page` / `per_page`와 무관하게 일관됩니다." }, "domain": { "$ref": "#/components/schemas/domain" }, "linkedin_url": { "$ref": "#/components/schemas/company_linkedin_url" }, "domain_search_id": { "$ref": "#/components/schemas/domain_search_id" }, "page": { "$ref": "#/components/schemas/page" }, "per_page": { "$ref": "#/components/schemas/per_page" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } }, "anyOf": [ { "title": "Domain Search ID", "required": [ "domain_search_id" ] }, { "title": "도메인", "required": [ "domain" ] }, { "title": "LinkedIn URL", "required": [ "linkedin_url" ] } ] } } } }, "responses": { "200": { "description": "페이지네이션된 신호 이벤트입니다. `is_explain_match`가 true이고 `query`가 제공되면 `data.summary`에 회사 전체 시그널을 쿼리에 비추어 생성한 AI 요약(`{ text, citations }`)이 담기며, 그렇지 않으면 `null`입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object" }, "data": {} } }, "example": { "metadata": { "filters": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002" } }, "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 42, "total_pages": 2, "total_display_pages": 2, "is_timeout": false }, "events": [ { "signal_type_slug": "EXEC", "stage_slug": "expanding", "country_code": "US", "signal_subtype_slug": "country_manager", "source_type": "linkedin", "polarity": "expansion", "display_label": "Hired Country Manager", "evidence_url": "https://linkedin.com/company/example-corp", "event_date": "2026-06-20T14:00:00.000Z" } ], "summary": { "text": "Example Corp is hiring across Tokyo[1] and just added a Japan Country Manager[2], yet has no legal entity on file — it is staffing the market before incorporating, which is exactly your window.", "citations": [ { "n": 1, "type": "HIRE", "label": "Tokyo software & field-ops roles", "country": "JP", "date": "2026-06", "url": null }, { "n": 2, "type": "EXEC", "label": "Country Manager, Japan", "country": "JP", "date": "2026-06", "url": "https://linkedin.com/in/example" } ] } } } } } } } } }, "/expansions/companies/rankings": { "post": { "tags": [ "Expansion" ], "summary": "확장 순위", "description": "확장 점수 기준으로 정렬된 회사/시장 쌍의 경량 순위 목록 — 지도나 히트맵 렌더링에 적합합니다.", "operationId": "expansions_company_rankings", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "froms": { "$ref": "#/components/schemas/expansion_froms" }, "tos": { "$ref": "#/components/schemas/expansion_tos" }, "exclude_froms": { "$ref": "#/components/schemas/expansion_exclude_froms" }, "exclude_tos": { "$ref": "#/components/schemas/expansion_exclude_tos" }, "stages": { "$ref": "#/components/schemas/expansion_stages" }, "signal_types": { "$ref": "#/components/schemas/expansion_signal_type_slugs" }, "signal_strengths": { "$ref": "#/components/schemas/signal_strengths" }, "min_signal_count": { "type": "integer", "example": 3, "description": "해당 기간 동안 회사가 보유해야 하는 최소 확장 신호 수입니다 — \"매우 활발함 / 활동 범위가 넓음\"을 걸러냅니다." }, "only_contraction": { "$ref": "#/components/schemas/only_contraction" }, "domain_search_id_list": { "$ref": "#/components/schemas/expansion_domain_search_ids" }, "verticals": { "$ref": "#/components/schemas/verticals" }, "vertical_categories": { "$ref": "#/components/schemas/vertical_categories" }, "vertical_sub_categories": { "$ref": "#/components/schemas/vertical_sub_categories" }, "technologies": { "$ref": "#/components/schemas/technologies" }, "employees": { "$ref": "#/components/schemas/employees" }, "revenues": { "$ref": "#/components/schemas/revenues" }, "founded_dates": { "$ref": "#/components/schemas/founded_dates" }, "keywords": { "$ref": "#/components/schemas/keywords" }, "companies": { "$ref": "#/components/schemas/expansion_companies" }, "job_locations": { "$ref": "#/components/schemas/locations" }, "job_exclude_locations": { "$ref": "#/components/schemas/job_exclude_locations" }, "job_posted_dates": { "$ref": "#/components/schemas/posted_dates" }, "job_titles": { "$ref": "#/components/schemas/people_titles" }, "advertisement_target_locations": { "$ref": "#/components/schemas/advertisement_target_locations" }, "advertisement_exclude_target_locations": { "$ref": "#/components/schemas/advertisement_exclude_target_locations" }, "advertisement_search_terms": { "$ref": "#/components/schemas/advertisement_search_terms" }, "advertisement_start_dates": { "$ref": "#/components/schemas/advertisement_start_dates" }, "advertisement_end_dates": { "$ref": "#/components/schemas/advertisement_end_dates" }, "news_categories": { "$ref": "#/components/schemas/news_categories" }, "news_published_dates": { "$ref": "#/components/schemas/published_dates" }, "is_include_established": { "$ref": "#/components/schemas/expansion_is_include_established" }, "select_size": { "$ref": "#/components/schemas/expansion_select_size" }, "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "순위가 매겨진 회사/시장 마커입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object" }, "data": {} } }, "example": { "metadata": { "filters": { "froms": [ "CN" ], "tos": [ "GB" ] }, "select_size": 250, "count": 1 }, "data": { "markers": [ { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "US", "stage_slug": "expanding", "expansion_score": 0.721, "freshness": "fresh", "direction": "advancing" } ] } } } } } } } }, "/expansions/types": { "post": { "tags": [ "Expansion" ], "summary": "확장 필터", "description": "확장 분류 체계 참조 카탈로그 — 단계, 신호 유형, 강도, 극성, 모멘텀, 신선도 — 다른 확장 엔드포인트가 반환하는 값을 해석하는 데 사용합니다.", "operationId": "expansions_types", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_id": { "$ref": "#/components/schemas/profile_id" } } } } } }, "responses": { "200": { "description": "Expansion 택소노미입니다.", "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object" }, "data": {} } }, "example": { "data": { "stages": [ { "slug": "exploring", "rank_order": 1, "name": { "en": "Exploring" } }, { "slug": "scaling", "rank_order": 4, "name": { "en": "Scaling" } } ], "signal_types": [ { "slug": "HIRE", "name": { "en": "Hiring" }, "tier": "standard", "is_available": true }, { "slug": "INFRA", "name": { "en": "Infrastructure" }, "tier": "premier", "is_available": true } ], "signal_strengths": [ { "slug": "low", "name": { "en": "Low" } }, { "slug": "very_high", "name": { "en": "Very High" } } ], "polarities": [ "expansion", "contraction_leading", "contraction_confirming", "contraction_lagging" ], "directions": [ "advancing", "steady", "retreating", "new" ], "freshness": [ "fresh", "cooling", "stale", "cold" ] } } } } } } } } }, "externalDocs": { "description": "Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다.", "url": "https://docs.pubrio.com" }, "components": { "schemas": { "is_default": { "type": "boolean", "description": "활성화되면 실행 시 현재 레코드가 true로 설정되고, 연결된 다른 모든 관련 레코드 그룹은 false로 설정됩니다." }, "channel_template_id": { "type": "string", "format": "uuid", "description": "채널 템플릿 작업의 고유 식별자." }, "channel_template_parameters": { "type": "object", "description": "매개변수 정보는 채널 노드의 요구 사항에 따라 다릅니다." }, "version_name": { "type": "string", "example": "default", "description": "버전 이름은 변경 이력을 식별하는 방법을 제공합니다." }, "channel_node_id": { "type": "string", "format": "uuid", "description": "채널 노드 작업의 고유 식별자." }, "is_entire_templates": { "type": "boolean", "description": "활성화되면 실행이 채널 템플릿 내 전체 버전에 적용됩니다." }, "channel_templates": { "type": "array", "items": { "type": "integer" }, "example": [ 1, 2 ], "description": "특정 채널 템플릿을 검색하기 위한 `channel_template_id` 목록." }, "channel_nodes": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "특정 채널 노드를 검색하기 위한 `channel_node_id` 목록." }, "channel_template_name": { "type": "string", "example": "channel template", "description": "검색 결과를 특정 채널 템플릿 이름으로 필터링합니다." }, "channel_types": { "type": "array", "items": { "type": "integer" }, "example": [ 1, 2 ], "description": "특정 채널 유형을 검색하기 위한 `channel_type_id` 목록." }, "channel_template_identifier": { "type": "string", "format": "uuid", "description": "채널 템플릿 버전 그룹의 식별자." }, "domain_search_id": { "type": "string", "format": "uuid", "description": "회사 조회 작업의 고유 식별자." }, "domain_id": { "type": "integer", "description": "도메인 조회 작업의 고유 식별자." }, "job_search_id": { "type": "string", "format": "uuid", "example": "371d0c44-4c56-4c9c-98e2-ef6dd986b848", "description": "회사 채용 조회 작업의 고유 식별자." }, "news_search_id": { "type": "string", "format": "uuid", "example": "4110b929-17cd-42aa-a159-906ead0c9b56", "description": "회사 뉴스 조회 작업의 고유 식별자." }, "people_search_id": { "type": "string", "format": "uuid", "description": "인물 조회 작업의 고유 식별자." }, "redeem_query_id": { "type": "string", "format": "uuid", "description": "대량 교환 요청 시 반환되는 `redeem_query_id`. 결과를 조회하는 데 사용할 수 있습니다." }, "peoples": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "사용자 조회 작업을 위한 고유 식별자(people_search_id) 목록." }, "companies": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록." }, "domain": { "type": "string", "example": "pubrio.com", "description": "회사 조회 작업에 사용되는 회사 도메인입니다. 입력된 주소가 `www.pubrio.com` 또는 `https://docs.pubrio.com/`인 경우, 시스템은 이를 자동으로 `pubrio.com`으로 변환하여 처리합니다." }, "domains": { "type": "array", "items": { "type": "string" }, "example": [ "pubrio.com" ], "description": "회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 `www.pubrio.com` 또는 `https://docs.pubrio.com/`인 경우, 시스템은 이를 자동으로 `pubrio.com`으로 변환하여 처리합니다." }, "people_contact_types": { "type": "array", "items": { "type": "string", "enum": [ "email-personal", "email-work", "phone" ] }, "example": [ "email-personal", "email-work", "phone" ], "description": "조회할 연락처 유형을 지정하는 매개변수입니다. 업무용 이메일, 개인 이메일, 전화번호 등 하나 이상을 입력할 수 있습니다." }, "contact_lookup_email": { "type": "string", "format": "email", "example": "person@example.com", "description": "조회할 업무용 또는 개인 이메일 주소. 시스템은 매칭 전 대소문자와 공백을 정규화합니다." }, "contact_lookup_phone": { "type": "string", "example": "+15551234567", "description": "조회할 전화번호. 국제 형식(E.164)을 권장합니다." }, "contact_lookup_first_name": { "type": "string", "example": "King", "description": "이름. `is_enable_similarity_search` 가 `true` 일 때 `last_name` 및 `domain` 또는 `company` 와 함께 사용합니다." }, "contact_lookup_last_name": { "type": "string", "example": "Lai", "description": "성. `is_enable_similarity_search` 가 `true` 일 때 `first_name` 및 `domain` 또는 `company` 와 함께 사용합니다." }, "contact_lookup_company": { "type": "string", "example": "Pubrio", "description": "회사명. `is_enable_similarity_search` 가 `true` 이고 `domain` 이 제공되지 않은 경우 `first_name` + `last_name` 과 함께 유사도 검색의 기준점으로 사용됩니다." }, "contact_lookup_domain": { "type": "string", "example": "pubrio.com", "description": "회사 도메인. `is_enable_similarity_search` 가 `true` 일 때 `first_name` + `last_name` 과 함께 유사도 검색의 기준점으로 사용됩니다." }, "contact_lookup_is_enable_similarity_search": { "type": "boolean", "default": false, "example": true, "description": "`true` 인 경우 정확한 이메일/전화번호 일치가 없으면 이름 기반 유사도 매칭으로 폴백합니다. `first_name`, `last_name`, 그리고 `domain` 또는 `company` 가 필요합니다." }, "contact_lookup_peoples": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "phone": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "company": { "type": "string" }, "domain": { "type": "string" } } }, "example": [ { "email": "king.lai@pubrio.com" }, { "first_name": "John", "last_name": "Smith", "domain": "example.com" } ], "description": "조회 명세 배열. 각 항목은 단일 조회 본문과 동일한 식별자(`email`, `phone`, 또는 유사도 검색이 활성화된 경우 `first_name` + `last_name` + `domain`/`company`)를 허용합니다. 구독의 일괄 처리 크기 제한이 적용됩니다." }, "advertisement_source_types": { "type": "array", "items": { "type": "string", "enum": [ "linkedin", "facebook", "google" ] }, "example": [ "linkedin", "facebook" ], "description": "실시간 보강에 사용할 광고 소스 유형을 제한합니다. 생략하면 모든 소스가 기본값으로 사용됩니다. 실시간 보강이 실제로 실행될 때에만 적용됩니다 — 즉, `is_realtime_enrichment` 또는 `enrichment_mode: latest` 가 설정된 경우입니다." }, "advertisement_enrichment_mode": { "type": "string", "enum": [ "default", "latest" ], "default": "default", "example": "latest", "description": "실시간 보강 동작을 제어합니다. `default` 는 데이터베이스에 이미 있는 데이터를 반환하며, 결과가 비어 있고 `is_realtime_enrichment` 가 설정된 경우에만 보강을 트리거합니다. `latest` 는 캐시를 우회하고 호출마다 최신 소스 레코드를 기준으로 재보강을 강제합니다 — 다른 플래그 없이도 `latest` 자체가 보강을 트리거합니다." }, "is_realtime_enrichment": { "type": "boolean", "default": false, "example": true, "description": "단일 회사 범위 쿼리(즉, `domain_search_id`, `domains`, 또는 `linkedin_urls` 로 필터링됨)에서 실시간 보강을 활성화합니다. 초기 검색 결과가 0건일 때 엔드포인트가 소스를 스크랩해 레코드를 저장한 뒤 검색을 다시 실행하고 응답합니다. 라우트별 데드라인이 적용됩니다." }, "people_titles": { "type": "array", "items": { "type": "string" }, "example": [ "sales manager", "marketing manager" ], "description": "검색 대상 인물의 직함입니다.\n\n`software engineer`를 검색하면 `senior software engineer`와 같이 유사한 용어를 포함한 결과도 반환될 수 있습니다." }, "management_levels": { "type": "array", "items": { "type": "string" }, "example": [ "head" ], "description": "현재 조직에서 인물의 관리 직급을 나타냅니다. 특정 보고 계층(예: C레벨 또는 시니어)을 대상으로 필터링할 때 사용합니다.\n\n자세한 내용은 필터 탭의 `management level` 엔드포인트를 참조하세요." }, "departments": { "type": "array", "items": { "type": "string" }, "example": [ "master_human_resources" ], "description": "특정 전문 분야의 인물을 검색하기 위한 부서 필드입니다.\n\n자세한 내용은 필터 탭의 `department` 엔드포인트를 참조하세요." }, "functions": { "type": "array", "items": { "type": "string" }, "example": [ "human_resources" ], "description": "직무 기능 필드는 특정 직책이나 전문 분야를 지정해 인물을 검색할 때 사용합니다.\n\n자세한 내용은 필터 탭의 `department functions` 엔드포인트를 참조하세요." }, "locations": { "type": "array", "items": { "type": "string" }, "example": [ "US", "SG", "CN" ], "description": "ISO 3166-1 alpha-2(cca2) 코드로 지역을 필터링하는 데 사용됩니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참조하세요." }, "exclude_locations": { "type": "array", "items": { "type": "string" }, "example": [ "CN", "US", "RU", "CA" ], "description": "반환하지 않을 지역을 ISO 3166-1 alpha-2(cca2) 코드로 지정합니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참조하세요." }, "founded_dates": { "type": "array", "items": { "type": "integer" }, "example": [ 2018, 2024 ], "description": "회사의 설립 연도 범위입니다. 최대값은 현재 연도입니다." }, "posted_dates": { "type": "array", "items": { "type": "string" }, "example": [ "2025-01-01", "2025-01-10" ], "description": "게시 날짜 범위입니다. 최대값은 오늘 날짜입니다." }, "published_dates": { "type": "array", "items": { "type": "string" }, "example": [ "2025-01-01", "2025-01-10" ], "description": "발행 날짜 범위입니다. 최대값은 오늘 날짜입니다." }, "employees": { "type": "array", "items": { "type": "array", "items": { "type": "string" } }, "example": [ [ 1, 10 ], [ 11, 20 ], [ 10001 ] ], "description": "회사 직원 수 범위입니다. 총 직원 수를 기준으로 회사를 필터링할 수 있으며, 여러 범위를 추가해 검색 결과를 확장할 수 있습니다.\n\n자세한 내용은 필터 탭의 `company size` 엔드포인트를 참조하세요." }, "revenues": { "type": "array", "items": { "type": "integer" }, "example": [ 0, 100000 ], "description": "회사의 최소 및 최대 수익 범위입니다." }, "company_locations": { "type": "array", "items": { "type": "string" }, "example": [ "US", "SG", "CN" ], "description": "회사 본사 위치입니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참고하세요." }, "people_locations": { "type": "array", "items": { "type": "string" }, "example": [ "US", "SG", "CN" ], "description": "사용자 위치입니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참고하세요." }, "keyword": { "type": "string", "description": "키워드를 통해 항목을 검색합니다. 전체 항목이 아니라 상위 몇 개만 가져오려면 비워둘 수 있습니다." }, "technologies": { "type": "array", "items": { "type": "integer" }, "description": "`tag_id` 목록으로, 특정 기술을 사용하는 회사를 검색하는 데 사용됩니다. ID를 얻으려면 필터 탭의 `technology` 엔드포인트를 호출하세요.\n\n이 필터는 `is_enable_similarity_search`를 지원하며, 활성화 시 `[\"Shopify\"]`와 같은 자유 텍스트 입력이 가능합니다." }, "categories": { "type": "array", "items": { "type": "integer" }, "description": "`category_id` 목록으로, 특정 기술 카테고리를 사용하는 회사를 검색합니다. ID를 얻으려면 필터 탭의 `category` 엔드포인트를 호출하세요.\n\n이 필터는 `is_enable_similarity_search`를 지원하며, 활성화 시 `[\"CDN\"]`처럼 자유 텍스트를 입력할 수 있습니다." }, "news_gallery_ids": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "`news_gallery_id` 목록으로, 특정 뉴스 갤러리를 검색할 때 사용됩니다. ID를 얻으려면 필터 탭의 `news galleries` 엔드포인트를 호출하세요." }, "news_categories": { "type": "array", "items": { "type": "string" }, "example": [ "launches" ], "description": "`category slugs` 목록으로, 특정 뉴스 카테고리를 검색합니다. slug를 얻으려면 필터 탭의 `news categories` 엔드포인트를 호출하세요." }, "verticals": { "type": "array", "items": { "type": "integer" }, "description": "`vertical_id` 목록으로, 특정 산업 또는 분야의 회사를 검색합니다. ID를 얻으려면 필터 탭의 `vertical` 엔드포인트를 호출하세요.\n\n이 필터는 `is_enable_similarity_search`를 지원하며, `[\"AI\"]`와 같은 자유 텍스트 검색이 가능합니다." }, "vertical_categories": { "type": "array", "items": { "type": "integer" }, "description": "`vertical_category_id` 목록으로, 특정 산업 카테고리에 속한 회사를 검색합니다. ID를 얻으려면 필터 탭의 `vertical category` 엔드포인트를 호출하세요.\n\n이 필터는 `is_enable_similarity_search`를 지원하며 `[\"Information Technology\"]`와 같은 텍스트 입력이 가능합니다." }, "vertical_sub_categories": { "type": "array", "items": { "type": "integer" }, "description": "`vertical_sub_category_id` 목록으로, 특정 산업 하위 카테고리에 속한 회사를 검색합니다. ID를 얻으려면 필터 탭의 `vertical sub category` 엔드포인트를 호출하세요.\n\n이 필터는 `is_enable_similarity_search`를 지원하며 `[\"Software\"]`와 같은 자유 텍스트 검색이 가능합니다." }, "company_name": { "type": "string", "example": "pubrio", "description": "검색 결과를 지정된 회사 이름으로 필터링합니다.\n\n입력값이 회사명과 일치하지 않으면, 다른 조건이 맞더라도 결과에 표시되지 않습니다. 부분 일치를 지원합니다." }, "search_term": { "type": "string", "example": "pubrio", "description": "결과를 필터링하기 위한 키워드 문자열입니다." }, "search_terms": { "type": "array", "items": { "type": "string" }, "example": [ "pubrio" ], "description": "검색 결과를 필터링하는 키워드 문자열 목록입니다." }, "target_locations": { "type": "array", "items": { "type": "string" }, "example": [ "TW", "AE", "NO" ], "description": "국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 필터링합니다. 특정 국가에서 표시되는 광고를 찾는 데 사용합니다. `filter_conditions`와 함께 OR 연산자를 사용합니다 - 광고는 지정된 위치 중 최소 하나를 타겟팅해야 합니다." }, "exclude_target_locations": { "type": "array", "items": { "type": "string" }, "example": [ "IS", "GB", "FR", "IE", "ES" ], "description": "국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 제외합니다. 특정 국가에서 표시되는 광고를 필터링하여 제외합니다. `filter_conditions`에서 'or' 연산자와 함께 지정된 경우, 광고는 제외된 위치 중 어느 곳도 타겟팅하지 않아야 합니다." }, "headlines": { "type": "array", "items": { "type": "string" }, "example": [ "ASUS", "iPhone" ], "description": "검색 결과를 필터링하는 제목 목록입니다." }, "ads_filter_conditions": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "enum": [ "target_locations", "exclude_target_locations" ], "example": "exclude_target_locations", "description": "연산자를 적용할 필터 키를 지정합니다." }, "operator": { "type": "string", "enum": [ "or", "and" ], "example": "or", "description": "적용할 논리 연산자입니다. 'or'을 사용하여 지정된 위치 중 어느 곳도 제외하지 않는 광고를 매치시키거나, 'and'를 사용하여 지정된 모든 위치를 제외하는 광고를 매치시킵니다." } } }, "description": "광고 검색의 고급 필터링 옵션입니다. 광고 검색 엔드포인트의 검색 결과를 개선하기 위한 조건을 지정합니다." }, "start_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2025-12-01", "2025-12-01" ], "description": "검색 결과를 필터링하는 시작 날짜 목록입니다." }, "end_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2025-12-25", "2025-12-25" ], "description": "검색 결과를 필터링하는 종료 날짜 목록입니다." }, "advertisement_search_id": { "type": "string", "format": "uuid", "example": "a92643e8-9033-4029-aa65-ef929327cebb", "description": "광고 검색 결과의 고유 식별자입니다. 광고 검색 엔드포인트에서 반환된 특정 광고를 참조하는 데 사용됩니다." }, "keywords": { "type": "array", "items": { "type": "string" }, "example": [ "ecommerce", "ai", "fintech" ], "description": "회사 검색 결과를 관련성, 전문 분야 또는 설명으로 필터링하기 위한 키워드 목록입니다." }, "advertisement_target_locations": { "$ref": "#/components/schemas/target_locations", "description": "광고의 대상 지리적 위치." }, "advertisement_exclude_target_locations": { "$ref": "#/components/schemas/exclude_target_locations", "description": "광고 타겟팅에서 제외할 지리적 위치." }, "advertisement_search_terms": { "type": "array", "items": { "type": "string" }, "example": [ "asus" ], "description": "광고 콘텐츠 또는 제목 내에서 검색하는 데 사용되는 키워드입니다." }, "advertisement_start_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2025-12-25", "2025-12-25" ], "description": "광고 필터링을 위한 시작 날짜 범위입니다." }, "advertisement_end_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2025-12-25", "2025-12-25" ], "description": "광고 필터링을 위한 종료 날짜 범위입니다." }, "places": { "type": "array", "items": { "type": "string" }, "example": [ "Tokyo" ], "description": "결과를 필터링하는 데 사용되는 장소 이름(도시, 지역)입니다. 현지화되거나 영어 장소 이름을 허용합니다." }, "exclude_places": { "type": "array", "items": { "type": "string" }, "example": [ "Tokyo" ], "description": "결과에서 제외할 장소 이름(도시, 지역)입니다. 현지화되거나 영어 장소 이름을 허용합니다." }, "job_exclude_locations": { "$ref": "#/components/schemas/exclude_locations", "description": "채용 공고 결과에서 제외할 지리적 위치." }, "exclude_fields": { "type": "array", "items": { "type": "string" }, "example": [ "emails", "phones", "contacts" ], "description": "응답 페이로드에서 제외할 필드 목록입니다." }, "is_company_filter_any_mode": { "type": "boolean", "description": "true인 경우 회사 수준 필터 조건이 AND가 아닌 OR로 처리됩니다." }, "is_parameter_metadata_available": { "type": "boolean", "description": "요청에 매개변수 메타데이터가 사용 가능한지 여부를 나타냅니다." }, "is_profile_metadata_available": { "type": "boolean", "description": "요청에 프로필 메타데이터가 사용 가능한지 여부를 나타냅니다." }, "company_filter_conditions": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "enum": [ "keywords", "verticals", "vertical_categories", "vertical_sub_categories", "technologies", "categories", "advertisement_target_locations", "advertisement_exclude_target_locations", "advertisement_search_terms", "places", "exclude_places", "job_exclude_locations" ], "example": "keywords", "description": "적용할 연산자의 필터 키를 지정합니다." }, "operator": { "type": "string", "enum": [ "or", "and" ], "example": "or", "description": "적용할 논리 연산자입니다. 지정된 값 중 하나와 일치하려면 'or'를, 모든 값과 일치하려면 'and'를 사용합니다." } } }, "description": "회사 검색을 위한 고급 필터링 옵션입니다. 키와 논리 연산자를 결합한 조건을 지정하여 검색 결과를 세분화하세요." }, "people_filter_conditions": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "enum": [ "keywords", "verticals", "vertical_categories", "vertical_sub_categories", "technologies", "categories", "places", "exclude_places", "social_media" ], "example": "technologies", "description": "연산자를 적용할 필터 키. 통합 회사 필터 이름을 참조합니다(`company_places` 가 아니라 `places` 를 사용)." }, "operator": { "type": "string", "enum": [ "or", "and" ], "example": "and", "description": "적용할 논리 연산자입니다. 지정된 값 중 하나와 일치하려면 'or'를, 모든 값과 일치하려면 'and'를 사용합니다." } } }, "description": "/people/search 의 필터에 대한 키별 AND/OR 재정의. 생략 시 기본값은 OR. 전체 키 리매핑 레퍼런스는 “인물 + 회사 필터” 개발자 가이드를 참조하세요." }, "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/pubrio", "description": "LinkedIn 회사 페이지의 전체 URL입니다. `http`로 시작하며 `linkedin.com/company/`를 포함해야 합니다." }, "company_linkedin_urls": { "type": "array", "items": { "type": "string" }, "example": [ "https://www.linkedin.com/company/pubrio" ], "description": "LinkedIn 회사 페이지의 전체 URL입니다. `http`로 시작하며 `linkedin.com/company/`를 포함해야 합니다." }, "people_linkedin_url": { "type": "string", "example": "http://www.linkedin.com/in/king-lai-605382b7", "description": "LinkedIn 사용자 프로필의 전체 URL입니다. `http`로 시작하며 `linkedin.com/in/` 또는 `linkedin.com/pub/`을 포함해야 합니다." }, "people_linkedin_urls": { "type": "array", "items": { "type": "string" }, "example": [ "http://www.linkedin.com/in/king-lai-605382b7" ], "description": "LinkedIn 사용자 프로필의 전체 URL입니다. `http`로 시작하며 `linkedin.com/in/` 또는 `linkedin.com/pub/`을 포함해야 합니다." }, "people_name": { "type": "string", "example": "king", "description": "검색 결과를 지정된 사용자 이름으로 필터링합니다." }, "page": { "type": "integer", "example": 1, "description": "조회할 데이터 페이지 번호입니다." }, "per_page": { "type": "integer", "example": 25, "description": "페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다." }, "profile_id": { "type": "integer", "description": "선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.\n\n자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요." }, "is_enable_similarity_search": { "type": "boolean", "description": "활성화 시, 유사도 검색을 지원하는 필터에서 자유 텍스트로 특정 ID를 조회할 수 있습니다." }, "similarity_score": { "type": "number", "format": "float", "example": 0.7, "description": "`is_enable_similarity_search`와 함께 사용됩니다. 이 값은 특정 slug(예: 산업, 기술)와 사용자 입력 간의 유사도를 분석하며, 값이 높을수록 일치율이 더 정확합니다." }, "data_array": { "type": "array", "nullable": true, "items": { "type": "object", "properties": {} }, "description": "응답 정보는 특정 API에 따라 다릅니다." }, "data": { "type": "object", "nullable": true, "description": "응답 정보는 특정 API에 따라 다릅니다." }, "response_saved_lists": { "type": "array", "nullable": true, "items": { "type": "object", "properties": { "profile_id": { "type": "integer" }, "group_id": { "type": "integer" }, "name": { "type": "string" }, "is_personal": { "type": "boolean" } } }, "description": "워크스페이스에 저장된 연락처 또는 기업 목록." }, "company_filters": { "type": "object", "description": "회사 수준 필터의 래퍼 객체. 권장 그룹화 — 어떤 키가 *인물* 을 필터하고(최상위) 어떤 키가 *회사* 를 필터하는지를 시각적으로 분리합니다. 최상위 회사 필터와 동일한 키를 받습니다(예: `technologies`、`verticals`、`vertical_categories`、`vertical_sub_categories`、`categories`、`keywords`、`founded_dates`、`employees`、`revenues`、`company_locations`、`company_exclude_locations`、`company_places`、`company_exclude_places`、`companies`、`domains`、`company_linkedin_urls`、`is_enable_similarity_search`、`similarity_score` 그리고 `filter_conditions`). 엔진은 처리 전에 이 객체를 최상위로 평탄화합니다 — 동일 키가 있으면 최상위 키가 우선합니다. Monitor `company_filters` 와 같은 형태입니다. 예시는 필터 개요 개발자 가이드를 참조하세요.", "example": { "company_locations": [ "US" ], "technologies": [ 37, 152 ], "founded_dates": [ 2015, 2023 ], "filter_conditions": [ { "key": "technologies", "operator": "and" } ] } }, "advertisement_publisher_platforms": { "type": "array", "items": { "type": "string", "enum": [ "facebook", "instagram", "messenger", "threads", "audience_network" ] }, "example": [ "facebook", "instagram" ], "description": "게재된 플랫폼 노출 위치로 Facebook/Meta 광고를 필터링합니다. 소문자이며 대소문자를 구분하지 않습니다. `facebook` 소스에만 적용됩니다(다른 소스는 단일 플랫폼)." }, "advertisement_exclude_publisher_platforms": { "type": "array", "items": { "type": "string", "enum": [ "facebook", "instagram", "messenger", "threads", "audience_network" ] }, "example": [ "audience_network" ], "description": "이 플랫폼 노출 위치에서 게재된 Facebook/Meta 광고를 제외합니다." }, "advertisement_is_include_unlinked_companies": { "type": "boolean", "default": false, "example": true, "description": "확인된 회사에 아직 연결되지 않은 광고(원시 계층 광고, 예: 사기 또는 일회용 페이지 광고)를 포함합니다. 기본값은 false이며 회사에 연결된 광고만 반환합니다." }, "date_from": { "type": "string", "format": "date", "example": "2026-01-01", "description": "기간의 시작(ISO 8601, YYYY-MM-DD). `date_to`와 함께 사용하여 결과를 특정 범위로 한정합니다. 둘 다 생략하면 기본 기간이 사용됩니다." }, "date_to": { "type": "string", "format": "date", "example": "2026-03-31", "description": "기간의 종료(ISO 8601, YYYY-MM-DD). `date_from`과 같거나 그 이후여야 합니다." }, "window_days": { "type": "integer", "example": 90, "description": "선택 사항. 롤링 윈도우의 일수입니다. 명시적인 `transitioned_dates` 범위가 제공되지 않을 때 사용되며, 둘 다 생략하면 기본 윈도우가 사용됩니다." }, "timezone": { "type": "string", "example": "America/New_York", "description": "시계열을 현지 날짜 기준으로 묶는 데 사용되는 IANA 시간대 이름. 기본값은 UTC입니다." }, "expansion_country_code": { "type": "string", "example": "US", "description": "ISO 3166-1 alpha-2(cca2) 국가 코드로 표현된 타깃 시장. 생략하면 해당 회사의 가장 활발한 단일 시장이 자동으로 선택됩니다. 모든 시장에 대한 시장 통합 뷰가 필요하면 `is_all_markets`를 설정하세요." }, "expansion_momentum": { "type": "array", "items": { "type": "string", "enum": [ "accelerating", "advancing", "steady", "pulling_back" ] }, "example": [ "accelerating", "advancing" ], "description": "확장 모멘텀(단계 간 이동 궤적)으로 필터링합니다: `accelerating`(모드 변화를 동반한 가속 전진), `advancing`(전진), `steady`(안정), `pulling_back`(후퇴 또는 축소)." }, "expansion_freshness": { "type": "array", "items": { "type": "string", "enum": [ "fresh", "cooling", "stale", "cold" ] }, "example": [ "fresh", "cooling" ], "description": "증거의 최신성으로 필터링합니다: fresh(약 30일), cooling(약 30–60일), stale(약 60–90일), cold(90일 초과)." }, "expansion_sort_by": { "type": "string", "enum": [ "recent", "expansion_score", "signal_count", "company_ranking" ], "example": "expansion_score", "description": "결과 정렬 방식입니다. 생략하면 기본 관련성 순서가 적용됩니다: 상호 검증된 쌍(2개 이상의 서로 다른 신호 유형)이 먼저, 그다음 반복 증거 쌍(3개 이상의 신호), 그다음 나머지 — 각 계층 내에서는 가장 최근에 전환된 순입니다. `recent` — 순수 최신순(가장 최근에 전환된 순). `expansion_score` — 확장 점수가 높은 순. `signal_count` — 해당 쌍의 신호 수가 많은 순. `company_ranking` — Pubrio의 전체 기업 순위 기준(숫자가 작을수록 더 두드러짐), 오름차순." }, "expansion_scopes": { "type": "array", "items": { "type": "string", "enum": [ "entering_new_market", "expanding_within_presence", "established_only" ] }, "example": [ "entering_new_market" ], "description": "시장 진입 범위로 필터링합니다." }, "expansion_stage_slug": { "type": "string", "enum": [ "exploring", "committing", "expanding", "scaling", "established" ], "example": "committing", "description": "단일 확장 단계로 필터링합니다. 단계 정의는 확장 신호 지식 베이스를 참고하세요." }, "expansion_signal_type_slugs": { "type": "array", "items": { "type": "string", "enum": [ "AD", "NEWS", "DNS", "INFRA", "PARTNER", "EVENT_PLUS", "EXEC", "OFFICE", "HIRE", "SCALE", "PRODUCT" ] }, "example": [ "EXEC", "HIRE" ], "description": "특정 신호 유형으로 필터링합니다. 정의와 등급은 지식 베이스의 신호 유형 카탈로그를 참조하세요(`DNS`와 `INFRA`는 Premier 등급 신호입니다)." }, "expansion_is_include_established": { "type": "boolean", "example": false, "description": "`established` 단계(활성 확장 신호가 없는 오랜 기간 운영해 온 기업)를 포함합니다. 기본값은 false입니다." }, "expansion_is_include_metadata": { "type": "boolean", "example": true, "description": "API 키 응답은 기본적으로 간결합니다. true로 설정하면 전체 `metadata` 블록(집계, top origins/destinations, top industries, timeline)과 회사별 모델 세부 정보가 포함됩니다." }, "industries": { "type": "array", "items": { "type": "string" }, "example": [ "software", "financial services" ], "description": "산업 이름으로 필터링합니다(자유 텍스트 매칭)." }, "exclude_industries": { "type": "array", "items": { "type": "string" }, "example": [ "tobacco" ], "description": "제외할 산업입니다(자유 텍스트 매칭)." }, "expansion_domain_search_ids": { "type": "array", "items": { "type": "string" }, "example": [ "550e8400-e29b-41d4-a716-446655440002" ], "description": "포함할 회사 식별자(domain_search_id UUID)." }, "expansion_select_size": { "type": "integer", "example": 50, "description": "반환할 최대 레코드 수. 플랜에 따라 상한이 정해집니다." }, "expansion_ids": { "type": "array", "items": { "type": "integer" }, "example": [ 12345, 12346 ], "description": "내보낼 확장 레코드 식별자로, 확장 목록 엔드포인트가 반환하는 값입니다." }, "only_contraction": { "type": "boolean", "example": false, "description": "true인 경우 축소로 표시된 확장만 반환합니다(규모를 축소하는 회사)." }, "signal_strengths": { "type": "array", "items": { "type": "string", "enum": [ "low", "medium", "high" ] }, "example": [ "high" ], "description": "증거 신뢰도 구간으로 필터링합니다: `low`, `medium`, `high`. 신호 레코드에 반환되는 신호별 `signal_strength_slug`(`low`~`very_high` 범위)와는 다르며, 그 외의 값은 어떤 것과도 매칭되지 않습니다." }, "expansion_stages": { "type": "array", "items": { "type": "string", "enum": [ "exploring", "committing", "expanding", "scaling", "established" ] }, "example": [ "committing", "expanding" ], "description": "하나 이상의 확장 단계로 필터링합니다. 단계 정의는 Expansion Signals 지식 베이스를 참고하세요." }, "expansion_is_all_markets": { "type": "boolean", "example": false, "description": "단일 시장이 아니라 한 번의 호출로 회사의 모든 시장에 걸친 확장 현황 전체를 반환합니다. `true`인 경우 `country_code`는 무시되고, 본국 시장을 식별할 수 있는 경우 신호 집계에서 제외되며, `data`는 회사 수준 요약(주도 단계, 총 신호 수, 기간, 최고 확장 점수)이 되고 `markets_summary`에 모든 시장이 나열됩니다. 기본값은 false입니다." }, "expansion_froms": { "type": "array", "items": { "type": "string" }, "example": [ "US", "GB" ], "description": "출발 시장(ISO 3166-1 alpha-2). 기업이 어디에서부터 확장하는지 — 본사 / 모국. 단독으로 사용하면 이 시장에서 밖으로 확장하는 기업을 찾고, `tos`와 함께 사용하면 특정 출발→도착 코리도를 지정합니다." }, "expansion_tos": { "type": "array", "items": { "type": "string" }, "example": [ "US", "GB" ], "description": "도착 시장(ISO 3166-1 alpha-2). 기업이 어디로 확장하는지. 단독으로 사용하면 이 시장에 진입하는 모든 기업을 찾고, `froms`와 함께 사용하면 특정 출발→도착 코리도를 지정합니다." }, "expansion_exclude_froms": { "type": "array", "items": { "type": "string" }, "example": [ "US", "GB" ], "description": "제외할 출발 시장(ISO 3166-1 alpha-2)." }, "expansion_exclude_tos": { "type": "array", "items": { "type": "string" }, "example": [ "US", "GB" ], "description": "제외할 도착 시장(ISO 3166-1 alpha-2)." }, "expansion_companies": { "type": "array", "items": { "type": "string" }, "example": [ "stripe.com", "https://www.linkedin.com/company/airbnb", "550e8400-e29b-41d4-a716-446655440000" ], "description": "`domain_search_id`, 회사 도메인 또는 회사 소셜 미디어 프로필 URL의 임의 조합으로 회사를 지정합니다. 도메인과 URL은 순위가 가장 높은 회사로 확인됩니다." }, "is_expansion_signal_available": { "type": "boolean", "description": "When `true`, attaches the resolved expansion signals (`expansion_signals`) to each news item and enables the `expansion_signal_types` / `expansion_signal_polarities` filters. Leave unset for the fastest search — the expansion join is only added when this flag is on." }, "expansion_signal_types": { "type": "array", "items": { "type": "string", "enum": [ "AD", "EVENT", "NEWS", "DNS", "TECH", "INFRA", "IP", "PARTNER", "EVENT_PLUS", "REG", "ENTITY", "EXEC", "OFFICE", "HIRE", "SCALE", "PRODUCT" ] }, "example": [ "HIRE", "PARTNER" ], "description": "Return only news that produced an expansion signal of one of these types (uppercase slugs). Requires `is_expansion_signal_available: true`. Unknown slugs are ignored." }, "expansion_signal_polarities": { "type": "array", "items": { "type": "string", "enum": [ "expansion", "contraction_leading", "contraction_confirming", "contraction_lagging" ] }, "example": [ "expansion" ], "description": "Return only news whose expansion signal carries one of these polarities. Requires `is_expansion_signal_available: true`. Combined with `expansion_signal_types` as AND." } }, "securitySchemes": { "pubrio_api_key": { "type": "apiKey", "name": "pubrio-api-key", "description": "API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다.", "in": "header" } }, "responses": { "server_error": { "description": "내부 서버 오류. 서버에서 예기치 않은 오류가 발생했습니다. 오류가 지속되면 지원팀에 문의하세요.", "content": { "application/json": { "schema": { "required": [ "error" ], "type": "object", "properties": { "error": { "example": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다", "type": "string" } } } } } }, "rate_limit_error": { "description": "요청 속도 제한 초과. 주어진 시간 내에 너무 많은 요청이 전송되었습니다. 속도 제한 창이 재설정된 후 다시 시도하세요.", "content": { "application/json": { "schema": { "required": [ "error" ], "type": "object", "properties": { "error": { "example": "요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요.", "type": "string" } } } } } }, "general_error": { "description": "잘못된 요청. 요청 형식이 올바르지 않거나 잘못된 매개변수가 포함되어 있습니다. 오류 코드와 메시지를 확인하세요.", "content": { "application/json": { "schema": { "required": [ "code", "message", "details" ], "type": "object", "properties": { "code": { "example": 40001, "type": "integer" }, "message": { "example": "오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요.", "type": "string" }, "details": { "type": "object" } } } } } } }, "links": {}, "callbacks": {} }, "security": [ { "pubrio_api_key": [] } ] }