# HelpMyAgent French Company Search

> HelpMyAgent French Company Search is a paid API for AI agents from api.helpmyagent.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-17).

Searches French companies by name, SIREN, SIRET, or location and returns structured matching company records.

## Facts

- Endpoint: POST https://api.helpmyagent.com/v1/company/fr/search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/helpmyagent-french-company-search-710423fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f7kas2ZvFv2bhcHT1LI44

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability helpmyagent-french-company-search-710423fd -d '<json body>'
```

Example prompt: Can you look up the French company 'Carrefour' and get me its SIREN number and registered address?

## When to prefer this

Use this endpoint when you need to look up or verify French companies specifically, especially when you have a company name, SIREN, or SIRET to search by. Prefer this over generic business search APIs when working with French legal entities, supplier verification, or compliance workflows that require structured official French registry data.

## Known failure modes

- No matching companies found for the given query — returns empty results array
- Ambiguous company name returns multiple records requiring further filtering
- Invalid SIREN or SIRET format causes a validation error
- Rate limiting or payment failure via x402 protocol returns 402 status
- Network timeout if the underlying French registry data source is slow

## How this service works

Searches French companies by name, SIREN, SIRET or optional location criteria and returns structured matching company records.

## Output

Returns structured company records matching the search criteria, including fields such as company name, SIREN, SIRET, registered legal address, legal form (e.g. SARL, SAS), NAF/APE activity code, and other official registration data from the French business registry.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/helpmyagent-french-company-search-710423fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.helpmyagent.com](https://www.zero.xyz/host/api.helpmyagent.com/llms.txt)
