Match API

Match a company name to domain profiles. Returns ranked candidates with confidence scores. For bulk matching, see Match Bulk. To enrich matched domains with firmographic data, use BizData or Append.

GET https://api.discolike.com/v1/match

Parameters

Parameter	Description
name	Company name to match (required). Must be non-empty after whitespace and punctuation are stripped
country	ISO-3166-1 alpha-2 country code
state	US state code
city	City name
zip_code	Zip code
phone	Phone in E.164 or local format
min_match_confidence	Minimum match_confidence (inclusive) a match must have, 50-100 (default 50)

Matches with match_confidence below 50 are never returned; min_match_confidence raises this floor.

Response Fields

Field	Type	Description
query	Object	Query parameters used
matches	Array	BizData profiles with match_confidence

Each match includes match_confidence (0-100) indicating how well it matches the query.

Errors

Status	Meaning
204	No company matched the query
503	The search backend could not be reached after retries — retry the request; this is not a no-match

Examples

Request

curl "https://api.discolike.com/v1/match?name=acme+software&country=US" \
  -H "x-discolike-key: API_KEY"

Response

{
  "query": { "name": "acme software", "country": "US" },
  "matches": [
    {
      "domain": "acmesoftware.com",
      "name": "Acme Software Inc",
      "match_confidence": 100,
      "score": 250,
      "address": { "state": "CA", "country": "US" }
    }
  ]
}