> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thepublive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Make your first Publive API call in under 5 minutes. Fetch a live post list from the Content Delivery API using curl, JavaScript, or your preferred language.

This guide walks you through making your first API call to Publive.

## Step 1: Get your API credentials

The Publive API uses HTTP Basic Auth. You need your **API Key**, **API Secret**, and **Publisher ID**.

1. Log in to your [Publive Dashboard](https://dashboard.thepublive.com/v2/configurations/api-developer-hub).
2. Navigate to **configurations** > **API Developer Hub**.
3. Click the **View API credentials** button.
4. Copy your **API Key** and **API Secret**.
5. Note your **Publisher ID** from the dashboard URL.

<Note>
  If you do not have dashboard access, please reach out via our [contact page](https://thepublive.com/contact-us).
</Note>

Generate your Base64 token by running:

```bash theme={null}
echo -n 'YOUR_API_KEY:YOUR_API_SECRET' | base64
```

<Info>
  **Important:** Keep your API credentials secure. Never expose them in client-side code or public repositories.
</Info>

## Step 2: Make your first API call

Fetch your published posts using the Content Delivery API:

```bash theme={null}
curl -X GET \
  'https://cds.thepublive.com/publisher/YOUR_PUBLISHER_ID/posts/?limit=5' \
  -H 'Authorization: Basic <BASE64_AUTH_TOKEN>'
```

## Step 3: Understand the response

```json theme={null}
{
  "status": "ok",
  "data": [
    {
      "id": 12345,
      "title": "My First Article",
      "slug": "my-first-article",
      "type": "Article",
      "primary_category": {
        "id": 1,
        "name": "News",
        "slug": "news"
      },
      "contributors": [
        {
          "id": 1,
          "name": "John Doe",
          "slug": "john-doe"
        }
      ],
      "content_html": "<p>Article content here...</p>",
      "absolute_url": "/news/my-first-article-12345"
    }
  ],
  "message": "",
  "page_no": 1,
  "per_page": 5
}
```

<Tip>
  **That's it!** You've successfully fetched content from Publive. The response includes the full post object with title, content, categories, tags, authors, and metadata.
</Tip>

## Step 4: Create content via CMS API

To create a new post programmatically, use the Content Management API:

```bash theme={null}
curl -X POST \
  'https://cms.thepublive.com/publisher/YOUR_PUBLISHER_ID/post/' \
  -H 'Authorization: Basic <BASE64_AUTH_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "My API-Created Post",
    "english_title": "My API-Created Post",
    "type": "Article",
    "status": "Draft",
    "primary_category": 1,
    "content": "<p>Hello from the API!</p>"
  }'
```

## What's next?

* [Authentication](/dxp/documentation/getting-started/authentication) — Learn about API authentication in detail
* [Core Concepts](/dxp/documentation/getting-started/core-concepts) — Understand posts, categories, tags, and content types
* [Content Delivery API](/dxp/api-reference/content-delivery/README) — Full CDS API reference
* [Content Management API](/dxp/api-reference/content-management/README) — Full CMS API reference