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. |
| 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. |
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) |
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. |
| 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). |
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. |
| 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. |
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. |
| 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 (instagram and so on). Filtering happens after the page has been fetched, so read the caveats below as well. |
| category | query | No | Category slug or Korean category name. Filtering happens after the page has been fetched. |
| min_followers | query | No | Lower bound on total channel followers. Filtering happens after the page has been fetched. |
| max_followers | query | No | Upper bound on total channel followers. Filtering happens after the page has been fetched. |