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

# Search Bodacc

> Extract ads result from a Bodacc.fr search.

To extract advertisement results from a Bodacc.fr search, follow the steps below to ensure you generate a valid search URL and configure the API parameters effectively.

<Steps>
  <Step title="Navigate to Bodacc.fr">
    Go to [https://www.bodacc.fr/annonce/liste](https://www.bodacc.fr/annonce/liste). Use the filters to refine your
    search, such as selecting a category to find newly created companies.
  </Step>

  <Step title="Execute the Search">
    Click the <code>Lancer la recherche</code> button to perform the search.
  </Step>

  <Step title="Generate a Valid URL">
    Click on the second page of the search results. This action generates a new
    URL with parameters that can be used for the API.
  </Step>

  <Step title="Copy the New URL">
    Copy the newly generated URL, which includes the necessary parameters for
    the API.
  </Step>
</Steps>

### Inputs

<ParamField path="bodacc_search_url" type="string" required={true} placeholder="Bodacc Search URL">
  The URL generated from a Bodacc.fr search, including necessary parameters.
</ParamField>

### Parameters

<ParamField path="max_results" type="number" default={500}>
  The maximum number of results per input to iterate for each search, with a
  system limit of 500.
</ParamField>

<ParamField path="max_days" type="number" default={0} maximum={10000}>
  Specifies the maximum number of days from which data will be extracted. If set
  to 0, this setting is disabled.
</ParamField>

### Output Fields

The API returns the following fields:

<ResponseField>
  <Expandable title="properties">
    <ResponseField name="announced_at" type="string">
      The date the ad was announced.
    </ResponseField>

    <ResponseField name="bodacc_ad_url" type="string">
      The URL of the Bodacc ad.
    </ResponseField>

    <ResponseField name="category" type="string">
      The category of the ad.
    </ResponseField>

    <ResponseField name="department" type="string">
      The department related to the ad.
    </ResponseField>

    <ResponseField name="name" type="string">
      The name associated with the ad.
    </ResponseField>

    <ResponseField name="published_date" type="string">
      The date the ad was published.
    </ResponseField>

    <ResponseField name="rcs" type="string">
      The RCS (Registre du Commerce et des Sociétés) number.
    </ResponseField>

    <ResponseField name="ref" type="string">
      The reference number of the ad.
    </ResponseField>
  </Expandable>
</ResponseField>

Below is the JSON schema for the output fields:

<Accordion title="Show JSON Output Schema">
  ```json
  {
    "announced_at": "string",
    "bodacc_ad_url": "string",
    "category": "string",
    "department": "string",
    "name": "string",
    "published_date": "string",
    "rcs": "string",
    "ref": "string"
  }
  ```
</Accordion>