API

وسائط IPTC واجهة برمجة تطبيقات الأخبار

مواضيع الإعلام IPTC هي تصنيف إعلامي يتضمن أكثر من 1,200 مصطلح متاح بـ 13 لغة لتصنيف الأخبار والموضوعات النصية. وهي مهمة لأنظمة التحرير، والأرشيفات، والبحث، ووضع العلامات البيانية، وتدفقات العمل في غرف الأخبار.

مرجع API الإصدار: 1.0.0 3 نقاط النهاية المصادقة

عنوان URL الأساسي

https://pressmonitor.com/api

المصادقة

تتطلب جميع الطلبات رؤوس x-api-key و x-subscription-id. يوثّق x-api-key حسابك؛ ويحدّد x-subscription-id الخدمة المشتركة.

x-api-key: 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://pressmonitor.com/api/headlines?code=VALUE" -H "x-api-key: YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

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

fetch("https://pressmonitor.com/api/headlines?code=VALUE", {
  method: "GET",
  headers: {"x-api-key": "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://pressmonitor.com/api/headlines?code=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: 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://pressmonitor.com/api/headlines?code=VALUE", nil)
    req.Header.Set("x-api-key", "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://pressmonitor.com/api/headlines?code=VALUE")
req = Net::HTTP::.new(uri)
req["x-api-key"] = "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://pressmonitor.com/api/briefs?code=VALUE" -H "x-api-key: YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

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

fetch("https://pressmonitor.com/api/briefs?code=VALUE", {
  method: "GET",
  headers: {"x-api-key": "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://pressmonitor.com/api/briefs?code=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: 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://pressmonitor.com/api/briefs?code=VALUE", nil)
    req.Header.Set("x-api-key", "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://pressmonitor.com/api/briefs?code=VALUE")
req = Net::HTTP::.new(uri)
req["x-api-key"] = "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://pressmonitor.com/api/fulltext?code=VALUE" -H "x-api-key: YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

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

fetch("https://pressmonitor.com/api/fulltext?code=VALUE", {
  method: "GET",
  headers: {"x-api-key": "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://pressmonitor.com/api/fulltext?code=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: 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://pressmonitor.com/api/fulltext?code=VALUE", nil)
    req.Header.Set("x-api-key", "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://pressmonitor.com/api/fulltext?code=VALUE")
req = Net::HTTP::.new(uri)
req["x-api-key"] = "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 نجاح