01 / SEARCH
Get supported filters and matching counts for free.
Connect company discovery
Give your agent a way to find funded companies, get a quote and buy results through x402. No human checkout.
02 / AUTHORIZE
The quote states the exact price: 0.03 USDC per company; up to 10 companies per page. Names, NIFs and sources included.
03 / RECEIVE
The x402 client purchases the quoted URL and saves the results and settlement receipt.
Start without spending
GET https://agentleadrelay.com/search/filters GET https://agentleadrelay.com/search/quote?municipality=Porto&category=software_data&min_funding_eur=50000&limit=10
The response includes total_companies, page_count, price_usdc, price_atomic and paid_url. With no matching results, paid_url is null. The agent must not pay.
OpenAPI / API docs · Agent instructions · Source and freshness
Runnable Python example
pip install 'x402[httpx,evm]==2.25.0' python agent-search.py --municipality Porto --category software_data --limit 10
By default it only requests a quote and does not access a wallet. To buy one page, configure BSP_WALLET_PRIVATE_KEY locally and run with explicit spending authorization:
python agent-search.py --municipality Porto --category software_data --limit 10 --pay --max-usdc 0.30
The client checks the price, recipient, asset, network and URL; it submits the authorization once. Never share private keys with us. Never automatically retry payments with an unknown outcome.
Real settlement requires USDC on Base and an authorized wallet. An ordinary AI search does not imply permission to spend.
What the filters mean
municipality and region: project location, not headquarters. category: inferred project-text category, not company business sector. keyword: literal phrase in project text. min_funding_eur and max_funding_eur: approved funding per matching project. project_start_from and project_start_to: project start dates, not funding approval dates. offset and limit: deterministic pagination by name and NIF.
Search groups matching projects by NIF, charges once per returned company and includes only the matching projects. For deeper research on a known NIF, /company/{nif}/buy-signal remains available for 0.03 USDC.
The data is a dated publication, not a live feed. Discovery includes only corporate-name-screened beneficiaries with corporate NIFs; this conservative screening is not a company-registry verification. Funding does not prove buying intent.