> ## 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 Leads 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 discovered lead includes their verified profile and the specific LinkedIn post they authored.

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:
        - Leads
      summary: Discover Leads 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 discovered lead includes their verified profile and the specific
        LinkedIn post they authored.


        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
      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'.
        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

````