Gist Content API

This push-based approach is recommended because:

• Publishers can send content as soon as it's available (ideal for breaking news)
• It removes the dependency on crawlers and scheduled fetches
• It minimizes errors from network timeouts or crawl failures
• It allows publishers to manage their own submission flow

Key Concepts

Publisher Group:
A Publisher Group represents a collection of related publications managed under one umbrella. For example, a large media company might have multiple publications, each with its own domain or external ID, but all fall under the same Publisher Group. The API key for authentication is issued at the Publisher Group level, allowing all associated publications to submit articles through the same credentials.

Publication (or Publisher):
An individual publication or outlet within a Publisher Group. Publications may share the same domain or have distinct external IDs to differentiate them.

API Overview

The ingest API allows partners to submit one or multiple articles. A unique API key is issued at the Publisher Group level for authentication.

⚠️

Authentication is required for all endpoints.

Authentication

All requests require an API key. Include your key in the Authorization header using the Bearer scheme:

Authorization: Bearer <your-api-key>

API keys are provided during onboarding. Contact us if you need access.

Submit a Single Article

Use this endpoint to submit current or new articles.

• Method: POST
• Endpoint: /ingest/article
• Content-Type: application/json

Parameters

Request Example

{
  "publication_external_id": "BillingsGazette",
  "publish_date": "2025-02-18T22:25:35Z",
  "title": "Finland again ranked happiest country",
  "content_type": "text",
  "external_url": "https://billingsgazette.com/article.html",
  "content": "<div><h1>Header</h1><p>Some content here.</p></div>"
}

Success Response

{
  "status": "success",
  "message": "Ingest was successful."
}

Submit Multiple Articles

Use this endpoint to ingest archived or historical articles in bulk.

• Method: POST
• Endpoint: /ingest/multiple_articles
• Content-Type: application/json

Each article must include:

Request Example

[
  {
    "publication_domain": "billingsgazette.com",
    "article_date": "2024-01-18T22:25:35Z",
    "title": "Finland again ranked happiest country",
    "content": "<div><h1>Header</h1><p>Content here.</p></div>",
    "url": "https://billingsgazette.com/article1.html"
  },
  {
    "publication_domain": "billingsgazette.com",
    "article_date": "2024-02-18T22:25:35Z",
    "title": "Some other article",
    "content": "<div><h1>Header</h1><p>More content here.</p></div>",
    "url": "https://billingsgazette.com/article2.html"
  }
]

Success Response

{
  "status": "success",
  "message": "Ingest was successful."
}

Rate Limits

The default rate limit is:

• 10 requests per minute

If you need a higher rate limit, please contact our support team.

Error Handling

You may encounter the following error responses:

Security Considerations

HTML content submitted via the API should be:

• Sanitized to avoid harmful scripts or embedded content (e.g., XSS)
• Well-formed and free from unsupported tags

ProRata is actively reviewing ingestion content for security risks.