API Documentation

Request Body

{
  "username": "your_username",
  "password": "your_password"
}

Response

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "expires": "2026-01-30T12:00:00+00:00",
  "user_id": 123,
  "role": "cm_client"
}

Query Parameters

page	integer	Page number (default: 1)
per_page	integer	Results per page (default: 20, max: 100)
status	string	Filter by status: active, inactive, pending
search	string	Search by company name or website

Example Request

curl -X GET "https://clickmedias.com/wp-json/clickmedias/v1/clients?page=1&per_page=10" \
  -H "X-API-Key: your_api_key"

$response = wp_remote_get(
    'https://clickmedias.com/wp-json/clickmedias/v1/clients',
    array(
        'headers' => array(
            'X-API-Key' => 'your_api_key'
        )
    )
);

$data = json_decode(wp_remote_retrieve_body($response), true);

const response = await fetch('https://clickmedias.com/wp-json/clickmedias/v1/clients', {
    headers: {
        'X-API-Key': 'your_api_key'
    }
});

const data = await response.json();

Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "company_name": "Acme Corp",
      "website_url": "https://acme.com",
      "contact_email": "contact@acme.com",
      "plan_type": "business",
      "status": "active",
      "created_at": "2026-01-01 00:00:00"
    }
  ],
  "meta": {
    "total": 45,
    "page": 1,
    "per_page": 10,
    "total_pages": 5
  }
}

Path Parameters

id

integer

Required. The client ID.

Response

{
  "success": true,
  "data": {
    "id": 1,
    "user_id": 123,
    "company_name": "Acme Corp",
    "website_url": "https://acme.com",
    "contact_name": "John Doe",
    "contact_email": "john@acme.com",
    "contact_phone": "+1 555-0123",
    "industry": "Technology",
    "plan_type": "business",
    "status": "active",
    "backlink_count": 45,
    "citation_count": 32,
    "last_crawl_date": "2026-01-20 12:00:00",
    "created_at": "2026-01-01 00:00:00"
  }
}

Request Body

company_name	string	Required. Company name.
website_url	string	Required. Full website URL.
contact_email	string	Required. Contact email address.
contact_name	string	Contact person's name.
contact_phone	string	Contact phone number.
industry	string	Business industry.
plan_type	string	Plan: starter, advanced, business, agency

Example Request

curl -X POST "https://clickmedias.com/wp-json/clickmedias/v1/clients" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "New Company",
    "website_url": "https://newcompany.com",
    "contact_email": "hello@newcompany.com",
    "plan_type": "advanced"
  }'

Send only the fields you want to update.

Query Parameters

limit

integer

Number of reports to return (default: 12)

Response

{
  "success": true,
  "data": {
    "id": 42,
    "client_id": 1,
    "report_date": "2026-01-15",
    "seo_score": 78,
    "aiso_score": 72,
    "ai_visibility_score": 65,
    "domain_authority": 45,
    "organic_traffic": 12500,
    "month_over_month": {
      "seo_score_change": 5,
      "aiso_score_change": 8,
      "da_change": 2,
      "traffic_change": 1500
    },
    "year_over_year": {
      "seo_score_change": 23,
      "aiso_score_change": 31,
      "traffic_change": 8500
    },
    "recommendations": [
      {
        "title": "Optimize meta descriptions",
        "description": "Update meta descriptions on 15 pages",
        "priority": "high"
      }
    ],
    "pdf_url": "https://..."
  }
}

This will create a new report based on the latest crawl data.

Response

{
  "success": true,
  "data": {
    "seo_score": 78,
    "aiso_score": 72,
    "ai_visibility_score": 65,
    "domain_authority": 45,
    "organic_traffic": 12500
  }
}

Query Parameters

months

integer

Number of months (default: 12)

Response

{
  "success": true,
  "data": {
    "history": [
      {
        "report_date": "2026-01-15",
        "seo_score": 78,
        "aiso_score": 72,
        "domain_authority": 45,
        "organic_traffic": 12500
      },
      {
        "report_date": "2025-12-15",
        "seo_score": 73,
        "aiso_score": 64,
        "domain_authority": 43,
        "organic_traffic": 11000
      }
    ],
    "growth": {
      "seo_growth": 23,
      "aiso_growth": 31,
      "da_growth": 12,
      "traffic_growth": 8500,
      "traffic_growth_percent": 68.2
    }
  }
}

Query Parameters

client_id	integer	Filter by client
status	string	Filter: pending, processing, completed, failed

Request Body

client_id	integer	Required. Client to crawl.
type	string	Crawl type: full, partial, technical

Response

{
  "success": true,
  "data": {
    "crawl_id": 123,
    "status": "pending"
  }
}

Request Body

email	string	Required. Email address.
website_url	string	Required. Website to audit.
name	string	Contact name.
company	string	Company name.

Response

{
  "success": true,
  "data": {
    "audit_id": 456,
    "key": "abc123...",
    "status": "pending",
    "results_url": "https://.../audit-results/?id=456&key=abc123..."
  }
}

Query Parameters

status	string	draft, published, approved
type	string	blog, press_release, social

Request Body

type	string	Content type: blog, press_release
topic	string	Topic or title suggestion

Query Parameters

status

string

pending, approved, deployed, dismissed

Request Body

url	string	Required. Your webhook endpoint URL.
events	array	Events to subscribe to (or ["*"] for all)

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://your-app.com/webhooks/clickmedias",
    "events": ["report.generated", "crawl.completed"],
    "secret": "whsec_abc123..."
  }
}