NamePico

API reference

Free domain evidence APIs for developers and AI agents. No account or API key is required. Responses use the same fact layer as the web report.

For MCP tool order, evidence semantics, and machine-readable entry points, start with the NamePico developer guide. This page is the complete REST and curl reference.

Read this first

Every conclusion has boundaries. Public data cannot provide formal trademark clearance or a registrar's private risk decision, and registry availability does not guarantee that a registrar can complete an order. Preserve unknown, unverified, and partial-coverage states when presenting results.

GET/api/d/{domain}

Complete evidence report for one domain: registry status, orderability, prices, history, blocklists, public-name collisions, brand evidence, similar domains, use-case views, and explicit unknowns. Read obtainable and advice before interpreting verdict.score.

curl https://namepico.com/api/d/namepico.com

GET/api/d/{domain}.txt

Plain-text representation of the same report for terminals, logs, and text-only agent environments.

curl https://namepico.com/api/d/namepico.com.txt

GET/api/n/{name}

Compare one name across commonly used TLDs. This endpoint covers TLD-level registry state, price references, and recommendations; use the single-domain report for history, security, and brand evidence.

curl https://namepico.com/api/n/namepico

POST/api/v1/domains/check

Batch registry screening: up to 20 names × 3 TLDs, or 60 complete domains. Set include_price=true to verify domain-specific pricing for up to 10 available finalists. unknown does not mean available; unverified does not mean standard price.

curl -X POST https://namepico.com/api/v1/domains/check \
  -H 'content-type: application/json' \
  -d '{"names":["namepico","namelens"],"tlds":["com","dev"]}'

curl -X POST https://namepico.com/api/v1/domains/check \
  -H 'content-type: application/json' \
  -d '{"domains":["namepico.com"],"include_price":true}'

GET/check/{domain,domain}

Path-style alias for agents that cannot POST or send query parameters. Returns plain text by default; append .json for JSON. Use the POST endpoint for price verification.

curl https://namepico.com/check/namepico.com,namelens.dev
curl https://namepico.com/check/namepico.com,namelens.dev.json

POST/api/v1/names/overlap

Deterministic overlap naming: join the non-empty suffix of A to the matching prefix of B without duplicating the overlap. It is a string rule and pronunciation heuristic, not semantic or brand analysis.

curl -X POST https://namepico.com/api/v1/names/overlap \
  -H 'content-type: application/json' \
  -d '{"roots":["invest","study"],"min_length":6,"max_length":9,"min_overlap":2}'

GET/names/overlap/{root,root}

Path-style alias using the default length range of 6–9 and minimum overlap of 2. Plain text by default; append .json for JSON.

curl https://namepico.com/names/overlap/invest,study
curl https://namepico.com/names/overlap/invest,study.json

Alternative machine-readable paths

/report/{domain} returns plain text by default and JSON with .json. /matrix/{name}.json returns the same name-matrix data. These aliases use the same limits and evidence layer.

curl https://namepico.com/report/namepico.com
curl https://namepico.com/matrix/namepico.json

Machine-readable documentation

  • /openapi.json — OpenAPI 3.1 schema
  • /llms.txt — capabilities, boundaries, and recommended call order
  • Domain report pages expose JSON and text alternatives in rel=alternate and embed the report as application/json in the HTML.

Limits and privacy

Single-domain sources allow 8 requests per minute and up to 30 detail reports per hour. Batch quota is 300 domains per IP per hour, with 60 domains per request and at most 10 price verifications. Name overlap allows 30 requests per minute. On 429, respect retry-after.

Candidate names are not stored in the application database. Dynamic report and query routes are excluded from search indexing so user research does not become a searchable public list.

Need help with an endpoint or field? Send feedback using the Chinese form.