Skip to main content
GET
/
search
Search
curl --request GET \
  --url https://api.example.com/search
Posture: WorkOS-authenticated internal beta. The caller must resolve to a mapped TattooAPI actor before access is granted.

​
Auth

The current runtime requires authentication for GET /search. 
curl "$TATTOO_API_BASE_URL/search?q=traditional&type=studio&limit=5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Query Parameters

ParameterTypeNotes
qstringOptional search text
typestringartist, studio, design, or all
city, state, countrystringLocation filters
latitude, longitude, radiusnumberGeographic filters
styles, specialtiesstringComma-separated filters
min_ratingnumberMinimum rating
verified_onlybooleanOnly verified results
page, limitnumberPagination
sort_by, sort_orderstringResult ordering
include_facetsbooleanInclude facet counts

​
Response Shape

{
  "success": true,
  "data": {
    "results": [
      {
        "type": "studio",
        "id": "uuid",
        "name": "Ink Masters Studio",
        "description": "Premier tattoo studio",
        "rating": 4.8,
        "review_count": 127,
        "verified": false,
        "styles": [],
        "specialties": [],
        "location": {
          "city": "Los Angeles",
          "state": "CA",
          "country": "United States"
        },
        "relevance_score": 19.9,
        "provenance": {
          "recordState": "normalized",
          "sourceType": "directory_scrape",
          "originAuthority": "system_inference",
          "sourceUrl": null,
          "sourceCollectedAt": null,
          "licenseStatus": "rights_unknown",
          "consentLevel": "recommendation_only",
          "sourceNotes": []
        },
        "trust": {
          "verificationStatus": "unverified",
          "approvalStatus": "draft",
          "visibility": "public",
          "culturalSensitivityLevel": "none",
          "trustNotes": []
        }
      }
    ],
    "total": 1,
    "pagination": {
      "page": 1,
      "limit": 20,
      "total_pages": 1,
      "has_next": false,
      "has_prev": false
    }
  }
}
Search is one of the first endpoints that should become ontology-aware in practice. The current runtime shape is still tied to legacy tables, but the docs now describe that shape accurately.