V4MOS.AI API
GuidesAPI Referenceapp.v4mos.ai
Facebook Ads

Ad Set Config

GET
/v1/facebook/ads/adset-config

Retrieve Facebook Ads ad set configuration data including targeting settings, budget configurations, and ad set-level settings.

This endpoint provides detailed configuration information for ad sets.

Dimensions Available:

  • Configuration ID, name, effective status, creation time
  • Budget: lifetime budget, daily budget
  • Targeting: age min/max, genders, flexible spec, geo locations, custom locations, places, location types, neighborhoods, targeting automation
  • Platforms: publisher platforms, Facebook/Instagram/Messenger positions, device platforms

Limitations:

  • Maximum 5000 records per page
  • Supports date filtering via dateStart (ISO 8601 format)
  • Supports sorting via orderBy and orderDirection (ASC/DESC)

Filters:

  • organizationId (required)
  • userId (optional)
  • integrationName (optional)
  • dateStart (optional)

Note: This endpoint returns configuration data and may not support dateEnd filtering.

Authorization

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Query Parameters

organizationId*string

Organization identifier (required)

userId?string

User identifier (optional)

integrationName?string

Integration name identifier (optional)

dateStart?string

Start date for filtering (optional, ISO 8601 format)

Formatdate
page?integer

Page number for pagination (optional)

Default1
limit?integer

Number of items per page (optional, max 5000)

Rangevalue <= 5000
Default500
orderBy?string

Field to order by (optional)

orderDirection?string

Order direction (optional)

Value in"ASC""DESC"

Response Body

Successful response

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/facebook/ads/adset-config?organizationId=organization_123&dateStart=2024-01-01"
{  "data": [    {      "id": "string",      "name": "string",      "effective_status": "string",      "created_time": "2019-08-24T14:15:22Z",      "lifetime_budget": 0,      "daily_budget": 0,      "targeting_age_max": 0,      "targeting_age_min": 0,      "targeting_flexible_spec": "string",      "targeting_genders": "string",      "targeting_geo_locations_custom_locations": "string",      "targeting_geo_locations_places": "string",      "targeting_geo_locations_location_types": "string",      "targeting_geo_locations_neighborhoods": "string",      "targeting_targeting_automation_advantage_audience": "string",      "targeting_targeting_automation_individual_setting_geo": "string",      "targeting_publisher_platforms": "string",      "targeting_facebook_positions": "string",      "targeting_instagram_positions": "string",      "targeting_device_platforms": "string",      "targeting_messenger_positions": "string",      "organization_id": "string",      "user_id": "string",      "document_id": "string",      "integration_name": "string",      "inserted_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}

Creatives GET

Previous Page

Ad Config GET

Next Page