# ParuVendu Immobilier Agency API Documentation

<p><strong>ParuVendu Immobilier Agency API</strong> returns the profile of one agency as JSON: name, headline with city and department, presentation text, address, coordinates, logo, website, SIRET number and the number of listings it publishes.</p><p>Notes: Pass the <code>slug</code> of the <code>agency</code> object of a search item or listing. The phone number is not returned. The listings of the agency are not part of this route: filter the search results by <code>agency.slug</code>.</p>

- **Documentation:** [https://scrappa.co/docs/paruvendu-immo-api/paruvendu_immo_agency](https://scrappa.co/docs/paruvendu-immo-api/paruvendu_immo_agency)
- **API group:** ParuVendu Immobilier API
- **Endpoint:** `GET https://scrappa.co/api/paruvendu-immo/agency`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `slug` | string | Yes | The agency.slug of a search item or listing. Example: locservice-vannes-56-129319. |

## Example response

```json
{
    "data": {
        "url": "https://www.paruvendu.fr/immobilier/pro/locservice-vannes-56-129319/",
        "name": "LOCService",
        "slug": "locservice-vannes-56-129319",
        "siret": "41443819200075",
        "address": {
            "city": "Vannes",
            "street": "12 RUE HENRI BECQUEREL",
            "country": "FR",
            "postal_code": "56000"
        },
        "website": "https://www.locservice.fr/affiliations/?Partner=paruvendu",
        "headline": "Agence immobili\u00e8re \u00e0 Vannes (56)",
        "latitude": 47.64386,
        "logo_url": "https://media.paruvendu.fr/media-logo/logo4c236571707292368_grand.jpg",
        "longitude": -2.753564,
        "description": "Sp\u00e9cialiste de la location et de la colocation entre particuliers, LocService a invent\u00e9 il y a plus de 20 ans le concept de mise en relation invers\u00e9e.\nAvec LocService.fr, aucun frais d'agence, le locataire ou colocataire renseigne sa demand",
        "listing_count": 6543,
        "description_title": "Location et colocation entre particuliers"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | The listing, agency, place or result page does not exist, or the filters match nothing. This response is not billable. |
| 503 | Upstream Unavailable | ParuVendu Immobilier could not be reached. This response is not billable and is retryable. |
| 503 | Unexpected Upstream Data | ParuVendu Immobilier returned data in an unexpected shape. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)