You can access the Social Media Lead Finder – Find Interested People in Real-Time programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "ceA1we0gMZRXdIofk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lofomachines~fresh-lead-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lofomachines-fresh-lead-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/lofomachines~fresh-lead-finder/runs": {
      "post": {
        "operationId": "runs-sync-lofomachines-fresh-lead-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/lofomachines~fresh-lead-finder/run-sync": {
      "post": {
        "operationId": "run-sync-lofomachines-fresh-lead-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "mode",
          "market"
        ],
        "properties": {
          "mode": {
            "title": "Search Mode",
            "enum": [
              "looking_for",
              "alternative_to"
            ],
            "type": "string",
            "description": "**Looking For** — finds posts from people actively searching for your service or product.\n\n**Alternative To** — finds posts from people frustrated with a competitor and seeking alternatives.\n\nThe right intent phrase is selected automatically based on the market's language.",
            "default": "looking_for"
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "What you're looking for. In **Looking For** mode, the service / product you sell (e.g. `plumber`, `CRM`, `marketing agency`). In **Alternative To** mode, the competitor / brand / tool you want to displace (e.g. `HubSpot`, `Salesforce`)."
          },
          "location": {
            "title": "Location (optional)",
            "type": "string",
            "description": "City, region or country to embed in the queries (e.g. \"New York\", \"London\", \"Milano\"). Leave empty for a location-agnostic search."
          },
          "market": {
            "title": "Target Market / Language",
            "enum": [
              "global",
              "us",
              "uk",
              "ca",
              "au",
              "it",
              "es",
              "latam",
              "br",
              "fr",
              "de",
              "nl",
              "pt",
              "sg",
              "cn",
              "dk",
              "fi",
              "no",
              "pl",
              "se"
            ],
            "type": "string",
            "description": "Selects the country & language used for the search. Each market scans the same set of public platforms using its native intent phrase.",
            "default": "global"
          },
          "afterDate": {
            "title": "Only posts after this date",
            "type": "string",
            "description": "Restrict results to public posts **published after** this date. Leave empty to scan the full archive. Pick a recent date (e.g. last 30–60 days) for real-time, actionable leads."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Social Media Lead Finder – Find Interested People in Real-Time OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Social Media Lead Finder – Find Interested People in Real-Time from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Social Media Lead Finder – Find Interested People in Real-Time API in Python

Social Media Lead Finder – Find Interested People in Real-Time API in JavaScript

Social Media Lead Finder – Find Interested People in Real-Time API through CLI

Social Media Lead Finder – Find Interested People in Real-Time API

Extract contacts & social links from any site

lofomachines/contact-extractor

Paste one or more website URLs and get every email address, phone number, and social media profile delivered in a clean, ready-to-use spreadsheet.

Lofomachines

10x Cheaper Google Maps Scraper

placesdata/google-maps-scraper-fast-cheap

$0,4/1k results. Get Google Maps business data — phone, website, rating, address, GPS, Maps URL — for any niche and location. No Cookies Required. Results in seconds. Automatically deduplicates results and resolves location. Ideal for building lead lists for web design, local SEO, and cold outreach.

Ondra Lipovsky

4.7

Linktree Advanced Lead Scraper (Category & Subcategory)

ahmed_jasarevic/linktree-advanced-lead-scraper

Advanced Linktree scraper that extracts profiles from category and subcategory directories, collects emails, social links, bio data, and profile metadata. Supports pagination, proxy rotation, and large-scale lead extraction from Linktree discovery pages.

Ahmed Jasarevic

5.0

YouTube Transcript Scraper – JSON, SRT, VTT, Plain Text

scraperhive/youtube-transcript-scraper

Extract YouTube video transcripts, subtitles, and captions in multiple formats with precise timestamps. Plain Text · JSON · SRT · WebVTT · 20+ Languages · Batch Processing · Auto + Manual Captions

Mubeen Ali

5.0

Ctrip / Trip.com Hotel Scraper - Prices, Ratings & Availability

thirdwatch/ctrip-hotels-scraper

Scrape hotel listings from Trip.com (Ctrip): names, nightly prices, ratings, reviews, location, star class, amenities, photos. Supports city, check-in/out dates, guests, and rooms.

Thirdwatch

Linktree, Beacons & Bio Email Scraper: Extract Leads

ahmed_jasarevic/linktree-beacons-bio-email-scraper-extract-leads

Turn Linktree, Beacons and Bio URLs into real Email Leads. Scrape contact info, social handles, and affiliate links from Linktree, Beacons and influencers profiles automatically.

Ahmed Jasarevic

167

5.0

G2 Reviews Scraper · Battlecards + Switching Data

factden/g2-reviews-scraper

G2 reviews scraper for battlecards, competitor intel, and AI/RAG pipelines. 32 fields per review: 6 sub-ratings, switched-from competitors, structured pros/cons, LLM-ready markdown. Top 10 competitors auto-ranked per product. Handles anti-bot. $4 per 1,000 reviews.

FactDen

5.0

Bark Phone Number Scraper

contacts-api/bark-phone-number-scraper

Generate service provider leads with our Bark Phone Number Scraper. Extract public phone numbers from Bark profiles for outreach and sales.

Lead Heaven

Bark Email Scraper - Advanced, Fast & Cheapest

contacts-api/bark-email-scraper-fast-advanced-and-cheapest

🐶 Bark Email Scraper allows you to extract pet brand and business emails from Bark listings 🔎 Grow pet industry outreach 📧

Lead Heaven

Bark Email Scraper

scraper-mind/bark-email-scraper-fast

Bark email scraper to extract emails from Bark service provider profiles and business listings 📧🔧 Perfect for B2B outreach, partnerships, and building targeted local service provider leads.