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

# Initiate Deep Research

> Initiate a deep research job for comprehensive user profile data.

Deep research is an advanced search feature that performs a broad search to provide comprehensive results. The process is asynchronous and uses a job-based system. To check the status of a job, use the [Get Research Status](/api-reference/endpoint/get-deep-research-status) endpoint.

## Initiate Deep Research

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://search.clado.ai/api/search/deep_research \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "query": "software engineers",
      "limit": 50,
      "hard_filter_company_urls": ["https://www.linkedin.com/company/google", "https://wwww.linkedin.com/company/microsoft"]
    }'
  ```
</CodeGroup>

### Request Body

| Parameter                   | Type             | Required | Default | Description                                                              |
| --------------------------- | ---------------- | -------- | ------- | ------------------------------------------------------------------------ |
| query                       | string           | Yes      |         | The search query to research.                                            |
| limit                       | integer          | No       | 30      | The maximum number of results to return.                                 |
| hard\_filter\_company\_urls | array of strings | No       |         | A list of company LinkedIn URLs to filter results to specific companies. |

### Response

```json theme={null}
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Deep research job initiated"
}
```

## Error Responses

| Status Code | Description                               |
| ----------- | ----------------------------------------- |
| 401         | Unauthorized - API key missing or invalid |
| 402         | Payment Required - Insufficient credits   |

## Rate Limits

Rate limits vary by subscription tier:

* **Free Tier**: 2 requests per minute
* **Tier 1**: 5 requests per minute
* **Tier 2**: 50 requests per minute
* **Tier 3**: 100 requests per minute

## Notes

* Deep research jobs can take several minutes to complete.
* The `job_id` returned in the response is used to check the status of the research.
* Each validated profile returned costs 1 credit.


## OpenAPI

````yaml POST /api/search/deep_research
openapi: 3.1.0
info:
  title: Clado Search & Enrichment API
  description: API for searching LinkedIn profiles and enriching contact information
  version: 1.0.0
servers:
  - url: https://search.clado.ai
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/search/deep_research:
    post:
      tags:
        - Deep Research
      summary: Initiate Deep Research
      description: >-
        Start deep research job. Each profile costs 1 credit. Rate limits vary
        by tier: 2/min (free), 5/min (Tier 1), 50/min (Tier 2), 100/min (Tier
        3).
      operationId: initiateDeepResearch
      requestBody:
        required: true
        description: Deep research parameters including search query and optional settings
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeepResearchRequest'
      responses:
        '200':
          description: Job initiated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeepResearchJobResponse'
components:
  schemas:
    DeepResearchRequest:
      type: object
      properties:
        query:
          type: string
          description: >-
            Natural language search query for deep research (required if
            criteria and opensearch_query are not provided)
        limit:
          type: integer
          default: 30
          description: Maximum number of profiles to research
    DeepResearchJobResponse:
      type: object
      properties:
        job_id:
          type: string
        status:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Keys start with 'lk_'.

````