# x402-farm Business Location Opportunity Score (France)

> x402-farm Business Location Opportunity Score (France) is a paid API for AI agents from x402-farm.vercel.app, paid per call via x402, $0.12/call, status unknown (last checked 2026-09-14).

Returns a business implantation opportunity score for a French commune, including active competitor count and inhabitants-per-competitor ratio.

## Facts

- Endpoint: GET https://x402-farm.vercel.app/v1/fr/etude-implantation
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-farm-business-location-opportunity-score-france-4ce30cef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_debMt5jPeTm2JOdB2Iz5O

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 x402-farm-business-location-opportunity-score-france-4ce30cef
```

Example prompt: Can you check the business implantation opportunity score for Pointe-à-Pitre? I want to know how saturated the market is there and how many residents each competitor serves.

## When to prefer this

Use this endpoint when you need a fast, pre-computed market opportunity signal for a French commune without building your own competitor dataset. It is ideal for agents doing location scouting, franchise territory planning, or expansion triage across French towns. Prefer this over scraping local business directories when you need a single structured score and competitor density figure in one low-cost API call.

## Known failure modes

- Payment not received — endpoint returns HTTP 402 requiring USDC payment on Base before data is returned
- Unsupported or unrecognized commune — may return empty or error response
- Rate limiting or upstream data unavailability — service may return 5xx
- No queryParams defined — endpoint takes no additional filter parameters, so results are fixed per call

## How this service works

Pay-per-call APIs for AI agents — x402 protocol, USDC on Base, no account needed.

## Output

A JSON object containing: the commune name, a numeric opportunity score (0–100 scale indicating market attractiveness), the count of currently active competitors in the area, and the number of inhabitants per competitor — giving a quick read on market saturation and demand availability.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "commune": "Pointe-à-Pitre",
  "score_opportunite": 45,
  "concurrents_actifs": 56,
  "habitants_par_concurrent": 268
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-farm-business-location-opportunity-score-france-4ce30cef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-farm.vercel.app](https://www.zero.xyz/host/x402-farm.vercel.app/llms.txt)