Endpoints for finding brands and pulling their profile, reach stats, and the creators they have sponsored.
Search sponsors
GET /api/v1/sponsors
Find brands and sponsors by name, ranked by how many sponsorships Influesque has detected. Costs 1 credit.
curl -H "Authorization: Bearer ifsk_your_key" \
"https://platform.influesque.com/api/v1/sponsors?query=hellofresh"
Query parameters
| Parameter | Type | Description |
|---|---|---|
query | string, required | Brand or sponsor name or keyword (e.g. HelloFresh). |
Response
| Field | Type | Description |
|---|---|---|
query | string | The query you sent. |
returned | integer | Number of sponsors returned. |
sponsors | array | Sponsor summaries. |
Each sponsor summary includes id, name, kind, website, domain, influesqueUrl,
sponsorshipCount, and lastSponsorshipDate.
Get a sponsor
GET /api/v1/sponsors/{id}
Full brand profile: website, the niches it sponsors in, reach and average-creator-size stats, and the
top creators who have worked with it. {id} can be a numeric sponsor id (from search) or a brand
name. Costs 1 credit.
curl -H "Authorization: Bearer ifsk_your_key" \
"https://platform.influesque.com/api/v1/sponsors/7"
{
"sponsor": {
"id": 7,
"name": "HelloFresh",
"website": "https://hellofresh.com",
"domain": "hellofresh.com",
"influesqueUrl": "https://platform.influesque.com/sponsors/7",
"sponsorshipCount": 1840,
"stats": {
"creatorCount": 920,
"totalReach": 480000000,
"averageCreatorSize": 520000,
"firstSponsorshipDate": "2021-03-01"
},
"niches": ["Food", "Lifestyle"],
"topCreators": [
{
"id": "somecreator",
"name": "Some Creator",
"influesqueUrl": "https://platform.influesque.com/creators/99",
"subscribers": 2100000
}
]
}
}
A 404 Not Found is returned when no sponsor matches the id.