> ## Documentation Index > Fetch the complete documentation index at: https://docs.preceptai.co.uk/llms.txt > Use this file to discover all available pages before exploring further. # Discover People from LinkedIn Posts > Discover leads directly from authors who recently published LinkedIn posts matching specific keywords. Unlike `/v1/leads/search` (which searches by persona query), this endpoint discovers leads directly from content authors without requiring a persona query or running LLM query analysis. Each result is one post author (a lead), not a raw post. Results are returned via `GET /v1/jobs/{jobId}` (or your webhook) and include the lead's profile fields (`full_name`, `first_name`, `last_name`, `job_title`, `company_name`, `company_domain`, `linkedin`, `user_name`, `location`, `country`, `connections_count`, `followers`, `enrich_email`, `enrich_phone`) plus a `post` object: - `url`: link to the LinkedIn post - `content`: post text (truncated to 2000 characters) - `posted_at`: when the post was published - `likes_count`: number of likes/reactions - `comments_count`: number of comments With `findInsights: true`, results also include `summary`, `top_problems`, `internal_strategic_initiatives` and `public_appearances`. Use `sortBy: "likes"` or `sortBy: "comments"` to get the most-engaged posts instead of the default relevance order. Optionally enrich leads with verified contact details (emails/phones) and AI insights. ## OpenAPI ````yaml /api-reference/combined.json post /v1/leads/post-search openapi: 3.1.0 info: title: Precept API description: >- Precept API provides powerful, programmatic access to our AI-driven B2B account research, company enrichment, and verified contact data capabilities. Use these endpoints to discover high-intent companies, map decision-makers, and run personalized enrichment pipelines directly integrating with your CRM, spreadsheets, or automated workflows like Make and n8n. version: 1.0.0 servers: - url: https://api.preceptai.co.uk security: - bearerAuth: [] paths: /v1/leads/post-search: post: tags: - People summary: Discover People from LinkedIn Posts description: >- Discover leads directly from authors who recently published LinkedIn posts matching specific keywords. Unlike `/v1/leads/search` (which searches by persona query), this endpoint discovers leads directly from content authors without requiring a persona query or running LLM query analysis. Each result is one post author (a lead), not a raw post. Results are returned via `GET /v1/jobs/{jobId}` (or your webhook) and include the lead's profile fields (`full_name`, `first_name`, `last_name`, `job_title`, `company_name`, `company_domain`, `linkedin`, `user_name`, `location`, `country`, `connections_count`, `followers`, `enrich_email`, `enrich_phone`) plus a `post` object: - `url`: link to the LinkedIn post - `content`: post text (truncated to 2000 characters) - `posted_at`: when the post was published - `likes_count`: number of likes/reactions - `comments_count`: number of comments With `findInsights: true`, results also include `summary`, `top_problems`, `internal_strategic_initiatives` and `public_appearances`. Use `sortBy: "likes"` or `sortBy: "comments"` to get the most-engaged posts instead of the default relevance order. Optionally enrich leads with verified contact details (emails/phones) and AI insights. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LeadsPostSearchRequest' examples: default: summary: Example post search request value: keywords: - SEO problem - struggling with SEO - search rankings dropped timeframe: month limit: 30 name: LinkedIn SEO problem posts includeContactDetails: false sortedByLikes: summary: Most-liked posts from the past week value: keywords: - AI workflow - marketing automation timeframe: week sortBy: likes limit: 30 responses: '202': description: Request accepted. Post search and enrichment is in progress. content: application/json: schema: type: object properties: message: type: string example: >- Lead search job successfully created and 30 leads are being processed. enrichment_id: type: string format: uuid '400': description: Bad Request. Invalid parameters or 'query'/'signal' provided. content: application/json: schema: type: object properties: error: type: string '402': description: Insufficient credits to start post search. content: application/json: schema: type: object properties: message: type: string '500': description: Internal server error. content: application/json: schema: type: object properties: error: type: string components: schemas: LeadsPostSearchRequest: type: object required: - keywords properties: keywords: type: array items: type: string minItems: 1 maxItems: 5 description: >- 1 to 5 keywords or phrases to search LinkedIn posts for. Discovers leads directly from the authors of matching posts. timeframe: type: string enum: - day - week - month - year default: month description: >- Timeframe of LinkedIn posts to search: 'day' (past 24h), 'week' (past 7 days), 'month' (past 30 days), or 'year'. Defaults to 'month'. sortBy: type: string enum: - relevance - likes - comments default: relevance description: >- How to rank matching posts. 'relevance' (default) keeps LinkedIn's relevance order. 'likes' or 'comments' selects the most-liked or most-commented posts from a larger candidate pool and returns results in descending order of that metric (ties broken by the other metric). Sorting is done by Precept, not by LinkedIn. No extra cost. limit: type: integer maximum: 1000 default: 30 description: Maximum number of leads to return (up to 1000, default 30). name: type: string description: >- A readable name for your enrichment job for searching on your dashboard. includeContactDetails: type: boolean default: false description: >- Whether to find and verify email addresses and phone numbers for discovered authors. Adds +1 credit for email, +10 for phone (or +11 for both) per person. enrichType: type: array description: >- The type of contact details to find when includeContactDetails is true. Possible values: 'emails', 'phones'. items: type: string enum: - emails - phones findInsights: type: boolean default: false description: >- Generate AI insights for each discovered lead. Charges 1.1 credits per lead if true, else 0.1 credits. webhookUrl: type: string format: uri description: >- Optional webhook URL to receive the result of the lead search operations. streamingResults: type: boolean default: false description: >- Optional. When true and webhookUrl is provided, contact results are progressively streamed. securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.