cURL
curl --request POST \
--url https://api.influship.com/v1/creators/match \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"creators": [
{
"platform": "instagram",
"username": "fitness_coach_jane"
},
{
"creator_id": "123e4567-e89b-12d3-a456-426614174000"
}
],
"intent": {
"query": "Promote our new plant-based protein powder",
"context": "Target audience is health-conscious millennials interested in sustainable fitness"
}
}
'import Influship from 'influship';
const client = new Influship({
apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});
const response = await client.creators.match({
creators: [{}, {}],
intent: { query: 'Promote our new plant-based protein powder' },
});
console.log(response.data);import requests
url = "https://api.influship.com/v1/creators/match"
payload = {
"creators": [{
"platform": "instagram",
"username": "fitness_coach_jane"
}, { "creator_id": "123e4567-e89b-12d3-a456-426614174000" }],
"intent": {
"query": "Promote our new plant-based protein powder",
"context": "Target audience is health-conscious millennials interested in sustainable fitness"
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": [
{
"creator": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar_url": "<string>"
},
"input": {
"creator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"platform": "instagram",
"username": "<string>"
},
"match": {
"score": 0.85,
"decision": "good",
"reasons": [
{
"text": "Strong fit due to fitness content focus and engaged audience",
"provenance": "post_evidence",
"fact_id": "<string>",
"source_post_id": "<string>",
"evidence_quote": "<string>"
}
]
}
}
]
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "The API could not complete the analysis",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}Creators
Score Campaign Fit
Evaluate how well creators match a specific campaign using AI analysis. Returns a fit score (0-1), decision recommendation (good/neutral/avoid), and evidence-based explanations.
Use cases:
- Vet shortlisted creators before outreach
- Rank candidates for a specific campaign
- Get AI-generated talking points for why a creator fits
How it works:
- Describe your campaign intent and target audience
- Provide up to 100 creators to evaluate
- Get detailed scores with explanations and evidence
Also callable as the match_creators MCP tool — see the MCP server guide for setup.
Pricing: 1 credit per creator scored ($0.01)
POST
/
v1
/
creators
/
match
cURL
curl --request POST \
--url https://api.influship.com/v1/creators/match \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"creators": [
{
"platform": "instagram",
"username": "fitness_coach_jane"
},
{
"creator_id": "123e4567-e89b-12d3-a456-426614174000"
}
],
"intent": {
"query": "Promote our new plant-based protein powder",
"context": "Target audience is health-conscious millennials interested in sustainable fitness"
}
}
'import Influship from 'influship';
const client = new Influship({
apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});
const response = await client.creators.match({
creators: [{}, {}],
intent: { query: 'Promote our new plant-based protein powder' },
});
console.log(response.data);import requests
url = "https://api.influship.com/v1/creators/match"
payload = {
"creators": [{
"platform": "instagram",
"username": "fitness_coach_jane"
}, { "creator_id": "123e4567-e89b-12d3-a456-426614174000" }],
"intent": {
"query": "Promote our new plant-based protein powder",
"context": "Target audience is health-conscious millennials interested in sustainable fitness"
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": [
{
"creator": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar_url": "<string>"
},
"input": {
"creator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"platform": "instagram",
"username": "<string>"
},
"match": {
"score": 0.85,
"decision": "good",
"reasons": [
{
"text": "Strong fit due to fitness content focus and engaged audience",
"provenance": "post_evidence",
"fact_id": "<string>",
"source_post_id": "<string>",
"evidence_quote": "<string>"
}
]
}
}
]
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "The API could not complete the analysis",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}Authorizations
Body
application/json
Score campaign fit request
Response
Successful response
Show child attributes
Show child attributes