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
/artikujpër mbulimin real të shtypit (teksti i plotë, data, domeni burimor)./sinjaleështë një furnizim global i paralajmërimit të hershëm: gjithmonë kaloniqpër të mbajtur vetëm sinjale që përputhen. - · Pyetje
/artikuj,/ngjarjedhe/sinjaleparalelisht, 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 saj | Vëllimi | Terra-OrB |
|---|---|---|---|
| TheNewsAPI / Standard MediaStack | 99 dollarë në muaj | 10,000 deri në 30,000 kërkesa | ≈ 72 dollarë / muaj |
| MediaStack Professional | 249 dollarë në muaj | 50 mijë kërkesa | ≈ 184 dollarë / muaj |
| NewsAPI Business | 449 dollarë në muaj | 250,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.
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.
/api/public/v1/ngjarje— NgjarjetNgjarjet 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
/api/public/v1/events/{id}— Detajet e ngjarjesTë dhënat e plota: ndarja e mbulimit (pronësia, orientimi, vendi, gjuha) dhe artikuj të ngjashëm.
Parametrat: asnjë
/api/public/v1/artikuj— Artikuj të papërpunuarArtikujt 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
/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}
/api/public/v1/sinjale— Vroege signalenNgjarjet 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
/api/public/v1/barometra— BarometraFrekuenca dhe toni i ndërthurur sipas temës, vendit dhe gjuhës: vëllimi, daljet, ndjenjat, intensiteti, tensioni, niveli i situatës.
Parametrat: asnjë
/api/public/v1/mbulim— Mbulimi globalRegjistroni statusin sipas vendit: media aktive, artikuj të fundit, gjuhë, status (i mbuluar / i dobët / mungon / nuk ka prizë lokale).
Parametrat: asnjë
/api/public/v1/burimet— Drejtoria e mediasDyqane 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.