Table of Contents
Overview
The Ascend API allows you to programmatically access and manage your content. You can create briefs, generate articles, publish to CMS platforms, and more. Webhooks enable real-time notifications when events occur in your account.
Base URL
https://api.ascend.deals/v1Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header of each request.
Keep your API key secure
Your API key provides full access to your account. Never share it or commit it to public repositories.
Authorization: Bearer asc_live_xxxxxxxxxxxxxxxxAPI Endpoints
Here are the main endpoints available in the Ascend API:
/api/v1/briefsList all briefs for the authenticated user/api/v1/briefsCreate a new SEO brief/api/v1/briefs/{id}Get a specific brief by ID/api/v1/articlesList all articles/api/v1/articlesGenerate a new article from a brief/api/v1/publishPublish an article to connected CMSFull API reference with request/response schemas coming soon. Contact support for detailed documentation.
Webhooks
Webhooks allow you to receive real-time notifications when events occur in your Ascend account. Configure webhook URLs in your settings to receive POST requests when specific events happen.
Available Events
brief.createdTriggered when a new brief is generated
{ brief_id, keyword, created_at, user_id }article.generatedTriggered when an article finishes generating
{ article_id, brief_id, status, word_count }article.publishedTriggered when content is published to a CMS
{ article_id, platform, url, published_at }article.scheduledTriggered when content is scheduled
{ article_id, scheduled_at, timezone }Rate Limits
To ensure fair usage, API requests are rate limited. Limits vary by plan:
Trial Plan
- • 100 requests per hour
- • 5 brief generations per day
- • Limited API endpoints
Pro Plan
- • 1,000 requests per hour
- • Unlimited brief generations
- • Full API access
- • Priority support
Code Examples
curl -X GET "https://api.ascend.deals/v1/briefs" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"const response = await fetch('https://api.ascend.deals/v1/briefs', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
const briefs = await response.json();import requests
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
response = requests.get(
'https://api.ascend.deals/v1/briefs',
headers=headers
)
briefs = response.json()Error Handling
The API returns standard HTTP status codes and JSON error responses:
200400401404429500Frequently Asked Questions
Do I need a special plan to use the API?
Is the API rate limited?
Can I use webhooks with Zapier?
How do I handle API errors?
Was this guide helpful?
Your feedback helps us improve our documentation.