API

منتجات IAB واجهة برمجة تطبيقات الأخبار

يعمل تصنيف منتجات الإعلانات IAB على توحيد كيفية وصف المعلنين للمنتج أو الخدمة المتروّج لها في الإعلان. يعدّ ذلك مهمًا لرقابة الناشرين، وحوكمة الإعلانات، وتحليل وسائل الإعلام التجارية، وتصنيف الفئات التجارية بشكل أوضح.

مرجع 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 نجاح