API Reference
한국어Parameters and behaviour of the 5 read-only endpoints in inlink Open API 1.5.0-read.
List my campaigns
https://inlink.to/api/v1/campaigns
Returns only the campaigns belonging to brands my account owns, newest first (created_at descending). Deleted campaigns are excluded. An account that does not have a brand yet gets an empty list with pagination.limit set to 0.
| Parameter | In | Required | Description |
|---|---|---|---|
page | query | No | Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []). |
limit | query | No | Items per page. Clamped to the range 1-50; values above 50 are cut down to 50. |
status | query | No | Exact-match filter on campaign status (for example active). Omit it to get everything. |
page- In
- query
- Required
- No
- Description
- Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []).
limit- In
- query
- Required
- No
- Description
- Items per page. Clamped to the range 1-50; values above 50 are cut down to 50.
status- In
- query
- Required
- No
- Description
- Exact-match filter on campaign status (for example active). Omit it to get everything.
Campaign detail
https://inlink.to/api/v1/campaigns/{id}
Returns one campaign I own. If it does not exist, or it is not mine, the answer is the same 404 (we do not reveal whether someone else's campaign exists).
| Parameter | In | Required | Description |
|---|---|---|---|
id | path | Yes | Campaign id (uuid) |
id- In
- path
- Required
- Yes
- Description
- Campaign id (uuid)
Campaign applicants (selection and submission status)
https://inlink.to/api/v1/campaigns/{id}/applicants
Returns the applications to a campaign I own, newest first. Applicants' personal data (legal name, contact details, shipping address, free-text answers in the application) is not even queried; each influencer comes with public identity only (member number, nickname, profile image).
| Parameter | In | Required | Description |
|---|---|---|---|
id | path | Yes | Campaign id (uuid) |
page | query | No | Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []). |
limit | query | No | Items per page. Clamped to the range 1-50; values above 50 are cut down to 50. |
status | query | No | Exact-match filter on application status. Values seen in production: pending · accepted · submitted · completed · rejected · cancelled · withdrawn. ★Do not call this filter three times and merge the results to get the selected influencers — confirmed cancellations stay as accepted and end up in the mix. Use is_selected in the response to decide selection (1.2.0-read). |
id- In
- path
- Required
- Yes
- Description
- Campaign id (uuid)
page- In
- query
- Required
- No
- Description
- Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []).
limit- In
- query
- Required
- No
- Description
- Items per page. Clamped to the range 1-50; values above 50 are cut down to 50.
status- In
- query
- Required
- No
- Description
- Exact-match filter on application status. Values seen in production: pending · accepted · submitted · completed · rejected · cancelled · withdrawn. ★Do not call this filter three times and merge the results to get the selected influencers — confirmed cancellations stay as accepted and end up in the mix. Use is_selected in the response to decide selection (1.2.0-read).
List the proposals I have sent
https://inlink.to/api/v1/proposals
Returns the proposals my brand has sent to influencers, newest first. The proposal body (the message) is not included in the response. An account that does not have a brand yet gets an empty list with pagination.limit set to 0.
| Parameter | In | Required | Description |
|---|---|---|---|
page | query | No | Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []). |
limit | query | No | Items per page. Clamped to the range 1-50; values above 50 are cut down to 50. |
status | query | No | Exact-match filter on proposal status (for example pending). Omit it to get everything. |
page- In
- query
- Required
- No
- Description
- Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []).
limit- In
- query
- Required
- No
- Description
- Items per page. Clamped to the range 1-50; values above 50 are cut down to 50.
status- In
- query
- Required
- No
- Description
- Exact-match filter on proposal status (for example pending). Omit it to get everything.
Search the public influencer directory
https://inlink.to/api/v1/influencers
Searches public influencers by nickname, location, channel and follower count. Legal names, contact details, addresses and email addresses are not included.
| Parameter | In | Required | Description |
|---|---|---|---|
page | query | No | Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []). |
limit | query | No | Items per page. Clamped to the range 1-50; values above 50 are cut down to 50. |
keyword | query | No | Search term — searches nicknames only (legal names and login IDs are not searched). |
region | query | No | Location — matched against the public city value on the profile. |
platform | query | No | Channel platform filter applied during the database query. Follower bounds must be met by a channel on this platform. |
category | query | No | Category slug or Korean category name. Filtering happens after the page has been fetched. |
min_followers | query | No | Lower bound on an individual channel count, applied during the database query. The same channel must meet both bounds; platform selects that platform, otherwise any channel may qualify. Uses the greater of follower_count and subscriber_count; only ownership-verified YouTube channels qualify. A non-negative integer up to 2147483647; min_followers must not exceed max_followers. |
max_followers | query | No | Upper bound on an individual channel count, applied during the database query. The same channel must meet both bounds; platform selects that platform, otherwise any channel may qualify. Uses the greater of follower_count and subscriber_count; only ownership-verified YouTube channels qualify. A non-negative integer up to 2147483647; min_followers must not exceed max_followers. |
page- In
- query
- Required
- No
- Description
- Page number (starts at 1). Anything below 1 is clamped to 1. A page past the last one returns an empty list (data: []).
limit- In
- query
- Required
- No
- Description
- Items per page. Clamped to the range 1-50; values above 50 are cut down to 50.
keyword- In
- query
- Required
- No
- Description
- Search term — searches nicknames only (legal names and login IDs are not searched).
region- In
- query
- Required
- No
- Description
- Location — matched against the public city value on the profile.
platform- In
- query
- Required
- No
- Description
- Channel platform filter applied during the database query. Follower bounds must be met by a channel on this platform.
category- In
- query
- Required
- No
- Description
- Category slug or Korean category name. Filtering happens after the page has been fetched.
min_followers- In
- query
- Required
- No
- Description
- Lower bound on an individual channel count, applied during the database query. The same channel must meet both bounds; platform selects that platform, otherwise any channel may qualify. Uses the greater of follower_count and subscriber_count; only ownership-verified YouTube channels qualify. A non-negative integer up to 2147483647; min_followers must not exceed max_followers.
max_followers- In
- query
- Required
- No
- Description
- Upper bound on an individual channel count, applied during the database query. The same channel must meet both bounds; platform selects that platform, otherwise any channel may qualify. Uses the greater of follower_count and subscriber_count; only ownership-verified YouTube channels qualify. A non-negative integer up to 2147483647; min_followers must not exceed max_followers.