Employer
Returns the employers found by the search, if any.
If the has_next field value is true it means there are more results to be returned. And the next field is the cursor.
You can make another request to this same endpoint, passing the next field value as the cursor in the query.
Getting Started
URL REQUEST (GET)
https://api.statsocial.com/platform/v0/b2b/employers
The query URL parameter searches an employer by its name or ID.
https://api.statsocial.com/platform/v0/b2b/employers?query=xxx
The cursor used to paginate.
https://api.statsocial.com/platform/v0/b2b/employers?cursor=xxx
note
Let's use the data in this section when creating audiences
Let's go to examples
Query
In this first example we will search for statsocial
https://api.statsocial.com/platform/v0/b2b/employers?query=statsocial
We will receive a json like this
{
"response": {
"data": [
{
"id": "StatSocial",
"name": "StatSocial",
"followers_count": 81,
"kind": "b2b_employer"
},
{
"id": "StatSocial Past Life: Founder of RateMyTeachers/RateMyProfessors, PeekYou",
"name": "StatSocial Past Life: Founder of RateMyTeachers/RateMyProfessors, PeekYou",
"followers_count": 1,
"kind": "b2b_employer"
}
],
"has_next": false,
"next": ""
},
"information": {
"version": "0.0.1"
}
}
when the value has_next is equal to false, there is no way to use cursor, so let's look for microsoft
https://api.statsocial.com/platform/v0/b2b/employers?query=microsoft
We will receive a json like this
{
"response": {
"data": [
{
"id": "Microsoft",
"name": "Microsoft",
"followers_count": 61876,
"kind": "b2b_employer"
},
{
"id": "Microsoft Corporation",
"name": "Microsoft Corporation",
"followers_count": 22951,
"kind": "b2b_employer"
},
{
"id": "Microsoft Corp",
"name": "Microsoft Corp",
"followers_count": 5565,
"kind": "b2b_employer"
},
{
"id": "Microsoft Research",
"name": "Microsoft Research",
"followers_count": 329,
"kind": "b2b_employer"
},
{
"id": "Microsoft India",
"name": "Microsoft India",
"followers_count": 136,
"kind": "b2b_employer"
},
{
"id": "Microsoft Azure",
"name": "Microsoft Azure",
"followers_count": 130,
"kind": "b2b_employer"
},
{
"id": "Microsoft Ventures",
"name": "Microsoft Ventures",
"followers_count": 113,
"kind": "b2b_employer"
},
{
"id": "Microsoft MVP",
"name": "Microsoft MVP",
"followers_count": 97,
"kind": "b2b_employer"
},
{
"id": "Microsoft Federal",
"name": "Microsoft Federal",
"followers_count": 96,
"kind": "b2b_employer"
},
{
"id": "Microsoft France",
"name": "Microsoft France",
"followers_count": 89,
"kind": "b2b_employer"
},
{
"id": "Microsoft Studios",
"name": "Microsoft Studios",
"followers_count": 83,
"kind": "b2b_employer"
},
{
"id": "Microsoft Accelerator",
"name": "Microsoft Accelerator",
"followers_count": 79,
"kind": "b2b_employer"
},
{
"id": "Microsoft Corp.",
"name": "Microsoft Corp.",
"followers_count": 75,
"kind": "b2b_employer"
},
{
"id": "Microsoft Canada",
"name": "Microsoft Canada",
"followers_count": 67,
"kind": "b2b_employer"
},
{
"id": "Microsoft.",
"name": "Microsoft.",
"followers_count": 61,
"kind": "b2b_employer"
},
{
"id": "Microsoft Nederland",
"name": "Microsoft Nederland",
"followers_count": 54,
"kind": "b2b_employer"
},
{
"id": "Microsoft Hololens",
"name": "Microsoft Hololens",
"followers_count": 54,
"kind": "b2b_employer"
},
{
"id": "Microsoft Game Studios",
"name": "Microsoft Game Studios",
"followers_count": 54,
"kind": "b2b_employer"
},
{
"id": "Microsoft Deutschland GmbH",
"name": "Microsoft Deutschland GmbH",
"followers_count": 54,
"kind": "b2b_employer"
},
{
"id": "Microsoft MVP Program",
"name": "Microsoft MVP Program",
"followers_count": 50,
"kind": "b2b_employer"
},
{
"id": "MICROSOFT LICENSING GP",
"name": "MICROSOFT LICENSING GP",
"followers_count": 48,
"kind": "b2b_employer"
},
{
"id": "Microsoft South Africa",
"name": "Microsoft South Africa",
"followers_count": 43,
"kind": "b2b_employer"
},
{
"id": "Microsoft Research Asia",
"name": "Microsoft Research Asia",
"followers_count": 43,
"kind": "b2b_employer"
},
{
"id": "Microsoft, Founder of INK'A and INFLECTION",
"name": "Microsoft, Founder of INK'A and INFLECTION",
"followers_count": 42,
"kind": "b2b_employer"
},
{
"id": "Microsoft Teams",
"name": "Microsoft Teams",
"followers_count": 40,
"kind": "b2b_employer"
},
{
"id": "Microsoft Australia",
"name": "Microsoft Australia",
"followers_count": 37,
"kind": "b2b_employer"
},
{
"id": "Microsoft (JeffreyM Consulting)",
"name": "Microsoft (JeffreyM Consulting)",
"followers_count": 36,
"kind": "b2b_employer"
},
{
"id": "Developers in and Around Microsoft Azure",
"name": "Developers in and Around Microsoft Azure",
"followers_count": 36,
"kind": "b2b_employer"
},
{
"id": "Microsoft Office 365",
"name": "Microsoft Office 365",
"followers_count": 35,
"kind": "b2b_employer"
},
{
"id": "EOH: A Microsoft Partner",
"name": "EOH: A Microsoft Partner",
"followers_count": 34,
"kind": "b2b_employer"
}
],
"has_next": true,
"next": "33"
},
"information": {
"version": "0.0.1"
}
}
Cursor
Now we can use the cursor using the next value received in the response
https://api.statsocial.com/platform/v0/b2b/employers?query=microsoft&cursor=33
We will receive a json like this
{
"response": {
"data": [
{
"id": "Microsoft Innovation Center",
"name": "Microsoft Innovation Center",
"followers_count": 33,
"kind": "b2b_employer"
},
{
"id": "Microsoft (Mobile Apps)",
"name": "Microsoft (Mobile Apps)",
"followers_count": 30,
"kind": "b2b_employer"
},
{
"id": "Microsoft Healthcare",
"name": "Microsoft Healthcare",
"followers_count": 29,
"kind": "b2b_employer"
},
{
"id": "Microsoft Consulting Services",
"name": "Microsoft Consulting Services",
"followers_count": 29,
"kind": "b2b_employer"
},
{
"id": "Microsoft India Development Center",
"name": "Microsoft India Development Center",
"followers_count": 26,
"kind": "b2b_employer"
},
{
"id": "Microsoft Dynamics",
"name": "Microsoft Dynamics",
"followers_count": 26,
"kind": "b2b_employer"
},
{
"id": "Microsoft Data Platform MVP",
"name": "Microsoft Data Platform MVP",
"followers_count": 26,
"kind": "b2b_employer"
},
{
"id": "Microsoft Surface",
"name": "Microsoft Surface",
"followers_count": 25,
"kind": "b2b_employer"
},
{
"id": "Microsoft Ireland",
"name": "Microsoft Ireland",
"followers_count": 25,
"kind": "b2b_employer"
},
{
"id": "Directions On Microsoft",
"name": "Directions On Microsoft",
"followers_count": 25,
"kind": "b2b_employer"
},
{
"id": "Microsoft UK",
"name": "Microsoft UK",
"followers_count": 24,
"kind": "b2b_employer"
},
{
"id": "Microsoft Research India",
"name": "Microsoft Research India",
"followers_count": 24,
"kind": "b2b_employer"
},
{
"id": "Microsoft Research Cambridge",
"name": "Microsoft Research Cambridge",
"followers_count": 24,
"kind": "b2b_employer"
},
{
"id": "Microsoft Student Partners",
"name": "Microsoft Student Partners",
"followers_count": 23,
"kind": "b2b_employer"
},
{
"id": "Microsoft Store",
"name": "Microsoft Store",
"followers_count": 23,
"kind": "b2b_employer"
},
{
"id": "Microsoft Services",
"name": "Microsoft Services",
"followers_count": 23,
"kind": "b2b_employer"
},
{
"id": "LMC Consulting Group - Microsoft Global Security",
"name": "LMC Consulting Group - Microsoft Global Security",
"followers_count": 23,
"kind": "b2b_employer"
},
{
"id": "Microsoft Office",
"name": "Microsoft Office",
"followers_count": 22,
"kind": "b2b_employer"
},
{
"id": "Microsoft Alumni Network",
"name": "Microsoft Alumni Network",
"followers_count": 21,
"kind": "b2b_employer"
},
{
"id": "Microsoft Advertising",
"name": "Microsoft Advertising",
"followers_count": 21,
"kind": "b2b_employer"
},
{
"id": "Microsoft (Xbox)",
"name": "Microsoft (Xbox)",
"followers_count": 21,
"kind": "b2b_employer"
},
{
"id": "Microsoft (Skype)",
"name": "Microsoft (Skype)",
"followers_count": 21,
"kind": "b2b_employer"
},
{
"id": "Microsoft Licensing",
"name": "Microsoft Licensing",
"followers_count": 20,
"kind": "b2b_employer"
},
{
"id": "Microsoft Indonesia",
"name": "Microsoft Indonesia",
"followers_count": 20,
"kind": "b2b_employer"
},
{
"id": "Microsoft (MileIQ)",
"name": "Microsoft (MileIQ)",
"followers_count": 20,
"kind": "b2b_employer"
},
{
"id": "M12, Microsoft's Venture Fund",
"name": "M12, Microsoft's Venture Fund",
"followers_count": 20,
"kind": "b2b_employer"
},
{
"id": "Microsoft Latin America",
"name": "Microsoft Latin America",
"followers_count": 19,
"kind": "b2b_employer"
},
{
"id": "Microsoft AI & Research",
"name": "Microsoft AI & Research",
"followers_count": 19,
"kind": "b2b_employer"
},
{
"id": "M12 (fka Microsoft Ventures)",
"name": "M12 (fka Microsoft Ventures)",
"followers_count": 19,
"kind": "b2b_employer"
},
{
"id": "Microsoft Ventures Accelerator, London",
"name": "Microsoft Ventures Accelerator, London",
"followers_count": 18,
"kind": "b2b_employer"
}
],
"has_next": true,
"next": "18"
},
"information": {
"version": "0.0.1"
}
}
We can use the cursor while the response is returning the value of next