Skip to main content

List Category Accounts

Overview

The List Category Accounts endpoint allows you to retrieve all social accounts associated with a specific category. Each category can have one or more connected accounts, such as Facebook Pages, Twitter profiles, Google Business and more.

Base URL:

https://www.oneupapp.io

Endpoint

GET /api/listcategoryaccount?apiKey=YOUR_API_KEY&category_id=CATEGORY_ID

Example:

GET https://www.oneupapp.io/api/listcategoryaccount?apiKey=621544d93ffe2db52b01&category_id=49839

Request Parameters

ParameterRequiredDescription
apiKeyYesYour personal API key generated from the API Access page.
category_idYesThe unique ID of the category whose connected accounts you want to retrieve.

Sample Request

curl -X GET "https://www.oneupapp.io/api/listcategoryaccount?apiKey=YOUR_API_KEY&category_id=CATEGORY_ID"

Sample Response

{
"message": "OK",
"error": false,
"data": [
{
"category_id": 49839,
"social_network_name": "kumarvishi",
"social_network_id": "pin_kumarvishi",
"social_network_type": "Pinterest"
},
{
"category_id": 49839,
"social_network_name": "OneUp (United States)",
"social_network_id": "accounts/116185162672310389659/locations/1366069594757511498",
"social_network_type": "GBP"
}
]
}

Result: The response lists all the social media accounts linked to the specified category. Each item includes:

  • social_network_name — The display name of the connected social account.
  • social_network_id — The unique identifier used when scheduling or publishing posts.
  • social_network_type — The type of network (e.g., Facebook, Pinterest, GBP, Twitter, etc.).

Usage Example

  1. First, use the List Categories endpoint to get your desired category_id.
  2. Then, use this endpoint to find all accounts linked to that category.
  3. Finally, use the social_network_id values when creating or scheduling posts.

Next Step: Proceed to the Creating Post section to publish content using the category and account IDs retrieved here.