⭐ Universal Person Signals API (Beta)

Beta. The Signals API is in beta. To get access, contact sales at [email protected].

Signal events for up to 25 people, identified by RocketReach profile ID or LinkedIn URL, including signals for each person's current employer. Billed one Universal credit per result per signal category that returns at least one event. Unmatched identifiers and empty categories are free. Repeat calls are billed again.

Body Params

Exactly one of ids or linkedin_urls.

date

Earliest event date, as YYYY-MM-DD (e.g. 2026-10-01). Defaults to one month ago; anything before one year ago is raised to one year ago. Intent ignores it: an intent event carries its week's date.

integer
1 to 20
Defaults to 5

Most events returned per category per entity.

ids
array of integers
length ≤ 100

RocketReach profile IDs, as person search and lookup return. Up to 25 per request unless your account has a raised limit.

ids
linkedin_urls
array of strings
length ≤ 100

LinkedIn profile URLs. Up to 25 per request unless your account has a raised limit.

linkedin_urls
signal_category
array of objects

The signal categories to return. Each event's category echoes the value you sent.

  • all_signals: every category except company_intent.
  • company_intent: must be listed by name and needs a paid intent plan. Returns this week's topics from your plan, not dated history.
signal_category
signal_type
array of strings

Optional subtype filter for the requested signal categories. When omitted, every signal type is returned. For company_intent, signal types are intent topic names, and you must be subscribed to each topic you specify. For all other categories, the available signal types are listed below.

Each signal type must belong to one of the requested categories, or the request returns a 400. A requested category that none of your signal types belong to returns no events and isn't charged.

  • job_change_signal: Company Change, Promotion
  • company_news_signal: Attends Event, Award, Bankruptcy, Certification Achieved, Closes Offices, Competitor Identified, Decreases Headcount, Developing Product, Earnings Reported, Executive Departure, Executive Hire, Executive Promotion, Executive Retirement, Expands Facilities, Files Lawsuit, Funding, Increases Headcount, Integration, Invests Into, IPO, Launches Product, Lost Customer, Mergers & Acquisitions, New Customer, Partnership, Partnership Ended, Purchases Assets, Recognition, Revenue Reported, Security Incident, Sells Assets, Spin-off, Valuation Reported, Vulnerability
  • company_job_posting_signal: Accounting Roles, Administration Roles, Business Development Roles, Corporate Communications Roles, Customer Services Roles, Design Roles, Engineering Roles, Facilities Management Roles, Finance Roles, Human Resources Roles, Information Technology Roles, Legal Roles, Logistics Roles, Machine Learning Roles, Marketing Roles, Operations Roles, Procurement Roles, Product Roles, Production or Manufacturing Roles, Project Management Roles, Public Relations Roles, Quality Assurance Roles, Recruiting Roles, Research and Development Roles, Retail Roles, Sales Roles, Skilled Trades Roles, Solutions Roles, Strategy Roles
  • company_sec_filing_signal: 10-K Filing, 10-Q Filing, 20-F Filing, 6-K Filing, 8-K Filing
  • company_website_intelligence_signal: Acquisition, Branding Change, Community Engagement, Compliance Update, Contact Update, Customer Win, Event Announcement, Executive Change, Expansion, Feature Launch, Feature Update, Funding News, Geographic Expansion, Market Data, Marketing Campaign, Marketing Channel, Marketing Content, Marketing Shift, Media & Press, Operational Change, Other, Partnership Announcement, Pricing Change, Pricing Promotion, Product Expansion, Product Highlight, Product Launch, Product Removal, Product Update, Program Launch, Project Update, Recognition & Award, Service Update, Target Audience Shift, Team Expansion, Technical Update, Technology Adoption, Website Update
  • company_product_review_signal: Active Churn, Competitor Mentions, Customer Support Complaints, Integration Problems, Missing Features, Pricing Concerns, Recurring Product Issues, Reliability Issues, Usability Issues
  • company_seo_website_traffic_signal: Sustained Decline, Sustained Growth, Traffic Decline, Traffic Surge
signal_type
Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

400

Bad Request. Missing or extra identifiers, more than 25 entities, an unknown category or signal_type, a future start_date, or intent without a paid intent plan.

401

Unauthorized. API Key is missing or invalid.

403

Forbidden. The account is not enabled for Universal credits, signal enrichment is disabled for it, or the balance is short. A short balance names both numbers: "Insufficient Credits: 3 required, 2 available".

413

Payload Too Large. The request body, excluding any multipart file uploads, exceeds 2.5 MB.

429

Too Many Requests. API request limit reached -- slow down requests.

500

Internal Server Error. Unexpected error on RocketReach servers. Try again later.

502

Bad Gateway. Signals are temporarily unavailable. Nothing is charged.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json