API

IPTC 미디어 뉴스 API

IPTC 미디어 주제는 뉴스 및 텍스트 주제를 분류하기 위해 13개 언어로 제공되는 1,200개 이상의 용어로 구성된 미디어 분류 체계입니다. 이는 편집 시스템, 아카이브, 검색, 메타데이터 태깅 및 뉴스룸 워크플로우에 중요합니다.

API 참조 버전: 1.0.0 3 엔드포인트 인증

기본 URL

https://api.pressmonitor.com

인증

모든 요청은 Bearer 토큰 인증을 사용합니다. 각 호출에 Authorization 헤더를 추가하세요.

Authorization: Bearer YOUR_API_KEY
x-subscription-id: YOUR_SUB_ID

GET /headlines

뉴스 헤드라인 가져오기

매개변수

이름	유형	위치	필수	설명
code	`string`	query	예	엔터티 코드(예: 티커 심볼, 산업 코드)
lang_code	`string`	query	아니요	언어 코드로 필터링(ISO 639-1)
country_code	`string`	query	아니요	국가 코드로 필터링(ISO 3166-1 alpha-2)
count	`integer`	query	아니요	결과 반환 개수
cursor	`string`	query	아니요	페이지네이션 커서 (search_after 대체)이며
sort	`string`	query	아니요	정렬 순서 (날짜 또는 관련성)
date_from	`string`	query	아니요	뉴스 시작일 (YYYY-MM-DD 형식)
date_to	`string`	query	아니요	뉴스 종료일 (YYYY-MM-DD 형식)

코드 예제

curl -X GET "https://api.pressmonitor.com/headlines?code=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://api.pressmonitor.com/headlines?code=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.com/headlines?code=VALUE", {
  method: "GET",
  headers: {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
})
  .then(r => r.json())
  .then(console.log);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.pressmonitor.com/headlines?code=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY", "x-subscription-id: YOUR_SUB_ID"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.pressmonitor.com/headlines?code=VALUE", nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("x-subscription-id", "YOUR_SUB_ID")
    resp, _ := http.DefaultClient.Do(req)
    body, _ := io.ReadAll(resp.Body)
    resp.Body.Close()
    fmt.Println(string(body))
}

require 'net/http'

uri = URI("https://api.pressmonitor.com/headlines?code=VALUE")
req = Net::HTTP::.new(uri)
req["Authorization"] = "Bearer YOUR_API_KEY"
req["x-subscription-id"] = "YOUR_SUB_ID"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

응답

200 성공

GET /briefs

뉴스 요약 가져오기

매개변수

이름	유형	위치	필수	설명
code	`string`	query	예	엔터티 코드(예: 티커 심볼, 산업 코드)
lang_code	`string`	query	아니요	언어 코드로 필터링(ISO 639-1)
country_code	`string`	query	아니요	국가 코드로 필터링(ISO 3166-1 alpha-2)
count	`integer`	query	아니요	결과 반환 개수
cursor	`string`	query	아니요	페이지네이션 커서 (search_after 대체)이며
sort	`string`	query	아니요	정렬 순서 (날짜 또는 관련성)
date_from	`string`	query	아니요	뉴스 시작일 (YYYY-MM-DD 형식)
date_to	`string`	query	아니요	뉴스 종료일 (YYYY-MM-DD 형식)

코드 예제

curl -X GET "https://api.pressmonitor.com/briefs?code=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://api.pressmonitor.com/briefs?code=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.com/briefs?code=VALUE", {
  method: "GET",
  headers: {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
})
  .then(r => r.json())
  .then(console.log);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.pressmonitor.com/briefs?code=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY", "x-subscription-id: YOUR_SUB_ID"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.pressmonitor.com/briefs?code=VALUE", nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("x-subscription-id", "YOUR_SUB_ID")
    resp, _ := http.DefaultClient.Do(req)
    body, _ := io.ReadAll(resp.Body)
    resp.Body.Close()
    fmt.Println(string(body))
}

require 'net/http'

uri = URI("https://api.pressmonitor.com/briefs?code=VALUE")
req = Net::HTTP::.new(uri)
req["Authorization"] = "Bearer YOUR_API_KEY"
req["x-subscription-id"] = "YOUR_SUB_ID"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

응답

200 성공

GET /fulltext

전체 뉴스 본문 가져오기

매개변수

이름	유형	위치	필수	설명
code	`string`	query	예	엔터티 코드(예: 티커 심볼, 산업 코드)
lang_code	`string`	query	아니요	언어 코드로 필터링(ISO 639-1)
country_code	`string`	query	아니요	국가 코드로 필터링(ISO 3166-1 alpha-2)
count	`integer`	query	아니요	결과 반환 개수
cursor	`string`	query	아니요	페이지네이션 커서 (search_after 대체)이며
sort	`string`	query	아니요	정렬 순서 (날짜 또는 관련성)
date_from	`string`	query	아니요	뉴스 시작일 (YYYY-MM-DD 형식)
date_to	`string`	query	아니요	뉴스 종료일 (YYYY-MM-DD 형식)

코드 예제

curl -X GET "https://api.pressmonitor.com/fulltext?code=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://api.pressmonitor.com/fulltext?code=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.com/fulltext?code=VALUE", {
  method: "GET",
  headers: {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
})
  .then(r => r.json())
  .then(console.log);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.pressmonitor.com/fulltext?code=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY", "x-subscription-id: YOUR_SUB_ID"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.pressmonitor.com/fulltext?code=VALUE", nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("x-subscription-id", "YOUR_SUB_ID")
    resp, _ := http.DefaultClient.Do(req)
    body, _ := io.ReadAll(resp.Body)
    resp.Body.Close()
    fmt.Println(string(body))
}

require 'net/http'

uri = URI("https://api.pressmonitor.com/fulltext?code=VALUE")
req = Net::HTTP::.new(uri)
req["Authorization"] = "Bearer YOUR_API_KEY"
req["x-subscription-id"] = "YOUR_SUB_ID"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

응답

200 성공