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

# Societe Info

> Access French company and contact data with Societe Info

Societe Info is a B2B data platform specializing in French company information, providing detailed firmographic data, financials, and contact information.

## Authentication

Connect to Societe Info using your API key.

### Connection details

| Field       | Description               |
| ----------- | ------------------------- |
| **API key** | Your Societe Info API key |

***

## Societe Info actions

### Enrich

Retrieve detailed information about a company or contact.

**Object types**

| Type        | Description                      |
| ----------- | -------------------------------- |
| **Company** | Enrich company by various fields |
| **Contact** | Enrich contact by various fields |

**Company enrich fields**

| Field               | Description                     |
| ------------------- | ------------------------------- |
| Name                | Company name                    |
| Street              | Street address                  |
| Postal code         | Postal code                     |
| City                | City                            |
| Domain name         | Domain or website URL           |
| Email               | Email address                   |
| First/Last name     | Representative's name           |
| LinkedIn URL        | Company or profile LinkedIn URL |
| Registration number | SIREN/SIRET number              |

**Contact enrich fields**

| Field               | Description              |
| ------------------- | ------------------------ |
| First/Last name     | Contact's name           |
| Full name           | First name and last name |
| Company name        | Company name             |
| Domain name         | Domain or website URL    |
| Email               | Email address            |
| LinkedIn URL        | LinkedIn profile URL     |
| Registration number | Company SIREN/SIRET      |

### Search

Search for companies or contacts with advanced filtering.

**Company search filters**

| Filter Category  | Available Filters                         |
| ---------------- | ----------------------------------------- |
| **Basic**        | Query, search mode, page number           |
| **Location**     | Place ID, postal code, city               |
| **Industry**     | NAF codes (include/exclude)               |
| **Financials**   | Sales range, profits range                |
| **Size**         | Staff count range                         |
| **Dates**        | Creation date, CEO birthdate              |
| **Social**       | LinkedIn followers range                  |
| **Data quality** | Has website, phone, email, LinkedIn, etc. |

**Contact search filters**

| Filter             | Description                |
| ------------------ | -------------------------- |
| **SIREN**          | Company SIREN (required)   |
| **Contact level**  | Responsibility level codes |
| **Contact domain** | Activity domain codes      |
| **Contact role**   | Semantic query on roles    |

***

## Credits

| Action | Cost                 |
| ------ | -------------------- |
| Enrich | 4 credits            |
| Search | 4 credits per result |

***

## Use cases

<AccordionGroup>
  <Accordion title="French market research" icon="flag">
    Build targeted lists of French companies by industry and size.
  </Accordion>

  <Accordion title="Financial analysis" icon="chart-line">
    Filter companies by revenue, profits, and growth metrics.
  </Accordion>

  <Accordion title="Contact discovery" icon="users">
    Find decision-makers at target French companies.
  </Accordion>
</AccordionGroup>

***

## Best practices

1. **Use SIREN** - The registration number provides the most accurate company matching
2. **Filter by data quality** - Use withEmail, withPhone filters to ensure actionable data
3. **Leverage financial filters** - Target companies in specific revenue ranges