Skip to main content
POST
/
v1
/
social
/
mapping
curl -X POST https://api.trigify.io/v1/social/mapping \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "engaged_with_keywords": ["artificial intelligence", "machine learning"],
    "engaged_with_topic_strength": 3,
    "engaged_with_days": 14,
    "job_titles": ["Chief Technology Officer", "VP of Engineering", "Director of AI"],
    "job_titles_excludes": ["Consultant", "Advisor"],
    "company_domain_includes": ["enterprise.com", "techcorp.io"],
    "company_domain_excludes": ["competitor.com"],
    "company_sizes": ["51-200", "201-500", "501-1000"],
    "industries": ["Computer Software", "Information Technology"],
    "location_country": ["United States", "Canada"],
    "location_excludes": ["Asia"],
    "page": 1,
    "page_size": 10,
    "includes": ["first_name", "last_name", "linkedin_url", "company", "job_title", "post.text", "engagement.type"]
  }'

{
  "message": "<string>",
  "success": true,
  "data": {
    "results": [
      {
        "post": {
          "text": "<string>",
          "url": "<string>",
          "date": "<string>",
          "likes": 123,
          "comments": 123
        },
        "engagement": {
          "type": "like"
        },
        "first_name": "<string>",
        "last_name": "<string>",
        "linkedin_url": "<string>",
        "avatar": "<string>",
        "location": "<string>",
        "company": "<string>",
        "company_domain": "<string>",
        "job_title": "<string>"
      }
    ],
    "page": 123,
    "total": 123
  }
}
This endpoint allows you to search for profiles based on their social engagement patterns and professional attributes.

​
Overview

The Social Mapping Search endpoint enables you to find professionals who have engaged with specific keywords, work at particular companies, hold certain job titles, or match other criteria. This powerful search tool helps you identify prospects who are already showing interest in relevant topics.

​
Authentication

Requires a valid API key with the social:mapping:read permission. 
curl -X POST https://api.trigify.io/v1/social/mapping \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "engaged_with_keywords": ["artificial intelligence", "machine learning"],
    "engaged_with_topic_strength": 3,
    "engaged_with_days": 14,
    "job_titles": ["Chief Technology Officer", "VP of Engineering", "Director of AI"],
    "job_titles_excludes": ["Consultant", "Advisor"],
    "company_domain_includes": ["enterprise.com", "techcorp.io"],
    "company_domain_excludes": ["competitor.com"],
    "company_sizes": ["51-200", "201-500", "501-1000"],
    "industries": ["Computer Software", "Information Technology"],
    "location_country": ["United States", "Canada"],
    "location_excludes": ["Asia"],
    "page": 1,
    "page_size": 10,
    "includes": ["first_name", "last_name", "linkedin_url", "company", "job_title", "post.text", "engagement.type"]
  }'

Headers

​
x-api-key
string
required

Body

application/json
​
engaged_with_keywords
string[]
required

Keywords that the prospect has engaged with. ex: ['keyword1', 'keyword2']

​
engaged_with_days
number
required

Number of days since engagement, min 1 day, max 30 days

Required range: 1 <= x <= 30
​
job_titles
string[]

List of job titles to include in the search. ex: ['Chief Executive Officer']

​
job_titles_excludes
string[]

List of job titles to exclude from the search. ex: ['Chief Executive Officer']

​
engaged_with_topic_strength
number
default:1

Strength of engagement with the specified keywords. 0-5

​
company_domain_includes
string[]

List of company domains to include in the search. ex: ['example.com']

​
company_domain_excludes
string[]

List of company domains to exclude from the search. ex: ['example.com']

​
followers
string[]

List of follower counts to include in the search.

​
location_country
string[]

List of locations to include in the search. ex: ['United States']

​
location_excludes
string[]

List of locations to exclude from the search. ex: ['United States']

​
industries
string[]

List of industries to include in the search. ex: ['Computer Software']

​
industries_excludes
string[]

List of industries to exclude from the search. ex: ['Computer Software']

​
company_sizes
enum<string>[]

List of company sizes to include in the search

Available options:
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
​
company_sizes_excludes
enum<string>[]

List of company sizes to exclude from the search

Available options:
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
​
page
number
default:1

The page number to retrieve

​
page_size
enum<integer>
default:10

The number of results to return per page

Available options:
10,
25,
50
​
includes
enum<string>[]

List of fields to include in the response

Available options:
first_name,
last_name,
linkedin_url,
avatar,
location,
company,
company_domain,
job_title,
followers,
post.text,
post.url,
post.date,
post.likes,
post.comments,
engagement.type

Response

200 - application/json
​
message
string
required
​
success
boolean
required
​
data
object
required