SPsponsorunited
News

Bulk submit news articles for analysis

Accepts either a plain urls array or an articles array carrying per-article data (news tags), creates CuratedNews records in pending status, syncs brand/property/agency relationships and any submitted tags, and dispatches each to the data-ingestion service for content extraction. Re-submitting a URL whose article previously failed returns it to pending and dispatches a fresh analysis; a URL already in the queue is reported as already_exists without dispatching anything, though any submitted tags are still attached.

post/api/news/analyse

Request

Headers

X-Agent-Namestring
Example:News Agent

Name of the agent making the change, for example News Agent. Recorded as created_by_agent / updated_by_agent only when the request carries an agent token; ignored otherwise. At most 100 characters.

Request body

urlsstring[]

Article URLs with no per-article data. Mutually exclusive with articles.

companiesinteger[]
agenciesinteger[]
teamsinteger[]
extract_entitiesboolean

When true (default), entity extraction (brand/property/agency) runs in parallel with contact extraction.

extract_contactsboolean

When true (default), contact extraction runs after markdown conversion completes.

extract_assetsboolean

When true (default), asset extraction runs after markdown conversion completes, in parallel with contact extraction.

Example request

{
  "urls": [
    "https://example.com/article"
  ],
  "articles": [
    {
      "url": "https://example.com/article",
      "news_tag_ids": [
        7
      ],
      "funding": {
        "company": "Acme Labs",
        "website": "https://acmelabs.com",
        "amount_raised": {
          "raw": "$12.5M",
          "value": 12500000,
          "currency": "USD",
          "usd": 12500000
        },
        "valuation": {
          "raw": "$12.5M",
          "value": 12500000,
          "currency": "USD",
          "usd": 12500000
        },
        "funding_round": "Series B",
        "investors": [
          "Sequoia"
        ],
        "market": "Fintech"
      },
      "contacts": [
        {
          "name": "Jane Okafor",
          "role": "Chief Executive Officer",
          "linkedin": "https://www.linkedin.com/in/jane-okafor"
        }
      ]
    }
  ],
  "companies": [
    1
  ],
  "agencies": [
    1
  ],
  "teams": [
    1
  ],
  "extract_entities": true,
  "extract_contacts": true,
  "extract_assets": true
}

Response

URLs submitted for analysis

Changes

No recorded changes to this operation across all 2 revisions of this API.