How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

LINE Manage Audience API

Twelve operations for building and managing the marketing audiences a narrowcast targets — creating audiences from uploaded user IDs by JSON or by file, click-based and impression-based audiences derived from earlier sends, renaming, deleting, and reading audience data and shared Business Manager audiences. Uploads are asynchronous jobs limited to ten concurrent operations per audience.

LINE Manage Audience API is one of 10 APIs that LINE publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Marketing and Audience. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 12 operations across 9 paths, organized into 2 resource areas, and defines 27 schemas. It is described by OpenAPI 3.0.0, at version 0.0.1.

Requests are made against a single base URL, https://api.line.me.

12 operations 9 paths 27 schemas 1 DELETE4 GET4 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
0.0.1
Base URL
https://api.line.me
Authentication
HTTP Bearer
Resource Areas
2

Authentication & Security 1

LINE Manage Audience API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (Bearer). By default, every request must be authenticated.

  • Bearer — Channel access token

Paths & Operations 12

Across 9 paths, the API surfaces 12 operations — 1 DELETE, 4 GET, 4 POST, 3 PUT. They span 2 resource areas: manage-audience, manage-audience-blob. Each is listed below with its method, path, parameters, and response codes.

manage-audience 10
POST
/v2/bot/audienceGroup/upload
Create audience for uploading user IDs (by JSON)
createAudienceGroup body → 202
PUT
/v2/bot/audienceGroup/upload
Add user IDs or Identifiers for Advertisers (IFAs) to an audience for uploading user IDs (by JSON)
addAudienceToAudienceGroup body → 202
POST
/v2/bot/audienceGroup/click
Create audience for click-based retargeting
createClickBasedAudienceGroup body → 202
POST
/v2/bot/audienceGroup/imp
Create audience for impression-based retargeting
createImpBasedAudienceGroup body → 202
PUT
/v2/bot/audienceGroup/{audienceGroupId}/updateDescription
Renames an existing audience.
updateAudienceGroupDescription 1 param body → 200
DELETE
/v2/bot/audienceGroup/{audienceGroupId}
Delete audience
deleteAudienceGroup 1 param → 200
GET
/v2/bot/audienceGroup/{audienceGroupId}
Gets audience data.
getAudienceData 1 param → 200400
GET
/v2/bot/audienceGroup/list
Gets data for more than one audience.
getAudienceGroups 6 params → 200
GET
/v2/bot/audienceGroup/shared/{audienceGroupId}
Gets audience data.
getSharedAudienceData 1 param → 200400
GET
/v2/bot/audienceGroup/shared/list
Gets data for more than one audience, including those shared by the Business Manager.
getSharedAudienceGroups 6 params → 200
manage-audience-blob 2
POST
/v2/bot/audienceGroup/upload/byFile
Create audience for uploading user IDs (by file).
createAudienceForUploadingUserIds body → 202
PUT
/v2/bot/audienceGroup/upload/byFile
Add user IDs or Identifiers for Advertisers (IFAs) to an audience for uploading user IDs (by file).
addUserIdsToAudience body → 202

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are AudienceGroup (12 properties), CreateClickBasedAudienceGroupResponse (10 properties), CreateAudienceGroupResponse (8 properties), AudienceGroupJob (8 properties). Each schema is shown below with its type and property counts.

CreateAudienceGroupRequest
object
Create audience for uploading user IDs (by JSON)
4 properties
Audience
object
Audience
1 property
CreateAudienceGroupResponse
object
Create audience for uploading user IDs (by JSON)
8 properties
AudienceGroupType
string
Audience group type
AddAudienceToAudienceGroupRequest
object
Add user IDs or Identifiers for Advertisers (IFAs) to an audience for uploading user IDs (by JSON)
3 properties
CreateClickBasedAudienceGroupRequest
object
Create audience for click-based retargeting
3 properties
CreateClickBasedAudienceGroupResponse
object
Create audience for click-based retargeting
10 properties
CreateImpBasedAudienceGroupRequest
object
Create audience for impression-based retargeting
2 properties
CreateImpBasedAudienceGroupResponse
object
Create audience for impression-based retargeting
5 properties
UpdateAudienceGroupDescriptionRequest
object
Rename an audience
1 property
GetAudienceDataResponse
object
Get audience data
3 properties
GetSharedAudienceDataResponse
object
Get audience data
3 properties
AudienceGroup
object
Audience group
12 properties
AudienceGroupJob
object
Audience group job
8 properties
Adaccount
object
Adaccount
1 property
DetailedOwner
object
Owner of this audience group.
3 properties
AudienceGroupStatus
string
Status
AudienceGroupFailedType
string
Failed type
AudienceGroupPermission
string
Permission
AudienceGroupCreateRoute
string
How the audience was created. One of: - OAMANAGER: Audience created with [LINE Official Account Manager](https://manager.line.biz/). - MESSAGINGAPI: Audience c…
AudienceGroupJobType
string
Job Type
AudienceGroupJobStatus
string
Job status
AudienceGroupJobFailedType
string
Failed type
GetAudienceGroupsResponse
object
Gets data for more than one audience.
6 properties
GetSharedAudienceGroupsResponse
object
Gets data for more than one audience.
6 properties
ErrorResponse
object
2 properties 1 required
ErrorDetail
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

line-manage-audience-openapi.yml Raw ↑

Other APIs LINE publishes across the network.

LINE Messaging API
LINE Messaging API Webhook
LINE Channel Access Token API
LINE Insight API
LIFF Server API
LINE Module API
LINE Module Attach API
LINE Mission Sticker API
LINE Login v2.1
Where this information came from

This is an independent, third-party profile of LINE Manage Audience API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.