signals.actor API Documentation

Creator intelligence platform — discover, track, and engage with LinkedIn creators at scale.

Base URL · Quick Start · Authentication · OpenAPI Spec

---

Quick Start

1. List your creators

curl -H "X-API-Key: sk_your_key_here" \
  https://api.signals.actor/v1/creators?limit=5

2. Search posts by keyword

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.signals.actor/v1/posts?search=AI&sort=engagement&order=desc"

3. Create a list and import creators

# Create a list
curl -X POST -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name": "AI Influencers"}' \
  https://api.signals.actor/v1/lists

# Import by LinkedIn URLs
curl -X POST -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_urls": ["https://www.linkedin.com/in/example"]}' \
  https://api.signals.actor/v1/lists/{list_id}/import

---

API Endpoints

Resource	Method	Endpoint	Description
Creators
	GET	/v1/creators	List creators with filters
	GET	/v1/creators/fields	Get available field definitions
	GET	/v1/creators/sources	Get source types with counts
	GET	/v1/creators/ai-tags	Get AI tags with counts
	GET	/v1/creators/verticals	Get verticals with counts
	GET	/v1/creators/:id	Get single creator
	GET	/v1/creators/:id/posts	Get creator's posts
	POST	/v1/creators	Create a new creator
	PUT	/v1/creators/:id	Update a creator
	DELETE	/v1/creators/:id	Delete a creator
Companies
	GET	/v1/companies	List companies with filters
	GET	/v1/companies/fields	Get field definitions
	GET	/v1/companies/industries	Get industries with counts
	GET	/v1/companies/:id	Get company with employees
	GET	/v1/companies/:id/creators	Get company's creators
	POST	/v1/companies	Create a company
	PUT	/v1/companies/:id	Update a company
	DELETE	/v1/companies/:id	Delete a company
Posts
	GET	/v1/posts	List posts with filters
	GET	/v1/posts/:id	Get single post
	GET	/v1/posts/stats/period	Post stats for date range
	GET	/v1/posts/virality/stats	Virality tier breakdown
	GET	/v1/posts/companies/list	Companies with post counts
	GET	/v1/posts/bookmarks	Get bookmarked post IDs
	GET	/v1/posts/top/engagement	Top posts by engagement
	POST	/v1/posts/:id/bookmark	Toggle post bookmark
	DELETE	/v1/posts/:id	Delete post (admin)
Leads
	GET	/v1/leads	List leads (admin)
	GET	/v1/leads/:id	Get single lead (admin)
	GET	/v1/leads/by-signal/:signalName	Get leads by signal (admin)
	PUT	/v1/leads/:id	Update lead (admin)
	DELETE	/v1/leads/:id	Delete lead (admin)
	POST	/v1/leads/export	Export leads as CSV (admin)
Signals
	GET	/v1/signals	List all signals
	GET	/v1/signals/:id	Get single signal
	GET	/v1/signals/:id/leads	Get signal's leads (admin)
	POST	/v1/signals	Create signal (admin)
	PUT	/v1/signals/:id	Update signal (admin)
	DELETE	/v1/signals/:id	Delete signal (admin)
Stats
	GET	/v1/stats	Dashboard summary
	GET	/v1/stats/creators	Creator analytics
	GET	/v1/stats/posts	Post analytics
	GET	/v1/stats/leads	Lead analytics (admin)
Lists
	GET	/v1/lists	Get all lists
	GET	/v1/lists/:id	Get list with members
	POST	/v1/lists	Create a list
	PUT	/v1/lists/:id	Update a list
	DELETE	/v1/lists/:id	Delete a list
	POST	/v1/lists/:id/members	Add creators to list
	DELETE	/v1/lists/:id/members	Remove creators from list
	POST	/v1/lists/:id/import	Import by LinkedIn URLs
	POST	/v1/lists/import-urls	Import URLs (no list)
	POST	/v1/lists/check-urls	Check existing URLs
	POST	/v1/lists/:id/share	Share list
	DELETE	/v1/lists/:id/share	Remove list share
	GET	/v1/lists/:id/share/users	Get shareable users
Tags
	GET	/v1/tags	Get all tags
	GET	/v1/tags/colors	Get predefined colors
	GET	/v1/tags/:id	Get single tag
	POST	/v1/tags	Create a tag
	PUT	/v1/tags/:id	Update a tag
	DELETE	/v1/tags/:id	Delete a tag
	POST	/v1/tags/:id/creators	Add creators to tag
	DELETE	/v1/tags/:id/creators	Remove creators from tag
	GET	/v1/tags/creators/:creatorId	Get creator's tags
	POST	/v1/tags/creators/:creatorId	Set creator's tags
	POST	/v1/tags/:id/share	Share tag
	DELETE	/v1/tags/:id/share	Unshare tag
Usage
	GET	/v1/usage	API key usage stats
	GET	/v1/usage/errors	Recent API errors
LinkedIn Lookups
	POST	/v1/linkedin-lookups	Create single lookup
	POST	/v1/linkedin-lookups/bulk	Bulk create lookups
	GET	/v1/linkedin-lookups	List lookups
	GET	/v1/linkedin-lookups/:id	Get single lookup
	GET	/v1/linkedin-lookups/stats	Lookup statistics
	DELETE	/v1/linkedin-lookups/:id	Delete lookup
	POST	/v1/linkedin-lookups/:id/retry	Retry failed lookup
	POST	/v1/linkedin-lookups/resume-paused	Resume paused lookups
Deep Scrape
	POST	/v1/deep-scrape-queue	Queue creator for scrape
	GET	/v1/deep-scrape-queue	List queue entries
	GET	/v1/deep-scrape-queue/stats	Queue statistics
	POST	/v1/deep-scrape-queue/resume-paused	Resume paused entries
Insights
	GET	/v1/creators/:id/insights	Get creator insights
	PUT	/v1/creators/:id/insights	Upsert insight content
	DELETE	/v1/creators/:id/insights	Delete insights
	GET	/v1/creators/:id/insights/history	Get version history
	POST	/v1/creators/:id/insights/research	AI-powered research
	PUT	/v1/creators/:id/insights/share	Toggle sharing
	POST	/v1/creators/:id/insights/entries	Add timeline entry
	PUT	/v1/creators/:id/insights/entries/:entryId	Edit timeline entry
	DELETE	/v1/creators/:id/insights/entries/:entryId	Delete timeline entry
AI Analysis
	POST	/v1/ai-analysis/ethnicity	Analyze name ethnicity
	POST	/v1/ai-analysis/ethnicity/batch	Batch analyze ethnicity
Integrations
	GET	/v1/integrations/linkedin/status	LinkedIn connection status
	POST	/v1/integrations/linkedin/react	Send LinkedIn reaction
	DELETE	/v1/integrations/linkedin/react	Remove LinkedIn reaction
	POST	/v1/integrations/linkedin/comment	Post LinkedIn comment
	POST	/v1/integrations/linkedin/select-account	Select LinkedIn account
	GET	/v1/integrations/linkedin/reactions	Get user's reactions

---

Authentication

All API requests require an X-API-Key header. See Authentication Guide.

curl -H "X-API-Key: sk_your_api_key_here" https://api.signals.actor/v1/creators

Credits

Actions that consume external resources cost credits. See Credits & Billing Guide.

Action	Credits
Google Lookup (name search)	10
LinkedIn Profile (deep scrape)	10
Post Scraped	1
AI Enrichment	1
Media Processed	1
Daily Tracking Overage	1/creator/month

Enterprise teams have unlimited credits (balance = -1).

Guides

• Getting Started — Your first API call
• Authentication — API keys, roles, team scoping
• Credits & Billing — Credit costs and billing
• Team Scoping — How data access works
• Pagination & Filtering — Query patterns
• Error Handling — Error codes and responses
• Rate Limits — Request limits

Examples

• cURL Quick Start
• JavaScript Quick Start
• Python Quick Start

---

Copyright (c) 2026 Creative Content Crafts, Inc. — MIT License