The Press Release API allows you to programmatically create, generate, and publish AI-driven press releases within the Search Atlas ecosystem. Designed for content, SEO, and PR teams, it helps automate the entire press release lifecycle — from prompt-based generation to publication and indexation tracking — while maintaining full control through secure API access.
With this API, you can build scalable workflows to handle multiple campaigns, track publication metrics, and integrate content generation into your existing systems.
⚙️ Authentication
All requests require authentication via JWT Bearer token or API Key.
🗂️ Headers Required:
Authorization: Bearer <your_jwt_token>
Content-Type: application/json
🧩 Press Release Endpoints
✍️ 1. List Press Releases
Retrieve a paginated list of press releases for the authenticated customer.
Endpoint: GET /api/cg/v1/press-release/
Query Parameters:
page (integer, optional): Page number for pagination (default: 1)
page\_size (integer, optional): Number of results per page (default: 10, max: 100)
otto\_project (integer, optional): Filter by Otto Project ID
knowledge\_graph (integer, optional): Filter by Knowledge Graph ID
status (string, optional): Filter by status (Pending, Generating, Generated, Publishing, Published, etc.)
is\_deleted (boolean, optional): Include soft-deleted press releases (default: false)
cURL Example:
curl -X GET "https://ca.searchatlas.com/api/cg/v1/press-release/?page=1&page_size=10" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"
Success Response (200 OK):
{
"count": 45,
"next": "https://ca.searchatlas.com/api/cg/v1/press-release/?page=2",
"previous": null,
"results": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"otto_project": 123,
"knowledge_graph": 456,
"target_url": "https://example.com/new-product-launch",
"target_keywords": ["new product", "innovation", "technology"],
"input_prompt": "Write a press release about our new AI-powered product launch targeting tech enthusiasts.",
"title": "Company XYZ Unveils Revolutionary AI-Powered Product",
"status": "Generated",
"viewable_url": "https://ca.searchatlas.com/cg/press-release/550e8400-e29b-41d4-a716-446655440000/view",
"editable_url": "https://ca.searchatlas.com/cg/press-release/550e8400-e29b-41d4-a716-446655440000/edit",
"published_at": "2025-01-15T10:30:00Z",
"created_at": "2025-01-10T14:22:00Z",
"updated_at": "2025-01-15T10:30:00Z",
"signal_genesys": {
"genesys_id": "12345",
"genesys_status": "published",
"genesys_status_message": "Successfully published",
"genesys_status_description": "Your press release has been distributed",
"genesys_client_id": "client_abc123"
},
"channels_count": 5,
"channels_count_by_status": {
"Pending": 0,
"Generating": 0,
"Generated": 2,
"Publishing": 0,
"Published": 3
},
"indexation_metrics": {
"total_urls": 15,
"indexed_urls": 12,
"indexation_rate": 0.8
},
"signal_boost": true
}
]
}
🧩 2. Create Press Release
Create a new press release for content generation.
Endpoint: POST /api/cg/v1/press-release/
Required Fields:
target\_url (string): The URL this press release is targeting (must be accessible)
target\_keywords (array of strings): SEO keywords for the press release (min: 1)
input\_prompt (string, max 1500 chars): Instructions for AI content generation
One of the following (not both):
otto\_project (integer): Otto Project ID
knowledge\_graph (integer): Knowledge Graph ID
Optional Fields:
images (array): Array of image objects with url property
bypass\_target\_url\_status\_code\_validation (boolean): Skip URL validation (default: false)
cURL Example:
curl -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"otto_project": 123,
"target_url": "https://example.com/new-product",
"target_keywords": ["AI technology", "product launch", "innovation"],
"input_prompt": "Write a press release announcing our new AI-powered analytics platform. Highlight the key features: real-time insights, predictive analytics, and easy integration. Target audience: B2B SaaS companies.",
"images": [
{"url": "https://example.com/images/product-hero.jpg"}
]
}'
Success Response (201 Created):
{
"id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"otto_project": 123,
"knowledge_graph": 456,
"target_url": "https://example.com/new-product",
"target_keywords": ["AI technology", "product launch", "innovation"],
"input_prompt": "Write a press release announcing our new AI-powered analytics platform...",
"title": null,
"status": "Pending",
"viewable_url": null,
"editable_url": null,
"published_at": null,
"created_at": "2025-01-28T14:30:00Z",
"updated_at": "2025-01-28T14:30:00Z",
"signal_genesys": null,
"channels_count": 0,
"channels_count_by_status": {
"Pending": 0,
"Generating": 0,
"Generated": 0,
"Publishing": 0,
"Published": 0
},
"indexation_metrics": {
"total_urls": 0,
"indexed_urls": 0,
"indexation_rate": 0
},
"signal_boost": false
}
Validation Notes:
target\_url must return 2xx status code (or 403) when validated
target\_keywords must have at least 1 keyword
If otto\_project is provided, target\_url domain must match Otto Project hostname
Cannot provide both otto\_project and knowledge\_graph
📰 3. Retrieve Press Release
Get details of a specific press release by ID.
Endpoint: GET /api/cg/v1/press-release/{id}/
Path Parameters:
id (UUID): Press release ID
cURL Example:
curl -X GET "https://ca.searchatlas.com/api/cg/v1/press-release/550e8400-e29b-41d4-a716-446655440000/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"
Success Response (200 OK):
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"otto_project": 123,
"knowledge_graph": 456,
"target_url": "https://example.com/new-product-launch",
"target_keywords": ["new product", "innovation", "technology"],
"input_prompt": "Write a press release about our new AI-powered product launch...",
"title": "Company XYZ Unveils Revolutionary AI-Powered Product",
"status": "Generated",
"viewable_url": "https://ca.searchatlas.com/cg/press-release/550e8400-e29b-41d4-a716-446655440000/view",
"editable_url": "https://ca.searchatlas.com/cg/press-release/550e8400-e29b-41d4-a716-446655440000/edit",
"published_at": null,
"created_at": "2025-01-10T14:22:00Z",
"updated_at": "2025-01-15T10:30:00Z",
"signal_genesys": null,
"channels_count": 0,
"channels_count_by_status": {
"Pending": 0,
"Generating": 0,
"Generated": 0,
"Publishing": 0,
"Published": 0
},
"indexation_metrics": {
"total_urls": 0,
"indexed_urls": 0,
"indexation_rate": 0
},
"signal_boost": false
}
📄 4. Update Press Release
Modify editable fields such as target_keywords or input_prompt.
Update an existing press release (limited fields can be modified).
Endpoint: PATCH /api/cg/v1/press-release/{id}/
Path Parameters:
id (UUID): Press release ID
Updatable Fields:
target\_url (string): Target URL (must match Otto Project domain if set)
target\_keywords (array): Keywords
input\_prompt (string): Prompt text
images (array): Image URLs
Cannot Modify:
otto\_project
knowledge\_graph
status (changed via actions like /build/)
title (generated by AI)
cURL Example:
curl -X PATCH "https://ca.searchatlas.com/api/cg/v1/press-release/550e8400-e29b-41d4-a716-446655440000/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"target_keywords": ["AI", "machine learning", "automation", "enterprise"],
"input_prompt": "Revised: Focus more on enterprise use cases and ROI benefits."
}'
Success Response (200 OK):
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"otto_project": 123,
"knowledge_graph": 456,
"target_url": "https://example.com/new-product-launch",
"target_keywords": ["AI", "machine learning", "automation", "enterprise"],
"input_prompt": "Revised: Focus more on enterprise use cases and ROI benefits.",
"title": "Company XYZ Unveils Revolutionary AI-Powered Product",
"status": "Generated",
"viewable_url": "https://ca.searchatlas.com/cg/press-release/550e8400-e29b-41d4-a716-446655440000/view",
"editable_url": "https://ca.searchatlas.com/cg/press-release/550e8400-e29b-41d4-a716-446655440000/edit",
"published_at": null,
"created_at": "2025-01-10T14:22:00Z",
"updated_at": "2025-01-28T15:45:00Z",
"signal_genesys": null,
"channels_count": 0,
"channels_count_by_status": {
"Pending": 0,
"Generating": 0,
"Generated": 0,
"Publishing": 0,
"Published": 0
},
"indexation_metrics": {
"total_urls": 0,
"indexed_urls": 0,
"indexation_rate": 0
},
"signal_boost": false
}
🔗 5. Delete Press Release
Soft delete a press release (sets is\_deleted=True).
Endpoint: DELETE /api/cg/v1/press-release/{id}/
Path Parameters:
id (UUID): Press release ID
cURL Example:
curl -X DELETE "https://ca.searchatlas.com/api/cg/v1/press-release/550e8400-e29b-41d4-a716-446655440000/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Success Response (204 No Content)
📤 6. Build Press Release (Generate Content)
Trigger AI content generation for a press release. This creates the actual press release content based on the input prompt.
Endpoint: POST /api/cg/v1/press-release/{id}/build/
Path Parameters:
id (UUID): Press release ID
Process:
-
Validates press release has required information
-
Checks quota limits
-
Queues background task for AI generation
-
Updates status to "Generating"
-
Returns task ID for polling
cURL Example:
curl -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/550e8400-e29b-41d4-a716-446655440000/build/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"
Success Response (202 Accepted):
[
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
]
What Happens:
Press release status changes to "Generating"
Background task generates content using AI (GPT-4, Claude, or Gemini)
Task creates title, summary, and full content
Once complete, status changes to "Generated"
viewable\_url and editable\_url become available
Polling for Completion:
Use the task ID to check status (see Task Polling section).
🔍 7. Deploy to Signal Genesys
Deploy a generated press release to Signal Genesys distribution channels.
Endpoint: POST /api/cg/v1/press-release/{id}/deploy/signal-genesys/
Path Parameters:
id (UUID): Press release ID
Request Body:
genesys\_category\_id (string, required): Signal Genesys category ID
distribution\_ids (array of integers, required): List of distribution channel IDs (min: 1)
variations (boolean, optional): Generate content variations (default: false)
override\_profanity\_check (boolean, optional): Skip profanity check (default: false)
signal\_boost\_enabled (boolean, optional): Enable signal boost feature (default: false)
Prerequisites:
Press release must have status "Generated"
Must have generated content (title, summary, body)
cURL Example:
curl -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/550e8400-e29b-41d4-a716-446655440000/deploy/signal-genesys/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"genesys_category_id": "technology",
"distribution_ids": [1, 3, 5, 7],
"variations": true,
"signal_boost_enabled": true
}'
Success Response (202 Accepted):
{
"task_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
What Happens:
Press release is sent to Signal Genesys for distribution
Creates variations if requested
Distributes to selected channels
Updates status to "Publishing" → "Published"
Media URLs are populated in channels
Validate if content is worthy of being a press release using AI assessment.
Endpoint: POST /api/cg/v1/press-release/check-worthiness/
Request Body:
headline (string, max 80 chars): Main headline
blog\_headline (string): Alternative blog-style headline
summary (string): Brief summary (15-35 words)
blog\_summary (string): Alternative blog-style summary
content (string): Full press release content (1500-2000 words recommended)
cURL Example:
curl -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/check-worthiness/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"headline": "Company XYZ Launches Revolutionary AI Platform",
"blog_headline": "How Company XYZ is Transforming AI Analytics",
"summary": "Company XYZ today announced the launch of its groundbreaking AI-powered analytics platform, designed to help businesses make data-driven decisions in real-time.",
"blog_summary": "Discover how Company XYZ new AI platform is changing the game for businesses seeking real-time analytics and insights.",
"content": "FOR IMMEDIATE RELEASE\n\nCompany XYZ Unveils Revolutionary AI-Powered Analytics Platform\n\n[CITY, STATE] – January 28, 2025 – Company XYZ, a leader in business intelligence solutions, today announced the launch of..."
}'
Success Response (202 Accepted):
{
"task_id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}
Task Result (After Polling):
{
"is_valid": true,
"score": 0.85,
"confidence": 0.92,
"reasoning": "This press release announces a significant product launch with clear business value. It includes specific features, target audience, and demonstrates innovation in the AI analytics space. The content is well-structured and newsworthy.",
"suggestions": [
"Include specific metrics or statistics to strengthen credibility",
"Add a quote from a customer or industry analyst",
"Mention partnerships or integrations with known platforms"
]
}
📦 8. Check Press Release Worthiness
Validate if content is worthy of being a press release using AI assessment.
Endpoint: POST /api/cg/v1/press-release/check-worthiness/
Request Body:
headline (string, max 80 chars): Main headline
blog\_headline (string): Alternative blog-style headline
summary (string): Brief summary (15-35 words)
blog\_summary (string): Alternative blog-style summary
content (string): Full press release content (1500-2000 words recommended)
cURL Example:
curl -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/check-worthiness/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"headline": "Company XYZ Launches Revolutionary AI Platform",
"blog_headline": "How Company XYZ is Transforming AI Analytics",
"summary": "Company XYZ today announced the launch of its groundbreaking AI-powered analytics platform, designed to help businesses make data-driven decisions in real-time.",
"blog_summary": "Discover how Company XYZ new AI platform is changing the game for businesses seeking real-time analytics and insights.",
"content": "FOR IMMEDIATE RELEASE\n\nCompany XYZ Unveils Revolutionary AI-Powered Analytics Platform\n\n[CITY, STATE] – January 28, 2025 – Company XYZ, a leader in business intelligence solutions, today announced the launch of..."
}'
Success Response (202 Accepted):
{
"task_id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}
Task Result (After Polling):
{
"is_valid": true,
"score": 0.85,
"confidence": 0.92,
"reasoning": "This press release announces a significant product launch with clear business value. It includes specific features, target audience, and demonstrates innovation in the AI analytics space. The content is well-structured and newsworthy.",
"suggestions": [
"Include specific metrics or statistics to strengthen credibility",
"Add a quote from a customer or industry analyst",
"Mention partnerships or integrations with known platforms"
]
}
🔧 9. Export Press Release Links
Export media links from press release distribution channels to an Excel file.
Endpoint: POST /api/cg/v1/press-release/export-links/
Rate Limit: 100 requests per day per customer
Request Body:
- •
press\_releases(array, required): List of press release export items - •
id(UUID, required): Press release ID - •
channel\_ids(array of integers, optional): Specific channel IDs to export (empty = all channels)
cURL Example:
curl -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/export-links/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"press_releases": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"channel_ids": [1, 3, 5]
},
{
"id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"channel_ids": []
}
]
}'
Success Response (202 Accepted):
{
"task_id": "d4e5f6a7-b8c9-0123-def0-123456789013"
}
Task Result (After Polling):
{
"file_name": "customer_123-press_release-20250128T143022_a1b2c3d4.xlsx",
"file_url": "https://storage.googleapis.com/ca-images-persistent/customer_123-press_release-20250128T143022_a1b2c3d4.xlsx"
}
🗂️ 10. Get Press Release Channels
Retrieve all distribution channels and their media URLs for a specific press release.
Endpoint: GET /api/cg/v1/press-release/{uuid}/channels/
Path Parameters:
uuid (UUID): Press release ID
cURL Example:
curl -X GET "https://ca.searchatlas.com/api/cg/v1/press-release/550e8400-e29b-41d4-a716-446655440000/channels/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"
Success Response (200 OK):
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": 1,
"distribution": {
"id": 5,
"display_name": "TechCrunch",
"provider": "SIGNAL_GENESYS",
"icon": "https://storage.googleapis.com/bucket/techcrunch-icon.png",
"links_approx": "3-5",
"is_coming_soon": false,
"credits_cost": 50,
"created_at": "2024-01-01T00:00:00Z"
},
"press_release": "550e8400-e29b-41d4-a716-446655440000",
"variation": "550e8400-e29b-41d4-a716-446655440000",
"media_urls": [
{
"url": "https://techcrunch.example.com/article/12345",
"hits": 0,
"indexed": true,
"last_checked_at": "2025-01-28T10:00:00Z",
"check_method": "linkgraph",
"error": null,
"batch_id": 789
},
{
"url": "https://techcrunch.example.com/article/12346",
"hits": 0,
"indexed": false,
"last_checked_at": null,
"check_method": null,
"error": null,
"batch_id": null
}
],
"indexed_media_urls": [
"https://techcrunch.example.com/article/12345"
]
},
{
"id": 2,
"distribution": {
"id": 7,
"display_name": "Forbes",
"provider": "SIGNAL_GENESYS",
"icon": "https://storage.googleapis.com/bucket/forbes-icon.png",
"links_approx": "5-10",
"is_coming_soon": false,
"credits_cost": 75,
"created_at": "2024-01-01T00:00:00Z"
},
"press_release": "550e8400-e29b-41d4-a716-446655440000",
"variation": "7c8d9e0f-1a2b-3c4d-5e6f-7890abcdef12",
"media_urls": [
"https://forbes.example.com/sites/article-abc"
],
"indexed_media_urls": []
}
]
}
Channel Object Fields:
id: Channel ID
distribution: Distribution channel details (name, provider, cost, etc.)
press\_release: Parent press release UUID
variation: Press release variation UUID (can be the same as parent or a variation)
media\_urls: Array of URLs where content was published (with indexation metadata)
indexed\_media\_urls: Subset of URLs confirmed as indexed by search engines
📊 Distribution Endpoints
✍️ List Distributions
Get all available press release distribution channels.
Endpoint: GET /api/cg/v1/press-release/distributions/
Query Parameters:
page (integer, optional): Page number
page\_size (integer, optional): Results per page
cURL Example:
curl -X GET "https://ca.searchatlas.com/api/cg/v1/press-release/distributions/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"
Success Response (200 OK):
{
"count": 25,
"next": null,
"previous": null,
"results": [
{
"id": 1,
"display_name": "TechCrunch",
"provider": "SIGNAL_GENESYS",
"icon": "https://storage.googleapis.com/bucket/techcrunch-icon.png",
"links_approx": "3-5",
"is_coming_soon": false,
"credits_cost": 50,
"created_at": "2024-01-01T00:00:00Z"
},
{
"id": 2,
"display_name": "Forbes",
"provider": "SIGNAL_GENESYS",
"icon": "https://storage.googleapis.com/bucket/forbes-icon.png",
"links_approx": "5-10",
"is_coming_soon": false,
"credits_cost": 75,
"created_at": "2024-01-01T00:00:00Z"
},
{
"id": 3,
"display_name": "Business Insider",
"provider": "SIGNAL_GENESYS",
"icon": "https://storage.googleapis.com/bucket/business-insider-icon.png",
"links_approx": "2-4",
"is_coming_soon": false,
"credits_cost": 60,
"created_at": "2024-01-01T00:00:00Z"
},
{
"id": 10,
"display_name": "Wall Street Journal",
"provider": "SIGNAL_GENESYS",
"icon": "https://storage.googleapis.com/bucket/wsj-icon.png",
"links_approx": "10-15",
"is_coming_soon": true,
"credits_cost": 150,
"created_at": "2024-06-01T00:00:00Z"
}
]
}
Distribution Fields:
id: Distribution channel ID (use in deployment)
display\_name: Human-readable channel name
provider: Always "SIGNAL_GENESYS" (only provider currently supported)
icon: Logo/icon URL for the channel
links\_approx: Approximate number of backlinks generated
is\_coming\_soon: If true, channel is not yet available
credits\_cost: Number of credits required to use this channel
created\_at: When the distribution was added to the system
🛠️ Task Polling
Many endpoints return HTTP 202 with a task\_id. Use the Core API to poll for task completion.
Endpoint: GET /api/core/v1/tasks/{task\_id}/
cURL Example:
curl -X GET "https://ca.searchatlas.com/api/core/v1/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Response - Task Pending:
{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "PENDING"
}
Response - Task In Progress:
{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "STARTED"
}
Response - Task Success:
{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "SUCCESS",
"result": {
"file_name": "customer_123-press_release-20250128T143022_a1b2c3d4.xlsx",
"file_url": "https://storage.googleapis.com/ca-images-persistent/customer_123-press_release-20250128T143022_a1b2c3d4.xlsx"
}
}
Response - Task Failed:
{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "FAILURE",
"error": "Quota exceeded: Insufficient credits for press release generation"
}
Task Statuses:
PENDING: Task queued but not started
STARTED: Task is currently executing
SUCCESS: Task completed successfully (check result field)
FAILURE: Task failed (check error field)
RETRY: Task failed but will retry automatically
Polling Strategy:
Poll every 2-5 seconds for short tasks (build, deploy)
Poll every 10-30 seconds for long tasks (export)
Stop polling after SUCCESS or FAILURE
Implement exponential backoff for production use
🧱 Error Responses
🧩 400 Bad Request
Invalid input data or validation errors.
{
"target_url": ["Invalid Target URL: URL responded with status code 404 (Not Found)"],
"target_keywords": ["This field is required."]
}
📰 401 Unauthorized
Missing or invalid authentication token.
{
"detail": "Authentication credentials were not provided."
}
📄 403 Forbidden
User does not have permission to access the resource.
{
"detail": "You do not have permission to perform this action."
}
🔗 404 Not Found
Resource does not exist.
{
"detail": "Not found."
}
📤 422 Unprocessable Entity
Business logic validation failure.
{
"detail": "Otto Project is frozen"
}
🔍 429 Too Many Requests
Rate limit exceeded.
{
"detail": "Request was throttled. Expected available in 86400 seconds."
}
📦 500 Internal Server Error
Server-side error.
{
"detail": "An error occurred while processing your request."
}
📈 Rate Limits
🔧 Press Release Export
Limit: 100 requests per day per customer
Endpoint: POST /api/cg/v1/press-release/export-links/
Response when exceeded: HTTP 429
🗂️ General API Limits
Standard rate limits apply per customer account
Contact support for rate limit increases
🧱✍️ Press Release Statuses
Pending: Created but not yet processed
Generating: AI content generation in progress
Generated: Content generated successfully
Publishing: Deployment to channels in progress
Publish stuck: Deployment encountered issues
Publish failed: Deployment failed permanently
Published: Successfully deployed to all channels
🔁 Workflow Examples
📰 Complete Press Release Workflow
Step 1: Create press release
PR_ID=$(curl -s -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"otto_project": 123,
"target_url": "https://example.com/product",
"target_keywords": ["AI", "innovation"],
"input_prompt": "Announce our new AI product"
}' | jq -r '.id')
echo "Created PR: $PR_ID"
Step 2: Generate content
BUILD_TASK=$(curl -s -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/$PR_ID/build/" \
-H "Authorization: Bearer $TOKEN" | jq -r '.[0]')
echo "Build task: $BUILD_TASK"
Step 3: Poll for completion
while true; do
STATUS=$(curl -s "https://ca.searchatlas.com/api/core/v1/tasks/$BUILD_TASK/" \
-H "Authorization: Bearer $TOKEN" | jq -r '.status')
if [ "$STATUS" = "SUCCESS" ]; then
echo "Build complete!"
break
elif [ "$STATUS" = "FAILURE" ]; then
echo "Build failed!"
exit 1
fi
echo "Status: $STATUS, waiting..."
sleep 5
done
Step 4: Deploy to channels
DEPLOY_TASK=$(curl -s -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/$PR_ID/deploy/signal-genesys/" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"genesys_category_id": "technology",
"distribution_ids": [1, 2, 3],
"variations": true
}' | jq -r '.task_id')
echo "Deploy task: $DEPLOY_TASK"
# Step 5: Export links after deployment completes
curl -X POST "https://ca.searchatlas.com/api/cg/v1/press-release/export-links/" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "{
"press_releases": [
{"id": "$PR_ID", "channel_ids": []}
]
}"
💡 Support & Resources
Swagger/OpenAPI Docs: https://ca.searchatlas.com/schema/swagger/
Base URL: https://ca.searchatlas.com/api/cg/v1
Support: Contact your Search Atlas account manager
API Version: v1. (stable)
❓FAQs
❓ Can I use the API without authentication?
💡 No. All requests must include a valid JWT token or API key.
❓ What happens if I send both otto_project and knowledge_graph?
⚡ The API will return a 400 Bad Request error. You must include only one.
❓ How can I check publication status in Signal Genesys?
💡 Review the signal_genesys.genesys_status field in the press release response.
The Press Release API enables teams to automate every step of their press release workflow — from creation and generation to publication and analysis.
If you need additional examples or support, our API team is here to help.