Terra-Orb API

Të gjitha të dhënat e drejtpërdrejta të Terra-Orb - ngjarje, artikuj, sinjale të hershme, barometra, mbulim global - në JSON, vetëm për lexim, për të fuqizuar Terra-OSINT ose çdo mjet tjetër analize. Çdo artikull vjen me tekstin e tij të plotë të kapur, përmbledhjen, URL-në origjinale, botuesin dhe datat e sakta; /ask kthen fragmentin e secilit burim në të cilin është mbështetur.

Praktikat më të mira për rezultate të sakta

  • · Dërgoni fjalë kyçe të shkurtra (entitete + terma kyç), p.sh. q=Ujërat e zeza baske të Suezit, në vend të një titulli të plotë. Pyetjet e gjata reduktohen automatikisht në 5 fjalët e tyre më të dallueshme (fjalë ndaluese janë hequr); përgjigja i tregon ato në termat_pyetës.
  • · Përdorimi /artikuj për mbulimin real të shtypit (teksti i plotë, data, domeni burimor). /sinjale është një furnizim global i paralajmërimit të hershëm: gjithmonë kaloni q për të mbajtur vetëm sinjale që përputhen.
  • · Pyetje /artikuj, /ngjarje dhe /sinjale paralelisht, më pas aplikoni pragun tuaj të rëndësisë (p.sh. ngjashmëria ≥ 0,25 me titullin tuaj të referencës) përpara shfaqjes.

Qasja dhe çmimi

API është pjesë e shërbimit me pagesë: çelësi krijohet nga një llogari Terra-Orb dhe faturohet në kredi, vetëm në ditët kur thirret.

  • · 30 kredite ne dite perdorimi, me 1,000 kërkesat e përfshira.
  • · 10 kredite për bllok të 1,000 kërkesa përtej kësaj.
  • · API paguani ndërsa shkoni; abonimet e leximit dhe hetimit janë të ndara.
Oferta e tregutÇmimi i sajVëllimiTerra-OrB
TheNewsAPI / Standard MediaStack99 dollarë në muaj10,000 deri në 30,000 kërkesa≈ 72 dollarë / muaj
MediaStack Professional249 dollarë në muaj50 mijë kërkesa≈ 184 dollarë / muaj
NewsAPI Business449 dollarë në muaj250,000 kërkesa≈ 332 dollarë / muaj

Me volum të barabartë, Terra-OrB kushton rreth 20% më pak se këto abonime, pa asnjë angazhim mujor: ju paguani vetëm për ditët e thirrura në të vërtetë dhe në 222 vende dhe territore të monitoruara (shumica e mbuluar çdo ditë) në vend të një përzgjedhjeje pikash në gjuhën angleze.

Shesh lojërash interaktive

Zgjidh një shembull ose modifiko kërkesën, ngjit çelësin tënd dhe shiko JSON të drejtpërdrejtë. Çelësi juaj qëndron në këtë skedë të shfletuesit dhe nuk ruhet kurrë. Telefonatat llogariten në përdorimin tuaj si çdo tjetër.

MERRNI /api/public/v1
curl -H "Autorizimi: Bartësi $TERRA_ORB_KEY" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"

Pikat fundore

Baza: /api/public/v1 — të gjitha përgjigjet janë në JSON dhe përfshijnë gjeneruar_at.

MERRNI/api/public/v1/ngjarje— Ngjarjet

Ngjarjet e bashkuara nga 24 orët e fundit: datat e sakta/të përafërta, vendet emetuese dhe përkatëse, gjuhët, numri i mediave dhe artikujve, toni, intensiteti.

Parametrat: tema, emitter=FR, rreth=IR, kërko, rendit=media|të fundit|data|intensite, limit≤300

MERRNI/api/public/v1/events/{id}— Detajet e ngjarjes

Të dhënat e plota: ndarja e mbulimit (pronësia, orientimi, vendi, gjuha) dhe artikuj të ngjashëm.

Parametrat: asnjë

MERRNI/api/public/v1/artikuj— Artikuj të papërpunuar

Artikujt nga 24 orët e fundit: titulli, URL-ja kanonike, data e ngjarjes kundrejt datës së publikimit, shteti, tema, toni, lloji i daljes (dixhitale/radio/TV/print), rrjeti social.

Parametrat: q (teksti i plotë), nga/në (datat ISO), scope=live|arkivi|të gjitha (arkivi ≈ 1 vit), tema, emituesi, rreth, gjuha=fr, forma=dixhitale|radio|tv|printimi, para=<data ISO> (mallkimi i faqeve), limit≤200

MERRNI/api/public/v1/pyet— Motori i përgjigjes së AI (kyç i plotë)

Pyetje në formë të lirë: arkivi Terra-OrB më pas ueb publik, arsyetimi kritik, përmbledhja e cituar [n], matrica e ndikimit me 4 domene, burimet, vazhdimet.

Parametrat: MERRNI ?q=...&mode=fast|thellë, ose POST JSON {pyetje, modalitet}

MERRNI/api/public/v1/sinjale— Vroege signalen

Ngjarjet e zbuluara përpara dukshmërisë së gjerë: statusi, besimi, shkalla e përshpejtimit, koha e kryerjes, plus statistikat globale.

Parametrat: q (fjalë kyçe, të gjitha duhet të përputhen), status=zbuloj|konfirmoj|repris, limit≤300

MERRNI/api/public/v1/barometra— Barometra

Frekuenca dhe toni i ndërthurur sipas temës, vendit dhe gjuhës: vëllimi, daljet, ndjenjat, intensiteti, tensioni, niveli i situatës.

Parametrat: asnjë

MERRNI/api/public/v1/mbulim— Mbulimi global

Regjistroni statusin sipas vendit: media aktive, artikuj të fundit, gjuhë, status (i mbuluar / i dobët / mungon / nuk ka prizë lokale).

Parametrat: asnjë

MERRNI/api/public/v1/burimet— Drejtoria e medias

Dyqane aktive: emri, shteti, gjuha, lloji, kanali (furnizimi, faqja, rrjeti social), pronësia dhe orientimi i dokumentuar, besueshmëria.

Parametrat: country=FR, language=ar, form=tv, kind=media|social, before=<id> (mallkimi i faqeve), limit≤500

Shembull

curl -H "Autorizimi: Bartësi tm_votre_cle" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"

Kodet e gabimit: 401 (çelësi mungon, i panjohur ose i revokuar), 402 (kreditet e shteruara), 400 (parametrat e pavlefshëm), 404 (burimi nuk u gjet). Fletëzimi i artikujve dhe burimeve përdor një kursor: dërgo vlerën tjetër_kursori në parametrin përpara.