Rank markets for a buyer persona and trade (the recommendation engine). Costs 80 credits per call (deep); the response carries X-ATI-Credits-Charged and X-ATI-Credits-Remaining. Enterprise labor module only.

get/v1/recommend

Request

  • Base URL: https://api.americantradesindex.com
  • URL: https://api.americantradesindex.com/v1/recommend
  • Auth: HTTP bearer

Query parameters

personaunknown required

operator | investor | staffing | distributor | government

tradestring required

Trade key: electrical, plumbing, hvac, fire_sprinkler, sheet_metal, elevator, boiler, well_drilling, appliance, electrical_sign

candidatestring

Comma-separated 5-digit FIPS to rank among

statestring

Two-letter state (TX) or a metro key (NYC)

limitinteger

Rows to return (max 50)

Response

markets[] with score and drivers

Changes

No recorded changes to this operation across all 1 revision of this API.