API Documentation

Seamlessly integrate content into your platform. Use our REST API to fetch, display, and manage articles submitted to your blog.

Getting Started

The BlogPostMarket API allows blog owners to retrieve submitted articles and integrate them into their websites programmatically.

Base URL https://api.blogpostmarket.com

Authentication

All API requests require an API key. Include it in the request header: 

Authorization: Bearer YOUR_API_KEY

Generate your API key from your dashboard settings.

Endpoints

GET /api/articles

Retrieve a paginated list of all submitted articles for your blog.

Query Parameters

status optional

Filter by status: DRAFT, SUBMITTED, IN_REVIEW, PUBLISHED, DECLINED

limit optional, default: 10

Maximum number of articles to return.

offset optional, default: 0

Number of articles to skip (for pagination).

Example Request 

curl -X GET "https://api.blogpostmarket.com/api/articles?status=PUBLISHED&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response 

{
  "articles": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "How to Optimize Your Blog for SEO",
      "slug": "how-to-optimize-your-blog-for-seo",
      "author": "John Doe",
      "status": "PUBLISHED",
      "publishedAt": "2025-12-14T10:30:00Z",
      "contentUrl": "https://...",
      "link": "https://yourblog.com/articles/...",
      "thumbnail": "https://..."
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

GET /api/article/:id

Retrieve detailed information about a specific article by its ID.

Path Parameters

id required

The unique identifier (UUID) of the article.

Example Request 

curl -X GET "https://api.blogpostmarket.com/api/article/550e8400..." \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response 

{
  "article": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "How to Optimize Your Blog for SEO",
    "slug": "how-to-optimize-your-blog-for-seo",
    "author": "John Doe",
    "thumbnail": "https://...",
    "contentUrl": "https://...",    
    "publishedAt": "2025-12-14T10:30:00Z",
    "status": "PUBLISHED",   
    "content": "<p>Your article content in HTML format...</p>",
  }
}

HTTP Status Codes

200

OK

Request was successful.

400

Bad Request

Invalid query parameters or request format.

401

Unauthorized

Missing or invalid API key.

404

Not Found

Article not found.

429

Too Many Requests

Rate limit exceeded.

Rate Limiting

API requests are rate-limited to 1000 requests per hour per API key to ensure fair usage and stability.

Rate limit information is returned in the response headers: 

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1702548000

Best Practices

✓

Cache responses

Cache article data to reduce API calls and improve page load times.

✓

Use pagination

Always use limit and offset parameters to paginate large datasets.

✓

Handle errors gracefully

Implement retry logic and proper error handling in your integration.

✓

Keep API keys secure

Never expose API keys in client-side code. Use environment variables.

Need Integration Help?

Check our Discord community or contact support if you run into issues.

Contact Support