# GobbleCube Enterprise API FINAL

# Overview

Enterprise-ready API for campaign and job management on GobbleCube platform.

## Getting Started

### Authentication

All requests must include:

- `X-API-Key`: Your API key (90-day expiry, managed through dashboard)
- `Platform`: Platform name (`zepto`)

**API Key Management:**

- API keys expire after 90 days
- Key generation and rotation managed through GobbleCube dashboard
- IP whitelisting supported for enhanced security
- Environment segregation at account level (production vs sandbox accounts)

### Request Headers

**Required Headers:**

- `X-API-Key`: Your API key for authentication
- `Platform`: Platform name (`zepto`)

**Optional Headers:**

- `X-Request-ID`: Request ID for traceability (if not provided, one will be generated)

**Response Headers:**

- `X-Request-ID`: Request ID for traceability and audit logging (always present)

### Features

- **Campaign Management**: Bulk creation, list, update, get details
- **Keyword Management**: Add, update, remove, bulk operations
- **Product & City Management**: Add/remove products, create groups
- **Live Data**: Keyword Share of Search (SOS) with real-time scraping
- **T-1 Data**: Detailed campaign performance metrics (yesterday's data)
- **Job Management**: Poll async job status, bulk job creation

### Postman Collection

Please contact your POC (Point of Contact) to get access to the Postman collection for faster integration and testing.

## API Reference

### Rate Limiting

**Rate Limits:**

- **Overall API**: 200 requests per minute (RPM)
- **Sliding Window**: Rate limiting implemented using sliding window algorithm
- **Per Application**: Rate limits applied per API key/application
- **Keyword SOS**: 5 keywords every 15 minutes (per API key)
- **Page Limit**: Maximum page limit for all paginated GET APIs is 200 per page

**Rate Limit Headers:**
When rate limits are approached or exceeded, the following headers are included in responses:

- `X-RateLimit-Limit`: Maximum requests allowed per window
- `X-RateLimit-Remaining`: Remaining requests in current window
- `X-RateLimit-Reset`: Time when the rate limit window resets

**Rate Limit Exceeded:**

- HTTP Status: `429 Too Many Requests`
- Response includes retry-after information
- Implement exponential backoff for retries

### Error Handling

**Standard HTTP Status Codes:**

- `200 OK` - Successful request
- `201 Created` - Resource created successfully
- `202 Accepted` - Request accepted for async processing
- `400 Bad Request` - Invalid request parameters or payload
- `401 Unauthorized` - Missing or invalid API key
- `403 Forbidden` - Insufficient permissions
- `404 Not Found` - Resource not found
- `429 Too Many Requests` - Rate limit exceeded
- `500 Internal Server Error` - Server error
- `502 Bad Gateway` - Gateway error
- `503 Service Unavailable` - Service temporarily unavailable

**Error Response Format:**

``` json
{
  "code": "ERROR_CODE",
  "message": "Human-readable error message",
  "details": "Additional error details (optional)"
}

 ```

**Retry Logic:**

- Safe to retry API calls with exponential backoff up to 3 times
- Use `X-Request-ID` from response to track retries
- Do not retry on 4xx errors (except 429 with retry-after)
- Retry on 5xx errors and network failures

### Idempotency

- All operations support idempotency
- Duplicate request detection mechanism in place
- Use `X-Request-ID` header to ensure idempotency across retries
- Same request with same `X-Request-ID` will return same result

### Request Ordering

- Requests are queued and processed based on workflow type priority
- For deterministic ordering requirements, contact support for guidance
- Campaign-level ordering can be configured if needed

### Data Freshness & Sync

**Platform Sync:**

- Two-way sync between GobbleCube and platform ad consoles
- Platform to GobbleCube sync: Maximum SLA of 3 hours
- Data accuracy maintained through continuous synchronization

**T-1 Data:**

- T-1 data represents yesterday's performance metrics
- Available through `GET /v1/t1-data` endpoint
- Data is refreshed daily

**Historical Data:**

- Historical SOS snapshots available
- Live data available through API endpoints

### Audit & Logging

**Request Tracking:**

- All requests return `X-Request-ID` in response headers
- Request ID used for logging and audit trail
- Include `X-Request-ID` in support requests for faster resolution

**Audit Trail:**

- All API requests logged with: request ID, entity ID, timestamp, payload, response code
- Log retention: 90 days
- Audit trails available through request logs

**Daily Summary Logs:**

- Automated daily summary logs will be sent on email
- Includes all POST and GET activities
- Contact support for access

### API Versioning

**Version Policy:**

- Current version: `v1`
- Backward compatibility maintained across minor versions
- Major versions (breaking changes) released as new version endpoints
- 1 month deprecation notice period for breaking changes
- Communication via Slack channels for version updates

**Versioning Strategy:**

- Standard REST-based versioning
- Version included in URL path: `/v1/...`
- Future versions: `/v2/...`, etc.

### Base URLs

- **Production**: `https://enterprise-api.gobblecube.ai` (Live
    )


**Environment Segregation:**

- Separate accounts for production and sandbox
- Same API endpoints, different account credentials
- IP whitelisting supported per environment

### Security

**Data Encryption:**

- Data encrypted in transit (TLS/HTTPS)
- Data encrypted at rest
- HTTP protocol not allowed (HTTPS only)

**Data Isolation:**

- Customer data in separate databases
- Role-based access control (RBAC) ensures Principle of Least Privilege (POLP)
- Cross-client data access prevented through architecture

**Certifications:**

- SOC2 Type II compliance
- Yearly penetration testing (next report: December 2026)
- MFA enabled by default (no password-based authentication)

Contact Support:
Name: API Support
Email: [ishant.dahiya@gobblecube.ai](https://mailto:ishant.dahiya@gobblecube.ai)

Version: 1.0.0

## Servers

```
https://enterprise-api.gobblecube.ai/
```

## Security

### ApiKeyAuth

Type: apiKey
In: header
Name: x-api-key

## Download OpenAPI description

[GobbleCube Enterprise API FINAL](https://enterprise-api-docs.gobblecube.ai/_bundle/openapi.yaml)

## v1

### Bulk operations orchestrator (bid updates / bid multiplier updates)

 - [POST /v1/bulk-update](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1bulk-update/post.md): Accepts Monet bulk operation format and forwards to Monet for orchestration.

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### List campaigns

 - [GET /v1/campaigns](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns/get.md): List all campaigns with optional filters

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### List cities

 - [GET /v1/cities](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1cities/get.md): List all cities with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### List all products

 - [GET /v1/products](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products/get.md): Get all products with optional filters

### Get T-1 performance data

 - [GET /v1/t1-data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1t1-data/get.md): Retrieve performance data with optional filters

### Get city performance data

 - [GET /v1/city-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1city-performance~1data/get.md): Retrieve city performance data with optional filters

### Get keyword performance data

 - [GET /v1/keyword-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1keyword-performance~1data/get.md): Retrieve keyword performance data with optional filters

### Get product performance data

 - [GET /v1/product-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1product-performance~1data/get.md): Retrieve product performance data with optional filters

### Bulk operations orchestrator (bid updates / bid multiplier updates)

 - [POST /v1/bulk-update](https://enterprise-api-docs.gobblecube.ai/openapi/bulk-update/paths/~1v1~1bulk-update/post.md): Accepts Monet bulk operation format and forwards to Monet for orchestration.

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### List campaigns

 - [GET /v1/campaigns](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns/get.md): List all campaigns with optional filters

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/bid-multipliers/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/update-bid/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### List all products

 - [GET /v1/products](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products/get.md): Get all products with optional filters

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/cities/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### List cities

 - [GET /v1/cities](https://enterprise-api-docs.gobblecube.ai/openapi/cities/paths/~1v1~1cities/get.md): List all cities with optional filters

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/product_group_id/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### Get T-1 performance data

 - [GET /v1/t1-data](https://enterprise-api-docs.gobblecube.ai/openapi/t1-data/paths/~1v1~1t1-data/get.md): Retrieve performance data with optional filters

### Get city performance data

 - [GET /v1/city-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/city-performance/paths/~1v1~1city-performance~1data/get.md): Retrieve city performance data with optional filters

### Get keyword performance data

 - [GET /v1/keyword-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/keyword-performance/paths/~1v1~1keyword-performance~1data/get.md): Retrieve keyword performance data with optional filters

### Get product performance data

 - [GET /v1/product-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/product-performance/paths/~1v1~1product-performance~1data/get.md): Retrieve product performance data with optional filters

## bulk-update

### Bulk operations orchestrator (bid updates / bid multiplier updates)

 - [POST /v1/bulk-update](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1bulk-update/post.md): Accepts Monet bulk operation format and forwards to Monet for orchestration.

### Bulk operations orchestrator (bid updates / bid multiplier updates)

 - [POST /v1/bulk-update](https://enterprise-api-docs.gobblecube.ai/openapi/bulk-update/paths/~1v1~1bulk-update/post.md): Accepts Monet bulk operation format and forwards to Monet for orchestration.

## campaigns

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### List campaigns

 - [GET /v1/campaigns](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns/get.md): List all campaigns with optional filters

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### List campaigns

 - [GET /v1/campaigns](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns/get.md): List all campaigns with optional filters

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/bid-multipliers/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/update-bid/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

## {campaign_id}

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get campaign details

 - [GET /v1/campaigns/{campaign_id}](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D/get.md): Get detailed information about a specific campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/bid-multipliers/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/update-bid/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

## bid-multipliers

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

### Update bid multipliers

 - [POST /v1/campaigns/{campaign_id}/bid-multipliers](https://enterprise-api-docs.gobblecube.ai/openapi/bid-multipliers/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1bid-multipliers/post.md): Update bid multipliers for a campaign

## keywords

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### List keywords in campaign

 - [GET /v1/campaigns/{campaign_id}/keywords](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords/get.md): Get all keywords associated with a specific campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/update-bid/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

## update-bid

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/keywords/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

### Update keyword bids

 - [POST /v1/campaigns/{campaign_id}/keywords/update-bid](https://enterprise-api-docs.gobblecube.ai/openapi/update-bid/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1keywords~1update-bid/post.md): Update bids for one or more keywords in a campaign

## products

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### List all products

 - [GET /v1/products](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products/get.md): Get all products with optional filters

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaigns/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/campaign_id/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### List products in campaign

 - [GET /v1/campaigns/{campaign_id}/products](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1campaigns~1%7Bcampaign_id%7D~1products/get.md): Get all products associated with a specific campaign

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### List all products

 - [GET /v1/products](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products/get.md): Get all products with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/product_group_id/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

## cities

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### List cities

 - [GET /v1/cities](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1cities/get.md): List all cities with optional filters

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/cities/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### List cities

 - [GET /v1/cities](https://enterprise-api-docs.gobblecube.ai/openapi/cities/paths/~1v1~1cities/get.md): List all cities with optional filters

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

## groups

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/cities/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### List city groups

 - [GET /v1/cities/groups](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1cities~1groups/get.md): List all city groups with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### List product groups

 - [GET /v1/products/groups](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1products~1groups/get.md): List all product groups with optional filters

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/product_group_id/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

## {product_group_id}

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/products/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/groups/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

### Get product group details

 - [GET /v1/products/groups/{product_group_id}](https://enterprise-api-docs.gobblecube.ai/openapi/product_group_id/paths/~1v1~1products~1groups~1%7Bproduct_group_id%7D/get.md): Get detailed information about a specific product group

## t1-data

### Get T-1 performance data

 - [GET /v1/t1-data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1t1-data/get.md): Retrieve performance data with optional filters

### Get T-1 performance data

 - [GET /v1/t1-data](https://enterprise-api-docs.gobblecube.ai/openapi/t1-data/paths/~1v1~1t1-data/get.md): Retrieve performance data with optional filters

## city-performance

### Get city performance data

 - [GET /v1/city-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1city-performance~1data/get.md): Retrieve city performance data with optional filters

### Get city performance data

 - [GET /v1/city-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/city-performance/paths/~1v1~1city-performance~1data/get.md): Retrieve city performance data with optional filters

## keyword-performance

### Get keyword performance data

 - [GET /v1/keyword-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1keyword-performance~1data/get.md): Retrieve keyword performance data with optional filters

### Get keyword performance data

 - [GET /v1/keyword-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/keyword-performance/paths/~1v1~1keyword-performance~1data/get.md): Retrieve keyword performance data with optional filters

## product-performance

### Get product performance data

 - [GET /v1/product-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/v1/paths/~1v1~1product-performance~1data/get.md): Retrieve product performance data with optional filters

### Get product performance data

 - [GET /v1/product-performance/data](https://enterprise-api-docs.gobblecube.ai/openapi/product-performance/paths/~1v1~1product-performance~1data/get.md): Retrieve product performance data with optional filters