> **For AI agents:** this page is a focused, LLM-optimized view of a > single Fiber AI operation. Before calling it, fetch the routing > instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation > index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md). # peopleSearch `POST /v1/people-search` **Tags:** `Search` People search **Endpoint:** `https://api.fiber.ai/v1/people-search` ## Description Search for people using filters ⚡ Rate limit: 180 requests per 1 minute 💰 Cost: 1 credit per profile found ⓘ ## Request body (JSON Schema) ```json { "type": "object", "properties": { "apiKey": { "type": "string", "description": "Your Fiber API key" }, "searchParams": { "type": "object", "properties": { "country3LetterCode": { "type": [ "object", "null" ], "properties": { "anyOf": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "USA", "GBR", "FRA", "IND", "BRA", "DEU", "ESP", "CAN", "AUS", "NLD", "ITA", "ZAF", "BEL", "CHN", "TUR", "MEX", "CHE", "NOR", "ARE", "SWE", "POL", "IDN", "ARG", "PRT", "COL", "CHL", "PAK", "DNK", "JPN", "NGA", "SGP", "PER", "NZL", "AUT", "IRL", "MYS", "BGD", "EGY", "ISR", "SAU", "PHL", "FIN", "IRN", "ROU", "CZE", "GRC", "HKG", "HUN", "KEN", "MAR", "VNM", "RUS", "UKR", "ECU", "THA", "LKA", "KOR", "BGR", "GHA", "SRB", "TWN", "HRV", "LTU", "PRI", "SVK", "TUN", "EST", "VEN", "CRI", "PAN", "URY", "LBN", "LUX", "CYP", "NPL", "JOR", "SVN", "MTQ", "QAT", "GLP", "UGA", "DZA", "GTM", "CMR", "LVA", "DOM", "AZE", "GEO", "SEN", "TZA", "ZWE", "KWT", "MLT", "OMN", "BOL", "SLV", "ARM", "PRY", "IRQ", "KHM", "BIH", "AGO", "BHR", "ALB", "KAZ", "CIV", "ETH", "MUS", "ZMB", "MKD", "COD", "BLR", "MOZ", "REU", "TTO", "GUF", "ISL", "MMR", "HND", "RWA", "MDG", "BEN", "UZB", "NAM", "BWA", "MDA", "JEY", "NIC", "SDN", "JAM", "IMN", "BFA", "MNG", "MNE", "MCO", "TGO", "AFG", "LBY", "XKX", "CYM", "MWI", "SOM", "PNG", "MDV", "MLI", "GIN", "PSE", "GAB", "LIE", "HTI", "SYR", "BRB", "YEM", "GGY", "NCL", "AND", "SUR", "MYT", "KGZ", "BHS", "GIB", "COG", "FJI", "BLM", "CUW", "CUB", "SLE", "BLZ", "NER", "LBR", "VIR", "PYF", "GUM", "MRT", "ABW", "SYC", "GUY", "LSO", "SWZ", "SSD", "LCA", "MAC", "SMR", "LAO", "BRN", "TCD", "BMU", "VGB", "PRK", "BTN", "BDI", "FRO", "TJK", "GMB", "STP", "ANT", "VCT", "DJI", "CPV", "TKM", "ATG", "TCA", "KNA", "GRD", "ASM", "VUT", "GNQ", "GRL", "SXM", "MNP", "COM", "TLS", "SJM", "CAF", "DMA", "MAF", "WSM", "BES", "MHL", "AIA", "TON", "COK", "SLB", "SPM", "GNB", "ATA", "TUV", "ALA", "IOT", "ERI", "PLW", "FSM", "NRU", "PCN", "FLK", "MSR", "VAT", "KIR", "SHN", "NIU", "WLF", "HMD", "CXR", "NFK", "ATF", "CCK", "SGS", "BVT", "UMI", "ESH", "TKL", "X-SOUTH_ASIA", "X-SOUTH_EAST_EUROPE", "X-NORTHERN_AFRICA", "X-PACIFIC", "X-SOUTH_WEST_EUROPE", "X-SOUTHERN_AFRICA", "X-WEST_INDIES", "X-SOUTH_AMERICA", "X-SOUTH_WEST_ASIA", "X-CENTRAL_EUROPE", "X-EASTERN_EUROPE", "X-WESTERN_EUROPE", "X-CENTRAL_AMERICA", "X-WESTERN_AFRICA", "X-SOUTH_ATLANTIC_OCEAN", "X-SOUTH_EAST_ASIA", "X-CENTRAL_AFRICA", "X-NORTH_AMERICA", "X-EAST_ASIA", "X-NORTHERN_EUROPE", "X-EASTERN_AFRICA", "X-SOUTHERN_INDIAN_OCEAN", "X-SOUTHERN_EUROPE", "X-CENTRAL_ASIA", "X-NORTHERN_ASIA", "X-ASIA", "X-EUROPE", "X-AFRICA", "X-OCEANIA", "X-AMERICAS", "X-ANTARCTICA", "X-ATLANTIC_OCEAN", "X-INDIAN_OCEAN", "X-MIDDLE_EAST", "X-MENA", "X-EMEA", "X-EUROPEAN_UNION", "X-EFTA", "X-APAC", "X-LATAM", "X-ANGLOSPHERE", "X-DACH", "X-NORDICS", "X-BENELUX", "X-GCC", "X-BRICS", "X-G20", "X-OECD", "X-SANCTIONED" ] } }, "noneOf": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "USA", "GBR", "FRA", "IND", "BRA", "DEU", "ESP", "CAN", "AUS", "NLD", "ITA", "ZAF", "BEL", "CHN", "TUR", "MEX", "CHE", "NOR", "ARE", "SWE", "POL", "IDN", "ARG", "PRT", "COL", "CHL", "PAK", "DNK", "JPN", "NGA", "SGP", "PER", "NZL", "AUT", "IRL", "MYS", "BGD", "EGY", "ISR", "SAU", "PHL", "FIN", "IRN", "ROU", "CZE", "GRC", "HKG", "HUN", "KEN", "MAR", "VNM", "RUS", "UKR", "ECU", "THA", "LKA", "KOR", "BGR", "GHA", "SRB", "TWN", "HRV", "LTU", "PRI", "SVK", "TUN", "EST", "VEN", "CRI", "PAN", "URY", "LBN", "LUX", "CYP", "NPL", "JOR", "SVN", "MTQ", "QAT", "GLP", "UGA", "DZA", "GTM", "CMR", "LVA", "DOM", "AZE", "GEO", "SEN", "TZA", "ZWE", "KWT", "MLT", "OMN", "BOL", "SLV", "ARM", "PRY", "IRQ", "KHM", "BIH", "AGO", "BHR", "ALB", "KAZ", "CIV", "ETH", "MUS", "ZMB", "MKD", "COD", "BLR", "MOZ", "REU", "TTO", "GUF", "ISL", "MMR", "HND", "RWA", "MDG", "BEN", "UZB", "NAM", "BWA", "MDA", "JEY", "NIC", "SDN", "JAM", "IMN", "BFA", "MNG", "MNE", "MCO", "TGO", "AFG", "LBY", "XKX", "CYM", "MWI", "SOM", "PNG", "MDV", "MLI", "GIN", "PSE", "GAB", "LIE", "HTI", "SYR", "BRB", "YEM", "GGY", "NCL", "AND", "SUR", "MYT", "KGZ", "BHS", "GIB", "COG", "FJI", "BLM", "CUW", "CUB", "SLE", "BLZ", "NER", "LBR", "VIR", "PYF", "GUM", "MRT", "ABW", "SYC", "GUY", "LSO", "SWZ", "SSD", "LCA", "MAC", "SMR", "LAO", "BRN", "TCD", "BMU", "VGB", "PRK", "BTN", "BDI", "FRO", "TJK", "GMB", "STP", "ANT", "VCT", "DJI", "CPV", "TKM", "ATG", "TCA", "KNA", "GRD", "ASM", "VUT", "GNQ", "GRL", "SXM", "MNP", "COM", "TLS", "SJM", "CAF", "DMA", "MAF", "WSM", "BES", "MHL", "AIA", "TON", "COK", "SLB", "SPM", "GNB", "ATA", "TUV", "ALA", "IOT", "ERI", "PLW", "FSM", "NRU", "PCN", "FLK", "MSR", "VAT", "KIR", "SHN", "NIU", "WLF", "HMD", "CXR", "NFK", "ATF", "CCK", "SGS", "BVT", "UMI", "ESH", "TKL", "X-SOUTH_ASIA", "X-SOUTH_EAST_EUROPE", "X-NORTHERN_AFRICA", "X-PACIFIC", "X-SOUTH_WEST_EUROPE", "X-SOUTHERN_AFRICA", "X-WEST_INDIES", "X-SOUTH_AMERICA", "X-SOUTH_WEST_ASIA", "X-CENTRAL_EUROPE", "X-EASTERN_EUROPE", "X-WESTERN_EUROPE", "X-CENTRAL_AMERICA", "X-WESTERN_AFRICA", "X-SOUTH_ATLANTIC_OCEAN", "X-SOUTH_EAST_ASIA", "X-CENTRAL_AFRICA", "X-NORTH_AMERICA", "X-EAST_ASIA", "X-NORTHERN_EUROPE", "X-EASTERN_AFRICA", "X-SOUTHERN_INDIAN_OCEAN", "X-SOUTHERN_EUROPE", "X-CENTRAL_ASIA", "X-NORTHERN_ASIA", "X-ASIA", "X-EUROPE", "X-AFRICA", "X-OCEANIA", "X-AMERICAS", "X-ANTARCTICA", "X-ATLANTIC_OCEAN", "X-INDIAN_OCEAN", "X-MIDDLE_EAST", "X-MENA", "X-EMEA", "X-EUROPEAN_UNION", "X-EFTA", "X-APAC", "X-LATAM", "X-ANGLOSPHERE", "X-DACH", "X-NORDICS", "X-BENELUX", "X-GCC", "X-BRICS", "X-G20", "X-OECD", "X-SANCTIONED" ] } } } }, "numConnections": { "type": [ "object", "null" ], "properties": { "lowerBound": { "type": [ "number", "null" ] }, "upperBound": { "type": [ "number", "null" ] } } }, "numFollowers": { "type": [ "object", "null" ], "properties": { "lowerBound": { "type": [ "number", "null" ] }, "upperBound": { "type": [ "number", "null" ] } } }, "approxAge": { "type": [ "object", "null" ], "properties": { "lowerBound": { "type": [ "number", "null" ] }, "upperBound": { "type": [ "number", "null" ] } } }, "keywords": { "type": [ "object", "null" ], "properties": { "containsAll": { "type": [ "array", "null" ], "items": { "type": "string" } }, "containsAny": { "type": [ "array", "null" ], "items": { "type": "string" } }, "containsNone": { "type": [ "array", "null" ], "items": { "type": "string" } } } }, "keywordsV2": { "type": [ "object", "null" ], "properties": { "operator": { "type": "string", "enum": [ "AND", "OR" ], "default": "AND" }, "clauses": { "type": "array", "items": { "type": "object", "properties": { "operator": { "type": "string", "enum": [ "AND", "OR" ], "default": "OR" }, "terms": { "type": "array", "items": { "type": "string" }, "minItems": 1 }, "negate": { "type": "boolean", "default": false } }, "required": [ "terms" ] }, "minItems": 1 }, "options": { "type": [ "object", "null" ], "properties": { "fieldsToSearchOver": { "type": [ "object", "null" ], "properties": { "summary": { "type": "boolean", "default": true }, "headline": { "type": "boolean", "default": true }, "pastJobTitles": { "type": "boolean", "default": true }, "pastJobSummaries": { "type": "boolean", "default": true }, "pastCompanyNames": { "type": "boolean", "default": true }, "currentJobTitles": { "type": "boolean", "default": true }, "currentJobSummaries": { "type": "boolean", "default": true }, "currentCompanyNames": { "type": "boolean", "default": true }, "interests": { "type": "boolean", "default": true }, "skills": { "type": "boolean", "default": true }, "industry": { "type": "boolean", "default": true }, "education": { "type": "boolean", "default": true }, "publications": { "type": "boolean", "default": true }, "certifications": { "type": "boolean", "default": true }, "articles": { "type": "boolean", "default": true }, "courses": { "type": "boolean", "default": true }, "projects": { "type": "boolean", "default": true }, "patents": { "type": "boolean", "default": true }, "volunteering": { "type": "boolean", "default": false }, "languages": { "type": "boolean", "default": false } } } } } }, "required": [ "clauses" ] }, "keywordSearchOptions": { "type": [ "object", "null" ], "properties": { "fieldsToSearchOver": { "type": [ "object", "null" ], "properties": { "summary": { "type": "boolean", "default": true }, "headline": { "type": "boolean", "default": true }, "pastJobTitles": { "type": "boolean", "default": true }, "pastJobSummaries": { "type": "boolean", "default": true }, "pastCompanyNames": { "type": "boolean", "default": true }, "currentJobTitles": { "type": "boolean", "default": true }, "currentJobSummaries": { "type": "boolean", "default": true }, "currentCompanyNames": { "type": "boolean", "default": true }, "interests": { "type": "boolean", "default": true }, "skills": { "type": "boolean", "default": true }, "industry": { "type": "boolean", "default": true }, "education": { "type": "boolean", "default": true }, "publications": { "type": "boolean", "default": true }, "certifications": { "type": "boolean", "default": true }, "articles": { "type": "boolean", "default": true }, "courses": { "type": "boolean", "default": true }, "projects": { "type": "boolean", "default": true }, "patents": { "type": "boolean", "default": true }, "volunteering": { "type": "boolean", "default": false }, "languages": { "type": "boolean", "default": false } } } } }, "jobTitleV2": { "type": [ "object", "null" ], "properties": { "anyOf": { "type": [ "array", "null" ], "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "term" ] }, "term": { "type": "string" } }, "required": [ "type", "term" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "static-groups" ] }, "groups": { "type": "array", "items": { "type": "string", "enum": [ "founder", "c-suite", "board-member" ] } } }, "required": [ "type", "groups" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "dynamic-groups" ] }, "groups": { "type": "array", "items": { "type": "string", "enum": [ "vp", "director", "management", "entry-level", "assistant", "intern" ] } }, "keywords": { "type": "array", "items": { "type": "string" }, "default": [] } }, "required": [ "type", "groups" ] } ] } }, "noneOf": { "type": [ "array", "null" ], "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "term" ] }, "term": { "type": "string" } }, "required": [ "type", "term" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "static-groups" ] }, "groups": { "type": "array", "items": { "type": "string", "enum": [ "founder", "c-suite", "board-member" ] } } }, "required": [ "type", "groups" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "dynamic-groups" ] }, "groups": { "type": "array", "items": { "type": "string", "enum": [ "vp", "director", "management", "entry-level", "assistant", "intern" ] } }, "keywords": { "type": "array", "items": { "type": "string" }, "default": [] } }, "required": [ "type", "groups" ] } ] } }, "allOf": { "type": [ "array", "null" ], "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "term" ] }, "term": { "type": "string" } }, "required": [ "type", "term" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "static-groups" ] }, "groups": { "type": "array", "items": { "type": "string", "enum": [ "founder", "c-suite", "board-member" ] } } }, "required": [ "type", "groups" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "dynamic-groups" ] }, "groups": { "type": "array", "items": { "type": "string", "enum": [ "vp", "director", "management", "entry-level", "assistant", "intern" ] } }, "keywords": { "type": "array", "items": { "type": "string" }, "default": [] } }, "required": [ "type", "groups" ] } ] } } } }, "exactProfile": { "type": [ "object", "null" ], "properties": { "anyOf": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "profile_id": { "type": [ "string", "null" ] }, "primary_slug": { "type": [ "string", "null" ] } } } }, "noneOf": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "profile_id": { "type": [ "string", "null" ] }, "primary_slug": { "type": [ "string", "null" ] } } } } } }, "exactProfileV2": { "type": [ "object", "null" ], "properties": { "anyOf": { "type": [ "array", "null" ], "items": { "oneOf": [ { "type": "object", "properties": { "identifier": { "type": "string", "enum": [ "linkedin-slug" ] }, "linkedin_slug": { "type": "string", "minLength": 1 } }, "required": [ "identifier", "linkedin_slug" ] }, { "type": "object", "properties": { "identifier": { "type": "string", "enum": [ "linkedin-url" ] }, "linkedin_url": { "type": "string", "format": "uri" } }, "required": [ "identifier", "linkedin_url" ] }, { "type": "object", "properties": { "identifier": { "type": "string", "enum": [ "linkedin-user-id" ] }, "user_id": { "type": "string", "pattern": "^[0-9]+$", "minLength": 1 } }, "required": [ "identifier", "user_id" ] } ] } }, "noneOf": { "type": [ "array", "null" ], "items": { "oneOf": [ { "type": "object", "properties": { "identifier": { "type": "string", "enum": [ "linkedin-slug" ] }, "linkedin_slug": { "type": "string", "minLength": 1 } }, "required": [ "identifier", "linkedin_slug" ] }, { "type": "object", "properties": { "identifier": { "type": "string", "enum": [ "linkedin-url" ] }, "linkedin_url": { "type": "string", "format": "uri" } }, "required": [ "identifier", "linkedin_url" ] }, { "type": "object", "properties": { "identifier": { "type": "string", "enum": [ "linkedin-user-id" ] }, "user_id": { "type": "string", "pattern": "^[0-9]+$", "minLength": 1 } }, "required": [ "identifier", "user_id" ] } ] } } } }, "startedInRole": { "oneOf": [ { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "absolute" ] }, "range": { "type": [ "object", "null" ], "properties": { "lowerBound": { "type": [ "string", "null" ] }, "upperBound": { "type": [ "string", "null" ] } } } }, "required": [ "strategy" ] }, { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "relative" ] }, "window": { "oneOf": [ { "type": "object", "properties": { "method": { "type": "string", "enum": [ "lastN" ] }, "period": { "type": "string", "enum": [ "day", "week", "month", "quarter", "year" ] }, "quantity": { "type": "number", "minimum": 1 } }, "required": [ "method", "period", "quantity" ] }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "within" ] }, "period": { "type": "string", "enum": [ "day", "week", "month", "quarter", "year" ] }, "lowerBound": { "type": [ "number", "null" ] }, "upperBound": { "type": [ "number", "null" ] } }, "required": [ "method", "period" ] }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "calendar" ] }, "which": { "type": "string", "enum": [ "current", "previous" ] }, "period": { "type": "string", "enum": [ "day", "week", "month", "quarter", "year" ] } }, "required": [ "method", "which", "period" ] }, { "type": "null" } ] } }, "required": [ "strategy" ] }, { "type": "null" } ] }, "startedAtCompany": { "oneOf": [ { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "absolute" ] }, "range": { "type": [ "object", "null" ], "properties": { "lowerBound": { "type": [ "string", "null" ] }, "upperBound": { "type": [ "string", "null" ] } } } }, "required": [ "strategy" ] }, { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "relative" ] }, "window": { "oneOf": [ { "type": "object", "properties": { "method": { "type": "string", "enum": [ "lastN" ] }, "period": { "type": "string", "enum": [ "day", "week", "month", "quarter", "year" ] }, "quantity": { "type": "number", "minimum": 1 } }, "required": [ "method", "period", "quantity" ] }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "within" ] }, "period": { "type": "string", "enum": [ "day", "week", "month", "quarter", "year" ] }, "lowerBound": { "type": [ "number", "null" ] }, "upperBound": { "type": [ "number", "null" ] } }, "required": [ "method", "period" ] }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "calendar" ] }, "which": { "type": "string", "enum": [ "current", "previous" ] }, "period": { "type": "string", "enum": [ "day", "week", "month", "quarter", "year" ] } }, "required": [ "method", "which", "period" ] }, { "type": "null" } ] } }, "required": [ "strategy" ] }, { "type": "null" } ] }, "location": { "type": [ "object", "null" ], "properties": { "unionAll": { "type": [ "array", "null" ], "items": { "oneOf": [ { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "radial-distance" ] }, "center": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] }, "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 } }, "required": [ "latitude", "longitude" ] }, "radius": { "oneOf": [ { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "miles" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 12500 } }, "required": [ "unit", "quantity" ] }, { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "kilometers" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 20100 } }, "required": [ "unit", "quantity" ] } ] } }, "required": [ "strategy", "center", "radius" ] }, { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "free-form-city" ] }, "city": { "type": "string", "minLength": 1 }, "countryCode": { "type": [ "string", "null" ], "minLength": 3, "maxLength": 3 }, "radius": { "oneOf": [ { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "miles" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 12500 } }, "required": [ "unit", "quantity" ] }, { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "kilometers" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 20100 } }, "required": [ "unit", "quantity" ] } ] } }, "required": [ "strategy", "city", "radius" ] }, { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "polygon" ] }, "vertices": { "type": "array", "items": { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 } }, "required": [ "latitude", "longitude" ] }, "minItems": 4, "maxItems": 1000 } }, "required": [ "strategy", "vertices" ] }, { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "preset-region" ] }, "region": { "type": "string", "enum": [ "sf-bay-area", "sf-north-bay", "sf-east-bay", "sf-south-bay", "sf-peninsula", "greater-new-york", "chicagoland", "washington-dmv", "greater-los-angeles", "inland-empire", "greater-philadelphia", "boston-route-128", "greater-austin", "toronto-golden-horseshoe", "greater-london", "greater-tokyo", "research-triangle", "seattle-puget-sound", "dallas-fort-worth", "miami-south-florida", "slc-silicon-slopes", "denver-front-range" ] } }, "required": [ "strategy", "region" ] } ] } }, "subtractAll": { "type": [ "array", "null" ], "items": { "oneOf": [ { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "radial-distance" ] }, "center": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] }, "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 } }, "required": [ "latitude", "longitude" ] }, "radius": { "oneOf": [ { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "miles" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 12500 } }, "required": [ "unit", "quantity" ] }, { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "kilometers" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 20100 } }, "required": [ "unit", "quantity" ] } ] } }, "required": [ "strategy", "center", "radius" ] }, { "type": "object", "properties": { "strategy": { "type": "string", "enum": [ "free-form-city" ] }, "city": { "type": "string", "minLength": 1 }, "countryCode": { "type": [ "string", "null" ], "minLength": 3, "maxLength": 3 }, "radius": { "oneOf": [ { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "miles" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 12500 } }, "required": [ "unit", "quantity" ] }, { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "kilometers" ] }, "quantity": { "type": "number", "minimum": 0, "maximum": 20100 } }, "required": [ "unit", "quantity" ] } ] } }, "required": [ "strategy", "city", … _truncated to 65536 chars for ai-docs._ ``` ## Response — success (JSON Schema) ```json { "type": "object", "properties": { "output": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "articles": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "date_published": { "type": [ "string", "null" ] } } } }, "certifications": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "title": { "type": [ "string", "null" ] }, "credential_id": { "type": [ "string", "null" ] }, "verify_url": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "linkedin_company_id": { "type": [ "string", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] } } } }, "connection_count": { "type": [ "number", "null" ] }, "courses": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "title": { "type": [ "string", "null" ] }, "course_number": { "type": [ "string", "null" ] }, "association": { "type": "null" } } } }, "dob": { "type": [ "string", "null" ] }, "education": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "school_id": { "type": [ "string", "null" ] }, "school_name": { "type": [ "string", "null" ] }, "field_of_study_id": { "type": [ "string", "null" ] }, "field_of_study_name": { "type": [ "string", "null" ] }, "degree": { "type": [ "string", "null" ] }, "grade": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "activities": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } } } }, "experiences": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "linkedin_company_id": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "seniority": { "type": [ "string", "null" ], "enum": [ "Entry level", "Director", "Associate", "Mid-Senior level", "Internship", "Executive", null ] }, "job_function": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Arts and Design", "Business Development", "Community & Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Military & Protective Services", "Operations", "Program & Product Management", "Real Estate", "Sales", "Support", "Administrative", "Finance", "Marketing", "Purchasing", "Product Management", "Advertising", "Analyst", "Customer Service", "Distribution", "Design", "General Business", "Management", "Manufacturing", "Other", "Public Relations", "Project Management", "Production", "Quality Assurance", "Research", "Science", "Supply Chain", "Training", "Health Care Provider", "Accounting", "Art / Creative", "Strategy / Planning", "Writing / Editing" ] } }, "employment_type": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Full-time", "Temporary", "Internship", "Contract", "Part-time", "Volunteer", "Other" ] } }, "academic_qualification": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "High School", "Associate Degree", "Bachelor Degree" ] } }, "company_start_date": { "type": [ "string", "null" ] }, "company_end_date": { "type": [ "string", "null" ] } } } }, "first_name": { "type": [ "string", "null" ] }, "follower_count": { "type": [ "number", "null" ] }, "headline": { "type": [ "string", "null" ] }, "industry_name": { "type": [ "string", "null" ] }, "inferred_location": { "type": [ "object", "null" ], "properties": { "street_address": { "type": [ "string", "null" ] }, "neighborhood": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "state_name": { "type": [ "string", "null" ] }, "state_code": { "type": [ "string", "null" ] }, "county": { "type": [ "string", "null" ] }, "postal_code": { "type": [ "string", "null" ] }, "country_code": { "type": [ "string", "null" ] }, "country_name": { "type": [ "string", "null" ] }, "coordinates": { "type": [ "object", "null" ], "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "required": [ "lat", "lon" ] }, "timezone": { "type": [ "string", "null" ] }, "full_address": { "type": [ "string", "null" ] }, "formatted_address": { "type": [ "string", "null" ] } } }, "interests": { "type": [ "array", "null" ], "items": { "type": "string" } }, "last_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "patents": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "number": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] } } } }, "profile_pic": { "type": [ "string", "null" ] }, "projects": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "project_id": { "type": [ "string", "null" ] }, "project_title": { "type": [ "string", "null" ] }, "project_url": { "type": [ "string", "null" ] }, "project_summary": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] } } } }, "publications": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "collaborators": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } } } }, "date": { "type": [ "string", "null" ] }, "id": { "type": [ "string", "null" ] }, "publisher": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } } } }, "skills": { "type": [ "array", "null" ], "items": { "type": "string" } }, "primary_slug": { "type": "string" }, "slugs": { "type": [ "array", "null" ], "items": { "type": "string" } }, "summary": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "volunteering": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "role": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "cause": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "linkedin_company_id": { "type": [ "string", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] } } } }, "tenures": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "linkedin_company_id": { "type": [ "string", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "date_range": { "type": "object", "properties": { "gte": { "type": [ "string", "null" ] }, "lte": { "type": [ "string", "null" ] } } }, "range_length_days": { "type": [ "number", "null" ] }, "titles": { "type": "array", "items": { "type": "string" } }, "localities": { "type": "array", "items": { "type": "string" } } }, "required": [ "date_range", "titles", "localities" ] } }, "career_began_at": { "type": [ "string", "null" ] }, "tags": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "student", "attended-top-us-university", "attended-top-global-university", "second-time-founder", "deep-technical-background", "major-tech-company-experience", "fortune-500-executive", "recently-changed-companies", "recently-promoted", "decision-maker", "c-suite", "experienced-executive", "phd", "influencer", "board-member" ] } }, "entity_urn": { "type": [ "string", "null" ] }, "open_to_work": { "type": [ "boolean", "null" ] }, "premium": { "type": [ "boolean", "null" ] }, "influencer": { "type": [ "boolean", "null" ] }, "organizations": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] } } } }, "entity_urns": { "type": [ "array", "null" ], "items": { "type": "string" } }, "is_hiring": { "type": [ "boolean", "null" ] }, "websites": { "type": [ "array", "null" ], "items": { "type": "string" } }, "is_verified": { "type": [ "boolean", "null" ] }, "verifications": { "type": [ "object", "null" ], "properties": { "is_verified": { "type": [ "boolean", "null" ] }, "joined_date": { "type": [ "string", "null" ] }, "verification_types": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "title": { "type": [ "string", "null" ] }, "subtitle": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] } } } } } }, "is_top_voice": { "type": [ "boolean", "null" ] }, "current_job": { "type": [ "object", "null" ], "properties": { "linkedin_company_id": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "seniority": { "type": [ "string", "null" ], "enum": [ "Entry level", "Director", "Associate", "Mid-Senior level", "Internship", "Executive", null ] }, "job_function": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Arts and Design", "Business Development", "Community & Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Military & Protective Services", "Operations", "Program & Product Management", "Real Estate", "Sales", "Support", "Administrative", "Finance", "Marketing", "Purchasing", "Product Management", "Advertising", "Analyst", "Customer Service", "Distribution", "Design", "General Business", "Management", "Manufacturing", "Other", "Public Relations", "Project Management", "Production", "Quality Assurance", "Research", "Science", "Supply Chain", "Training", "Health Care Provider", "Accounting", "Art / Creative", "Strategy / Planning", "Writing / Editing" ] } }, "employment_type": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Full-time", "Temporary", "Internship", "Contract", "Part-time", "Volunteer", "Other" ] } }, "academic_qualification": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "High School", "Associate Degree", "Bachelor Degree" ] } }, "company_start_date": { "type": [ "string", "null" ] }, "company_end_date": { "type": [ "string", "null" ] } } }, "custom_data": { "type": [ "object", "null" ], "additionalProperties": { "type": "string" } }, "relevance_score": { "type": [ "number", "null" ] }, "last_sort_key": { "type": [ "string", "null" ] }, "languages": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "proficiency_id": { "type": [ "string", "null" ] }, "proficiency_name": { "type": [ "string", "null" ] } } } }, "detailed_education": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "school_details": { "type": [ "object", "null" ], "properties": { "linkedin_ids": { "type": [ "array", "null" ], "items": { "type": "string" } }, "li_org_id": { "type": [ "string", "null" ] }, "linkedin_primary_slug": { "type": [ "string", "null" ] }, "domains": { "type": [ "array", "null" ], "items": { "type": "string" } }, "preferred_name": { "type": [ "string", "null" ] } } }, "school_id": { "type": [ "string", "null" ] }, "school_name": { "type": [ "string", "null" ] }, "field_of_study_id": { "type": [ "string", "null" ] }, "field_of_study_name": { "type": [ "string", "null" ] }, "degree": { "type": [ "string", "null" ] }, "grade": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "activities": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } } } }, "detailed_work_experiences": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "company_details": { "type": [ "object", "null" ], "properties": { "linkedin_ids": { "type": [ "array", "null" ], "items": { "type": "string" } }, "li_org_id": { "type": [ "string", "null" ] }, "linkedin_primary_slug": { "type": [ "string", "null" ] }, "domains": { "type": [ "array", "null" ], "items": { "type": "string" } }, "preferred_name": { "type": [ "string", "null" ] } } }, "crunchbase_slug": { "type": [ "string", "null" ] }, "linkedin_company_id": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "seniority": { "type": [ "string", "null" ], "enum": [ "Entry level", "Director", "Associate", "Mid-Senior level", "Internship", "Executive", null ] }, "job_function": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Arts and Design", "Business Development", "Community & Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Military & Protective Services", "Operations", "Program & Product Management", "Real Estate", "Sales", "Support", "Administrative", "Finance", "Marketing", "Purchasing", "Product Management", "Advertising", "Analyst", "Customer Service", "Distribution", "Design", "General Business", "Management", "Manufacturing", "Other", "Public Relations", "Project Management", "Production", "Quality Assurance", "Research", "Science", "Supply Chain", "Training", "Health Care Provider", "Accounting", "Art / Creative", "Strategy / Planning", "Writing / Editing" ] } }, "employment_type": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Full-time", "Temporary", "Internship", "Contract", "Part-time", "Volunteer", "Other" ] } }, "academic_qualification": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "High School", "Associate Degree", "Bachelor Degree" ] } }, "company_start_date": { "type": [ "string", "null" ] }, "company_end_date": { "type": [ "string", "null" ] } } } } }, "required": [ "primary_slug" ] } }, "estimatedCount": { "type": [ "number", "null" ], "description": "The estimated total number of people who match your search parameters. Note that this does not account for exclusion lists." }, "nextCursor": { "type": [ "string", "null" ], "description": "The pagination cursor for the next page. Provide this in the next request to continue paginating." } }, "required": [ "data" ] }, "chargeInfo": { "oneOf": [ { "type": "object", "properties": { "method": { "type": "string", "enum": [ "charged-now" ] }, "creditsCharged": { "type": "number" }, "lowCreditAlert": { "type": [ "object", "null" ], "properties": { "getMoreCreditsUrl": { "type": "string", "format": "uri", "description": "URL to top up credits or restart billing cycle to get fresh credits." }, "message": { "type": "string", "description": "Human-readable credits warning." }, "availableCredits": { "type": "number", "description": "Number of credits remaining in the current billing period." } }, "required": [ "getMoreCreditsUrl", "message", "availableCredits" ], "description": "Contains a link to get more credits, a warning message, and the remaining credit count." } }, "required": [ "method", "creditsCharged" ], "description": "Credits were charged immediately for this operation" }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "charging-later" ] }, "message": { "type": "string" }, "lowCreditAlert": { "type": [ "object", "null" ], "properties": { "getMoreCreditsUrl": { "type": "string", "format": "uri", "description": "URL to top up credits or restart billing cycle to get fresh credits." }, "message": { "type": "string", "description": "Human-readable credits warning." }, "availableCredits": { "type": "number", "description": "Number of credits remaining in the current billing period." } }, "required": [ "getMoreCreditsUrl", "message", "availableCredits" ], "description": "Contains a link to get more credits, a warning message, and the remaining credit count." } }, "required": [ "method", "message" ], "description": "Credits will be charged after the operation completes" }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "charged-for-async-process" ] }, "creditsCharged": { "type": "number" }, "message": { "type": "string" }, "lowCreditAlert": { "type": [ "object", "null" ], "properties": { "getMoreCreditsUrl": { "type": "string", "format": "uri", "description": "URL to top up credits or restart billing cycle to get fresh credits." }, "message": { "type": "string", "description": "Human-readable credits warning." }, "availableCredits": { "type": "number", "description": "Number of credits remaining in the current billing period." } }, "required": [ "getMoreCreditsUrl", "message", "availableCredits" ], "description": "Contains a link to get more credits, a warning message, and the remaining credit count." } }, "required": [ "method", "creditsCharged", "message" ], "description": "Credits that were charged for an asynchronous operation" }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "free" ] }, "message": { "type": "string" }, "lowCreditAlert": { "type": [ "object", "null" ], "properties": { "getMoreCreditsUrl": { "type": "string", "format": "uri", "description": "URL to top up credits or restart billing cycle to get fresh credits." }, "message": { "type": "string", "description": "Human-readable credits warning." }, "availableCredits": { "type": "number", "description": "Number of credits remaining in the current billing period." } }, "required": [ "getMoreCreditsUrl", "message", "availableCredits" ], "description": "Contains a link to get more credits, a warning message, and the remaining credit count." } }, "required": [ "method", "message" ], "description": "No credits were charged for this operation" }, { "type": "object", "properties": { "method": { "type": "string", "enum": [ "credits-refunded" ] }, "creditsRefunded": { "type": "number" }, "message": { "type": "string" }, "lowCreditAlert": { "type": [ "object", "null" ], "properties": { "getMoreCreditsUrl": { "type": "string", "format": "uri", "description": "URL to top up credits or restart billing cycle to get fresh credits." }, "message": { "type": "string", "description": "Human-readable credits warning." }, "availableCredits": { "type": "number", "description": "Number of credits remaining in the current billing period." } }, "required": [ "getMoreCreditsUrl", "message", "availableCredits" ], "description": "Contains a link to get more credits, a warning message, and the remaining credit count." } }, "required": [ "method", "creditsRefunded", "message" ], "description": "Credits were refunded for this operation" } ] }, "warnings": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')" }, "message": { "type": "string", "description": "Warning message" } }, "required": [ "field", "message" ] }, "description": "Warnings about extraneous fields in request" }, "advice": { "type": "array", "items": { "type": "string" }, "default": [], "description": "Tips, recommendations, and suggestions for using this API effectively." } }, "required": [ "output", "chargeInfo", "advice" ], "additionalProperties": false } ``` --- Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json) Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)