Search for new prospects
Runs a free people preview, from the professional network, for an audience you describe. Returns a small sample with no contact details or social profile URLs, plus a searchId to resume the same search when importing. matchCount is how many people the preview found (about one page), not a total market size. Company-shaped audiences may use companies_then_people (companies first, then people there); see appliedFilters.intent. Use campaigns.leads.search for people already in the workspace. Import with leadFinder.addProspectsToCampaign, which spends credits.
/leadFinder.searchProspectsAuthorization
bearerAuth Enter your MailMoo API key (format: sk_live_...)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/leadFinder.searchProspects" \ -H "Content-Type: application/json" \ -d '{}'{ "interpretation": "string", "appliedFilters": { "property1": null, "property2": null }, "matchCount": 0, "searchId": "9b1a67f9-9477-48e5-8a6c-11b70245e1d9", "sample": [ { "fullName": "string", "jobTitle": "string", "companyName": "string", "location": "string", "industry": "string", "companySize": "string", "seniority": "string" } ]}Check remaining daily sending and search allowance GET
Returns how much daily sending allowance and daily search allowance each connected sender profile has left. Omit senderProfileId to list every sender profile with a connected account. A send or a post-engagement fetch may fail or queue when remaining is 0. Pass senderProfileId from this response to the other social endpoints.
Add prospects to a campaign POST
Sources people from the professional network matching the audience and adds them to a campaign. Spends workspace credits per person (search + profile enrichment + fit scoring) and cannot be undone. Prefer passing searchId from leadFinder.searchProspects so the same preview resumes on later pages instead of starting over. Duplicates already in the campaign are skipped and not charged for. maxLeads defaults to 100 (max 500); pass fillToBudget to import within remaining credits.