Authentication
All API requests require an authorization token passed as a header:
Authorization: Bearer <API_TOKEN>
Endpoints
1. Creating an Article
Endpoint:
POST https://ca.searchatlas.com/api/pages/
Payload:
{ "title": "string", "keywords_list": ["string"], "location_id": int, "location": "string" }Example cURL Request:
curl 'https://ca.searchatlas.com/api/pages/' \ -H 'authorization: <API_TOKEN>' \ -H 'content-type: application/json' \ --data-raw '{"title":"Test Title","keywords_list":["test keyword"],"location_id":2840,"location":"United States"}'2. Retrieving Articles
List All Articles
Endpoint:
GET https://ca.searchatlas.com/api/pages/
Retrieve a Single Article
Endpoint:
GET https://ca.searchatlas.com/api/pages/<uuid>
3. Generating an AI Article
Generate an AI Outline
Endpoint:
GET https://ca.searchatlas.com/api/content-fragments/outline-suggestion/
Query Parameters:
content_topic: strcontent_type: str
Generate Full SEO Article
Endpoint:
POST https://ca.searchatlas.com/api/content-fragments/full-seo-article-writer/
Payload:
{ "title": "string", "content_topic": "string", "outline": [ {"h2": "string", "h3s": [{"h3": "string"}]} ], "language": "en", "content_type": "process_full_seo_article_writer", "tone_of_voice": "Professional", "length": "medium" }4. Adding Target Keywords
Endpoint:
POST https://ca.searchatlas.com/api/pages/<uuid>/edit-keywords-data/
Payload:
{ "target_keyword": {"keyword": "searchatlas", "country_code": "US"} }5. Repolling Target Keyword Data
Regular Endpoint:
GET https://ca.searchatlas.com/api/pages/<uuid>/keywords-data/
Light Endpoint:
GET https://ca.searchatlas.com/api/pages/<uuid>/small-keywords-data/
6. iFrame Editor Access
To access the SEO Content Assistant editor:
https://dashboard.linkgraph.com/content/seo-content-assistant-public/<uuid>
Notes
API calls should be spaced appropriately to prevent rate limits.
The regular keyword repolling endpoint should only be called every 3 seconds.
For additional support, refer to the official Search Atlas API Documentation.