6.6 KiB

Raw Blame History

Common Operations

1. Affiliate Networks

List all affiliate networks:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/affiliate_networks"

Create affiliate network:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Network Name","postback_url":"https://example.com/postback"}' \
  "https://$KEITARO_DOMAIN/admin_api/v1/affiliate_networks"

Get specific network:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/affiliate_networks/{id}"

Update network:

curl -X PUT -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Updated Name"}' \
  "https://$KEITARO_DOMAIN/admin_api/v1/affiliate_networks/{id}"

Delete network:

curl -X DELETE -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/affiliate_networks/{id}"

2. Offers

List all offers:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/offers"

Create offer:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Offer Name",
    "affiliate_network_id": 1,
    "payout_value": 10.50,
    "payout_currency": "USD",
    "payout_type": "CPA",
    "offer_type": "external",
    "action_type": "offerRedirect",
    "country": ["US"],
    "state": "active"
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/offers"

Clone offer:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Cloned Offer Name"}' \
  "https://$KEITARO_DOMAIN/admin_api/v1/offers/{id}/clone"

3. Campaigns

List campaigns with pagination:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/campaigns?offset=0&limit=50"

Create campaign:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Campaign Name",
    "alias": "campaign-alias",
    "state": "active",
    "cost_auto_update": false
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/campaigns"

Enable/Disable campaign:

# Enable
curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/campaigns/{id}/enable"

# Disable
curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/campaigns/{id}/disable"

Get campaign streams:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/campaigns/{id}/streams"

4. Domains

List all domains:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/domains"

Add domain:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example.com",
    "state": "active",
    "catch_not_found": false
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/domains"

Check domain status:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/domains/{id}/check"

Get server IP:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/domains/ip"

5. Landing Pages

List landing pages:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/landing_pages"

Create landing page:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Landing Page Name",
    "action_type": "local",
    "action_payload": "<html>...</html>",
    "state": "active"
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/landing_pages"

Upload file to landing page:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -F "file=@/path/to/file.jpg" \
  "https://$KEITARO_DOMAIN/admin_api/v1/landing_pages/{id}/add_file"

Download landing page:

curl -H "Api-Key: $KEITARO_API_KEY" \
  -o landing_page.zip \
  "https://$KEITARO_DOMAIN/admin_api/v1/landing_pages/{id}/download"

6. Statistics

Query click log:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "range": {
      "from": "2026-01-01",
      "to": "2026-01-31",
      "timezone": "UTC"
    },
    "columns": ["campaign_id", "clicks", "conversions"],
    "metrics": ["clicks", "conversions", "revenue"],
    "grouping": ["campaign_id"]
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/clicks/log"

Query conversions:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "range": {
      "from": "2026-01-01",
      "to": "2026-01-31",
      "timezone": "UTC"
    },
    "filters": [{"name": "campaign_id", "operator": "EQUALS", "expression": "123"}]
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/conversions/log"

7. Bot List Management

Get bot list:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/botlist"

Add IPs to bot list:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ips": ["192.168.1.1", "10.0.0.1"]
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/botlist/add"

Remove IPs from bot list:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ips": ["192.168.1.1"]
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/botlist/exclude"

8. Groups (Organization)

List groups:

# Campaigns groups
curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/groups?type=campaigns"

# Offers groups
curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/groups?type=offers"

Create group:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Group Name",
    "type": "campaigns"
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/groups"

9. Third-Party Integrations

List Facebook integrations:

curl -H "Api-Key: $KEITARO_API_KEY" \
  "https://$KEITARO_DOMAIN/admin_api/v1/integrations/facebook"

Create Facebook pixel:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "FB Pixel",
    "pixel_id": "123456789",
    "access_token": "token_here"
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/integrations/facebook"

Assign integration to campaign:

curl -X POST -H "Api-Key: $KEITARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_ids": [1, 2, 3]
  }' \
  "https://$KEITARO_DOMAIN/admin_api/v1/integrations/facebook/{id}/campaign"

6.6 KiB Raw Blame History