Enrich Social Metrics

Get a company's social audience counts and growth metrics. Returns 404 without charging when no category data is available.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

idstringOptional

linkedinIDstringOptional

linkedinNumIDstringOptional

linkedinURLstringOptional

LinkedIn URL, accepts company URLs like linkedin.com/company/google or linkedin.com/company/1441

facebookIDstringOptional

twitterIDstringOptional

crunchbaseIDstringOptional

pitchbookIDstringOptional

producthuntIDstringOptional

dealroomIDstringOptional

goldenIDstringOptional

angellistIDstringOptional

wellfoundIDstringOptional

websitestringOptional

requirelist of stringsOptional

Each requested top-level response field must be non-empty; otherwise returns 404 without charging.

Response

This endpoint returns an object.

weeklyFacebookChangedoubleOptional

The absolute change in the number of Facebook likes the company has over the past week.

weeklyFacebookPercentdoubleOptional

The percentage change in the number of Facebook likes the company has over the past week. This is the change in the number of likes divided by the number of likes at the start of the week.

monthlyFacebookChangedoubleOptional

The absolute change in the number of Facebook likes the company has over the past month.

monthlyFacebookPercentdoubleOptional

The percentage change in the number of Facebook likes the company has over the past month. This is the change in the number of likes divided by the number of likes at the start of the month.

triMonthlyFacebookChangedoubleOptional

The absolute change in the number of Facebook likes the company has over the past 3 months.

triMonthlyFacebookPercentdoubleOptional

The percentage change in the number of Facebook likes the company has over the past 3 months. This is the change in the number of likes divided by the number of likes at the start of the 3 months.

yearlyFacebookChangedoubleOptional

The absolute change in the number of Facebook likes the company has over the past year.

yearlyFacebookPercentdoubleOptional

The percentage change in the number of Facebook likes the company has over the past year. This is the change in the number of likes divided by the number of likes at the start of the year.

weeklyTwitterChangedoubleOptional

The absolute change in the number of Twitter followers the company has over the past week.

weeklyTwitterPercentdoubleOptional

The percentage change in the number of Twitter followers the company has over the past week. This is the change in the number of followers divided by the number of followers at the start of the week.

monthlyTwitterChangedoubleOptional

The absolute change in the number of Twitter followers the company has over the past month.

monthlyTwitterPercentdoubleOptional

The percentage change in the number of Twitter followers the company has over the past month. This is the change in the number of followers divided by the number of followers at the start of the month.

triMonthlyTwitterChangedoubleOptional

The absolute change in the number of Twitter followers the company has over the past 3 months.

triMonthlyTwitterPercentdoubleOptional

The percentage change in the number of Twitter followers the company has over the past 3 months. This is the change in the number of followers divided by the number of followers at the start of the 3 months.

yearlyTwitterChangedoubleOptional

The absolute change in the number of Twitter followers the company has over the past year.

yearlyTwitterPercentdoubleOptional

The percentage change in the number of Twitter followers the company has over the past year. This is the change in the number of followers divided by the number of followers at the start of the year.

facebookHistoricalmap from strings to doublesOptional

The historical number of Facebook likes the company has had.

twitterHistoricalmap from strings to doublesOptional

The historical number of Twitter followers the company has had.

facebookLikesintegerOptional

The current number of Facebook likes the company has.

twitterFollowersintegerOptional

The current number of Twitter followers the company has.

linkedinFollowersintegerOptional

The current number of LinkedIn followers the company has.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Company Not Found Error

429

Rate Limit Error