> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipecorn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account search

> Extract company accounts from a LinkedIn Sales Navigator search URL and process them asynchronously.

**Rate limit:** 1 request per second

This endpoint creates an import job that will process the search results in the background. Results will be sent to the specified webhook URL when processing is complete.

Extract company accounts from LinkedIn Sales Navigator search results and process them asynchronously. This endpoint creates an import job that will process the search results in the background and send the results to your specified webhook URL when complete.

## Overview

This endpoint allows you to extract company data from LinkedIn Sales Navigator search URLs. The process is asynchronous - you'll receive an immediate response with the import job details, and the actual results will be sent to your webhook URL when processing is complete.

## Rate Limits

* **1 request per second** per user/IP address


## OpenAPI

````yaml POST /accounts/
openapi: 3.0.1
info:
  title: Pipecorn Accounts API
  description: Pipecorn Accounts API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://app.pipecorn.com/api/v2/
security:
  - defaultApiKey: []
paths:
  /accounts/:
    post:
      summary: Extract account search results
      description: >-
        Extract company accounts from a LinkedIn Sales Navigator search URL and
        process them asynchronously.


        **Rate limit:** 1 request per second


        This endpoint creates an import job that will process the search results
        in the background. Results will be sent to the specified webhook URL
        when processing is complete.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                search_url:
                  type: string
                  format: uri
                  description: >-
                    LinkedIn Sales Navigator company search URL. Must start with
                    'https://www.linkedin.com/sales/search/company'
                  example: >-
                    https://www.linkedin.com/sales/search/company?query=(filters%3AList((type%3AANNUAL_REVENUE%2CrangeValue%3A(min%3A10%2Cmax%3A100)%2CselectedSubFilter%3AUSD)%2C(type%3AINDUSTRY%2Cvalues%3AList((id%3A6%2Ctext%3ATechnologie%252C%2520information%2520et%2520Internet%2CselectionType%3AINCLUDED)))))&sessionId=uYap7SN9RS6itaRp2Vt7Xg%3D%3D&viewAllFilters=true
                name:
                  type: string
                  description: Name for the import job
                  example: Tech Companies 10M-100M Revenue
                webhook_url:
                  type: string
                  format: uri
                  description: Webhook URL to receive the processed results
                  example: https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8
                streaming:
                  type: boolean
                  description: Enable streaming mode for real-time results
                  default: false
                  example: false
                custom:
                  type: object
                  description: Custom attributes to associate with the import
                  example:
                    source: api
                    campaign: q1_outreach
                limit:
                  type: integer
                  description: Maximum number of accounts to extract
                  example: 100
              required:
                - search_url
                - name
                - webhook_url
            example:
              search_url: >-
                https://www.linkedin.com/sales/search/company?query=(revenueRange:%22%2410M-%24100M%22%20AND%20employeeCountRange:%2211-50%22%20AND%20industry:%22Technology%2C%20Information%20and%20Internet%22)
              name: Tech Companies 10M-100M Revenue
              webhook_url: https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8
              streaming: false
              limit: 100
              custom:
                source: api
                campaign: q1_outreach
      responses:
        '201':
          description: Import job created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique identifier for the import job
                    example: 8e1dcba0-f0bb-4071-99fc-f18ba6559ccc
                  import_name:
                    type: string
                    description: Name of the import job
                    example: Tech Companies 10M-100M Revenue
                  import_url:
                    type: string
                    format: uri
                    description: The processed search URL used for extraction
                    example: >-
                      https://www.linkedin.com/sales-api/salesApiLeadSearch?query=(revenueRange:%22%2410M-%24100M%22%20AND%20employeeCountRange:%2211-50%22%20AND%20industry:%22Technology%2C%20Information%20and%20Internet%22)
                  created_at:
                    type: string
                    format: date-time
                    description: Creation timestamp of the import job
                    example: '2024-01-15T10:30:00Z'
                  custom:
                    type: object
                    description: Custom attributes associated with the import
                    example:
                      source: api
                      campaign: q1_outreach
              example:
                id: 8e1dcba0-f0bb-4071-99fc-f18ba6559ccc
                import_name: Tech Companies 10M-100M Revenue
                import_url: >-
                  https://www.linkedin.com/sales-api/salesApiLeadSearch?query=(revenueRange:%22%2410M-%24100M%22%20AND%20employeeCountRange:%2211-50%22%20AND%20industry:%22Technology%2C%20Information%20and%20Internet%22)
                created_at: '2024-01-15T10:30:00Z'
                custom:
                  source: api
                  campaign: q1_outreach
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                missing_required_keys:
                  summary: Missing required keys
                  value:
                    error: 400
                    message: 'Missing required keys: search_url, name, webhook_url'
                invalid_url_format:
                  summary: Invalid URL format
                  value:
                    error: 400
                    message: >-
                      Invalid URL format. Please provide a valid LinkedIn
                      company search URL
        '401':
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: 401
                message: Insufficient credits
        '422':
          description: Unprocessable entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: 422
                message: Unprocessable entity
        '429':
          description: Rate limit exceeded (1 request per second)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: 429
                message: Too many requests
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: 500
                message: Internal server error
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    defaultApiKey:
      type: apiKey
      in: header
      description: Your API key
      name: X-API-KEY

````