Cam Stats API

Cam Stats API on JSON-muotoinen API, joka tarjoaa webcam-markkinan tilastot yhdeksältä webcam-sivustolta. Se antaa kaiken, mitä statadult näyttää, tunneittain päivitettynä: sivustot, tunnit, maat, kategoriat, maksulliset showt, kärkilistat ja mallien tilastot. Studiot, kumppanit ja analyytikot käyttävät sitä omissa koontinäytöissään.

Hanki ilmainen avain RapidAPI:ssa

Mitä saat

Sivustot ja markkina. Lähetyksessä olevat huoneet nyt, 7 päivän keskiarvot, huoneet päivässä, tunnit lähetyspäivää kohden, katsojat huonetta kohden ja viikoittainen muutos.
Tunnit. Jokaisen sivuston tuntiprofiili, 35 päivän historia tunti tunnilta ja parhaat ajat millä tahansa aikavyöhykkeellä.
Maat ja kategoriat. Mistä mallit lähettävät ja yleisimmät tagit sivustoittain.
Maksulliset showt ja tipit. Yksityis- ja ryhmäshowissa vietetyn ajan osuus, showjen kesto, yksityisshowjen hinnat ja julkiset tipit huonetuntia kohden, jos sivusto näyttää ne.
Mallit. Lähetystunnit, aikataulu, seuraajat, maksulliset showt ja kärkilistat sivustoittain. Ei koskaan mallin ansioita, tippejä tai katsojamääriä.

Lukua, jonka takana ei ole riittävästi havaintoja, ei näytetä vastauksessa, eikä sitä koskaan korvata nollalla.

Miten laskemme

Paketit

Basic

Ilmainen

100 pyyntöä kuukaudessa
enintään 1 sekunnissa

Hanki ilmainen avain

Pro

$24 kuukaudessa

20 000 pyyntöä kuukaudessa
enintään 5 sekunnissa

Tilaa

Ultra

$64 kuukaudessa

100 000 pyyntöä kuukaudessa
enintään 10 sekunnissa

Tilaa

Mega

$159 kuukaudessa

500 000 pyyntöä kuukaudessa
enintään 25 sekunnissa

Tilaa

Ilmaiseen pakettiin tarvitset vain sähköpostiosoitteen. Maksulliset paketit maksetaan kryptovaluutalla tililläsi 1, 3 tai 12 kuukaudeksi; 12 kuukautta maksaa saman verran kuin 10. Pyynnöt uusiutuvat maksullisessa paketissa 30 päivän välein ja ilmaisessa paketissa kunkin kuukauden 1. päivänä. Sama API on myös RapidAPI:ssa, jos maksat mieluummin siellä kortilla.

Tunnistautuminen

Lähetä avaimesi X-API-Key-otsakkeessa (tai muodossa Authorization: Bearer). Jokainen vastaus sisältää otsakkeet X-Quota-Limit, X-Quota-Remaining ja X-Quota-Reset.

curl -H "X-API-Key: YOUR_KEY" https://statadult.com/api/v2/sites/chaturbate

Päätepisteet

OpenAPI-määrittely

Kaikki pyynnöt ovat GET-pyyntöjä; vastaukset ovat JSONia englanninkielisin kentännimin, ajat UTC-ajassa (ISO 8601). Perus-URL: https://statadult.com/api/v2

GET/sites

Kaikki sivustot

Jokainen seuraamamme sivusto: lähetyksessä olevat huoneet nyt, online-huoneiden 7 päivän keskiarvo, huoneita päivässä, tunteja lähetyspäivää kohden, katsojia huonetta kohden, muutos edelliseen viikkoon, vilkkain UTC-tunti ja maksullisissa showissa vietetyn ajan osuus.

Esimerkki: https://statadult.com/api/v2/sites

GET/sites/{site}

Yksi sivusto tarkemmin

Sivusto eriteltynä sukupuolen, ikäryhmän, suurimpien maiden, kielten ja tagien mukaan sekä sen tuntiprofiili (UTC, viimeiset 14 päivää), maksulliset showt (osuus ajasta, showt mallia kohden päivässä, yksityisshown kesto, mediaanihinta, osuus tunneittain) ja julkiset tipit huonetuntia kohden, jos sivusto näyttää ne.

site: Sivusto: stripchat, chaturbate, bongacams, cam4, camsoda, livejasmin, myfreecams, xlovecam, flirt4free. (polku, pakollinen)

Esimerkki: https://statadult.com/api/v2/sites/chaturbate

GET/sites/{site}/hours

Tunti tunnilta

Lähetyksessä olevat huoneet ja katsojat huonetta kohden viime päivien jokaiselta tunnilta (UTC).

site: Sivusto: stripchat, chaturbate, bongacams, cam4, camsoda, livejasmin, myfreecams, xlovecam, flirt4free. (polku, pakollinen)
days: Montako päivää taaksepäin, 1–35. Oletus 7. (kysely)

Esimerkki: https://statadult.com/api/v2/sites/stripchat/hours?days=2

GET/market

Koko markkina

Kaikki sivustot yhdessä: lähetyksessä olevat huoneet nyt, 7 päivän keskiarvot, tuntiprofiili (UTC) ja maksullisten showjen osuus tunneittain.

Esimerkki: https://statadult.com/api/v2/market

GET/countries

Maat

Mistä mallit lähettävät, kaikki sivustot yhdessä: huoneita online keskimäärin, huoneita päivässä, muutos ja osuus. LiveJasmin ja XLoveCam eivät julkaise maata.

Esimerkki: https://statadult.com/api/v2/countries

GET/countries/{country}

Yksi maa

Yksi maa sivustoittain ja sen lähetyksessä olevat huoneet keskimäärin UTC-tunneittain.

country: ISO 3166 -koodi (co) tai nimi samassa muodossa kuin linkeissämme (colombia). (polku, pakollinen)

Esimerkki: https://statadult.com/api/v2/countries/co

GET/tags

Kategoriat

Yleisimmät tagit niillä sivustoilla, jotka julkaisevat tagit.

Esimerkki: https://statadult.com/api/v2/tags

GET/tags/{tag}

Yksi kategoria

Tagi sivustoittain: huoneita online keskimäärin, huoneita päivässä ja muutos.

tag: Tagi listasta /tags. (polku, pakollinen)

Esimerkki: https://statadult.com/api/v2/tags/latina

GET/best-hours

Parhaat ajat

Lähetyksessä olevat huoneet ja katsojat huonetta kohden keskimäärin vuorokauden jokaiselta tunnilta valitulla aikavyöhykkeellä viimeisten 14 päivän ajalta sekä vilkkain ja hiljaisin tunti.

tz: IANA-aikavyöhyke, esim. Europe/Madrid. Oletus UTC. (kysely)

Esimerkki: https://statadult.com/api/v2/best-hours?tz=America/Bogota

GET/models/{site}/{username}

Mallin tilastot

Lähetystunnit (7 ja 30 päivää), lähetyspäivät, tunteja lähetyspäivää kohden, aikataulun säännöllisyys, seuraajat ja niiden muutos, keskimääräiset ja päivän suurimmat katsojamäärät, maksulliset showt (osuus ajasta, showjen määrä, paras sija listalla, yksityisshown hinta), hänen viikkoaikataulunsa UTC-tunneittain ja taulukko päivä päivältä. Ei ansioita, ei tippejä.

site: Sivusto: stripchat, chaturbate, bongacams, cam4, camsoda, livejasmin, myfreecams, xlovecam, flirt4free. (polku, pakollinen)
username: Käyttäjänimi kyseisellä sivustolla. (polku, pakollinen)

Esimerkki: https://statadult.com/api/v2/models/chaturbate/hayleex

GET/rankings/{site}

Kärkilistat

Sivuston mallit lähetystuntien mukaan järjestettyinä.

site: Sivusto: stripchat, chaturbate, bongacams, cam4, camsoda, livejasmin, myfreecams, xlovecam, flirt4free. (polku, pakollinen)
period: Järjestys viimeisten 7 tai 30 päivän mukaan. Oletus 7. (kysely)
gender: Vain tämä sukupuoli: female, male, couple tai trans. (kysely)
limit: 1–500. Oletus 100. (kysely)

Esimerkki: https://statadult.com/api/v2/rankings/stripchat?period=7&gender=female&limit=10

GET/search

Etsi malli

Sivustot, joilla käyttäjänimi on olemassa, sekä linkit hänen tilastoihinsa.

username: Käyttäjänimi tai linkki profiiliin. (kysely, pakollinen)

Esimerkki: https://statadult.com/api/v2/search?username=hayleex

Virheet

Virheet palautetaan JSON-muodossa kentillä error (koodi) ja message. Epäonnistunutta pyyntöä ei lasketa kuukauden kiintiöön.

400 bad_username, bad_tz Jokin parametri ei kelpaa.

401 missing_api_key Pyynnössä ei ole avainta.

401 invalid_api_key Avain on väärä tai se on vaihdettu.

404 not_found Sivustoa, maata, tagia tai mallia ei ole, tai siitä ei ole vielä tarpeeksi tietoja.

429 rate_limited Liikaa pyyntöjä sekunnissa pakettiin nähden.

429 limit_exceeded Kuukauden pyynnöt on käytetty.

503 warming_up, unavailable Tilastoja ladataan; yritä uudelleen minuutin päästä.