API v1 — Live

InkFreakz
Developer API

Access verified tattoo artists, shops, and tattoo posts from the InkFreakz platform. Add real tattoo data to your website, app, or directory in minutes.

Verified artists only 1,000 requests/day free JSON responses No OAuth required
Verified Artists
Verified Shops
Tattoo Posts
Tattoo Styles
Overview
Everything you need to start using the InkFreakz API.

The InkFreakz Public API provides read-only access to verified tattoo artists, shops, and tattoo posts. All data is sourced directly from the InkFreakz platform and only includes verified accounts.

Base URL
https://inkfreakz.com/api/v1
Verified Only
Every artist and shop returned by the API has been manually verified by the InkFreakz team.
Simple Auth
No OAuth flows. Just include your API key in a single header and you're ready to go.
JSON Responses
All responses are clean JSON with consistent structure, pagination metadata, and rate limit headers.
Authentication
How to authenticate your API requests.

All authenticated endpoints require an API key passed in the X-InkFreakz-Key request header. You can also pass it as a query parameter ?api_key=your_key for testing.

Example Request Header
GET /api/v1/artists HTTP/1.1
Host: inkfreakz.com
X-InkFreakz-Key: ifz_your_api_key_here
Accept: application/json
Keep your API key private. Do not expose it in client-side JavaScript or public repositories.
Rate Limits
Request quotas and how to handle them.
TierRequests/DayPrice
Free1,000Free forever
Partner10,000Contact us
PremiumUnlimitedContact us

Rate limit headers are included in every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1745625600

When exceeded, the API returns HTTP 429 with a JSON error body.

Error Codes
Standard HTTP error responses.
CodeMeaning
401Missing or invalid API key
404Resource not found (e.g., artist username doesn't exist)
422Validation error (e.g., missing required field)
429Rate limit exceeded
500Server error — contact support@inkfreakz.com
Endpoints
All endpoints are prefixed with https://inkfreakz.com/api/v1
GET /stats Platform statistics — no auth required

Returns live platform statistics. No API key required — useful for embedding stats widgets.

Example Response
{
  "success": true,
  "data": {
    "verified_artists": 28,
    "verified_shops": 3,
    "total_tattoos": 361,
    "total_styles": 131,
    "platform": "InkFreakz",
    "platform_url": "https://inkfreakz.com"
  }
}
GET /artists List verified artists

Returns a paginated list of verified tattoo artists. Supports filtering by style, location, and name search.

Query Parameters
ParameterTypeDescription
q optionalstringSearch by name or username
style optionalstringFilter by tattoo style (e.g., "realism")
location optionalstringFilter by city or state
page optionalintegerPage number (default: 1)
per_page optionalintegerResults per page (default: 20, max: 100)
Example Response
{
  "success": true,
  "meta": { "total": 28, "page": 1, "per_page": 20, "pages": 2 },
  "data": [
    {
      "id": 248,
      "username": "inkmaster_jay",
      "display_name": "Jay Torres",
      "type": "artist",
      "verified": true,
      "bio": "Specializing in realism and portrait work...",
      "location": "Austin, TX",
      "primary_style": "Realism",
      "specialties": ["Portrait", "Blackwork"],
      "years_experience": 8,
      "hourly_rate": 150,
      "rating": 4.9,
      "profile_picture": "https://inkfreakz.com/uploads/profiles/...",
      "profile_url": "https://inkfreakz.com/artist/inkmaster_jay",
      "social": { "instagram": "https://instagram.com/inkmaster_jay" },
      "verified_at": "2026-01-15T10:30:00Z"
    }
  ]
}
GET /artists/{username} Single artist with portfolio

Returns a single verified artist's full profile including their 12 most recent portfolio tattoos.

Path Parameters
ParameterTypeDescription
username requiredstringThe artist's InkFreakz username

Response includes all fields from the list endpoint, plus a portfolio array of up to 12 tattoo objects.

GET /shops List verified shops

Returns a paginated list of verified tattoo shops.

ParameterTypeDescription
q optionalstringSearch by shop name or username
location optionalstringFilter by city or state
page optionalintegerPage number
per_page optionalintegerResults per page (max: 100)
GET /shops/{username} Single shop with affiliated artists

Returns a single verified shop's profile including affiliated verified artists.

Response includes all shop fields plus an artists array of affiliated verified artists.

GET /tattoos Browse tattoo posts

Returns public tattoo posts from verified artists. Supports filtering and sorting.

ParameterTypeDescription
style optionalstringFilter by tattoo style
artist optionalstringFilter by artist username
color_type optionalstringcolor or black_grey
featured optionalbooleanOnly return featured tattoos
sort optionalstringrecent (default), popular, trending, views
page optionalintegerPage number
per_page optionalintegerResults per page (max: 100)
GET /styles All tattoo styles — no auth required

Returns all 131 active tattoo styles. Useful for building filter UIs. Requires API key.

{
  "success": true,
  "data": [
    { "id": 1, "name": "American Traditional", "category": "General" },
    { "id": 2, "name": "Blackwork", "category": "General" },
    ...
  ]
}
Live Demo
Try the API directly in your browser using your API key.
Code Examples
Ready-to-use snippets in popular languages.
// Fetch verified artists using the InkFreakz API
const API_KEY = 'ifz_your_api_key_here';
const BASE_URL = 'https://inkfreakz.com/api/v1';

async function getArtists(style = null, location = null) {
  const params = new URLSearchParams({ per_page: 20 });
  if (style) params.set('style', style);
  if (location) params.set('location', location);

  const response = await fetch(`${BASE_URL}/artists?${params}`, {
    headers: {
      'X-InkFreakz-Key': API_KEY,
      'Accept': 'application/json'
    }
  });

  const data = await response.json();
  return data.data; // Array of artist objects
}

// Search for realism artists in Austin
const artists = await getArtists('realism', 'Austin');
artists.forEach(artist => {
  console.log(`${artist.display_name} — ${artist.profile_url}`);
});
Widget & Embed
Add a live tattoo artist finder to any website in minutes — no backend required.
Live Demo — TattooFindr
This is what the embed looks like on a real site. tattoofindr.io is built entirely on the InkFreakz API.

Choose your preferred integration method and paste the code into your site.

The drop-in JavaScript widget renders a fully functional artist search inside any <div> on your page. Works on WordPress, custom sites, and any HTML page.

HTML
<!-- TattooFindr Widget -->
<div data-tattoofindr-widget
     data-api-key="YOUR_API_KEY"
     data-location="Miami"
     data-style="Realism"
     data-limit="6"
     data-theme="dark">
</div>
<script src="http://tattoofindr.io/widget.js"></script>
Widget Attributes
Attribute Example Description
data-api-keyrequiredYour InkFreakz API key
data-location"Miami"Pre-filter by city, state, or country
data-style"Realism"Pre-filter by tattoo style
data-limit"6"Number of results to show (default: 9)
data-theme"dark""dark" or "light" theme
data-search"true"Show search bar (default: true)
Live Preview
Tattoo Blogs & Magazines
Add a "Find an Artist Near You" widget in your sidebar. Readers stay on your site and find verified artists.
City & Local Directories
Embed a pre-filtered widget showing only artists in your city. Zero maintenance — data updates automatically.
Tattoo Shops
Showcase your shop's verified artists directly on your own website with live portfolio data.
Get Your API Key
Free to start. 1,000 requests per day. No credit card required.
Pricing & Tiers
Start free. Scale as you grow. All tiers include full API access to verified artists, shops, and tattoos.
Free
$0
per month
  • 1,000 requests/day
  • All read endpoints
  • Artist & shop search
  • Community support
Get Free Key
Starter
$19
per month
  • 10,000 requests/day
  • All read endpoints
  • Artist & shop search
  • Email support
Get Starter
POPULAR
Pro
$49
per month
  • 100,000 requests/day
  • All read endpoints
  • Priority support
  • Usage analytics dashboard
Get Pro
Enterprise
Custom
contact us
  • Unlimited requests
  • Dedicated support
  • Custom SLA
  • White-label options
Contact Us
All plans include access to verified artists, shops, tattoos, and styles. Rate limits reset daily at midnight UTC. Starter and Pro plans require contacting api@inkfreakz.com to upgrade your existing key.
Enterprise
Need unlimited access, a custom SLA, or white-label integration? Let's talk.

Enterprise Benefits

  • Unlimited API Requests
    No daily caps. Scale to millions of requests.
  • Dedicated Account Manager
    Direct line to our team for integration support.
  • Custom SLA
    Guaranteed uptime and response time commitments.
  • White-Label Options
    Remove InkFreakz branding for fully embedded experiences.
  • Advanced Analytics
    Full dashboard showing your API usage and artist reach.

Contact Enterprise Sales