API Documentation

The SMM Deal Finder API is a private API. This documentation is public, but API access is granted on demand only. If you would like to use the API, contact us at support@smmdealfinder.com and we will review your use case and issue an API key.

Authentication

All requests are authenticated with your API key as a Bearer token. Requests without a valid key, or from accounts without an active subscription, are rejected with 401 Unauthorized.

Authorization: Bearer YOUR_API_KEY

Fetch Niche Finder Leads

Searches local businesses for a niche in a given city, adds them as contacts to your SMM Deal Finder account and returns them in the response. Results are deduplicated by email against your existing contacts.

POST https://smmdealfinder.com/api/v1/niche-finder-leads

Request Body

The pixel filters (metaAds, tiktokPixel, gAnalytics) are based on our own scan of each business’s website. The scan detects tracking codes embedded directly in the page as well as ones loaded through Google Tag Manager containers, so it finds more pixels than a simple check of the page source. Passing false returns only businesses whose website we scanned and found clean — businesses without a scannable website are excluded rather than treated as not tracking.

Example Request

curl -X POST https://smmdealfinder.com/api/v1/niche-finder-leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "niche": "dentist",
    "city": "Austin",
    "count": 100,
    "metaAds": true
  }'

Response

On success the endpoint returns the fetched contacts and the number of credits charged. Each contact includes the business name, address, website, email addresses, phone numbers, social profiles, detected tracking pixels and Google Business categories where available.

{
  "contacts": [
    {
      "businessName": "Smile Dental Austin",
      "address": "123 Congress Ave, Austin, TX 78701",
      "website": "https://smiledentalaustin.com",
      "email": "office@smiledentalaustin.com",
      "emails": ["office@smiledentalaustin.com"],
      "phone": "+15125550142",
      "phone_numbers": ["+15125550142"],
      "instagram": "https://instagram.com/smiledentalaustin",
      "facebook": "https://facebook.com/smiledentalaustin",
      "linkedin": null,
      "tiktok": null,
      "fbPixel": true,
      "tikTokPixel": false,
      "gAnalytics": true,
      "googleBusinessCategories": ["Dentist", "Cosmetic dentist"]
    }
  ],
  "chargedCredits": 87
}

Fetching large lead counts can take several minutes, so make sure your HTTP client uses a generous timeout.

Credits

Each lead costs one credit from your SMM Deal Finder account. Credits are only charged for contacts that were actually added to your account: if fewer leads are found than requested, or some are duplicates of existing contacts, the difference is refunded automatically. If the request fails, no credits are charged.

Error Responses

Getting Access

API access is granted on request. Contact us at support@smmdealfinder.com with a short description of your use case to receive an API key.