Sikayetvar APIsikayetvar.com ↗
Access brand profiles, paginated complaint feeds, and full complaint text with comments from sikayetvar.com via two structured JSON endpoints.
What is the Sikayetvar API?
The Sikayetvar.com API exposes 2 endpoints covering brand profiles and individual complaints from Turkey's largest consumer complaint platform. get_brand_page returns a brand's satisfaction score, AiVar report card, rated reviews, and up to 24 complaint cards per page. get_complaint returns the full complaint text, ISO-8601 timestamps, site-assigned keywords, upvote count, and all threaded comments for a single complaint.
curl -X GET 'https://api.parse.bot/scraper/a9f3e16c-691b-4bed-9b94-054db651e802/get_brand_page?page=2&brand_slug=star-tv' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns one page of a brand's complaint feed on sikayetvar.com together with the brand profile. One round trip per call. `complaints` holds up to 24 complaint cards per page, newest first, each with a numeric `id`, `url_path` (pass unchanged to get_complaint), author, view count, a truncated `excerpt`, `is_solved`, and, for resolved complaints, the complainant's star rating (1-5) and thank-you note; `upvote_count`/`comment_count` are null when the site does not render them on the card. Brand profile details (`logo_url`, `address`, `satisfaction_score` 0-100, `rating_count`), the AiVar `report_card` (summary, resolution-success metrics, resolution breakdown, customer thanks, top complaint topics) and the rated `reviews` list are published by the site only on page 1; on later pages they come back null/empty. Paging: `page` defaults to 1; `has_more` is true when the site advertises a next page and `next_page` is the value to pass. Unknown brand slugs return a not-found error. Text is in Turkish as published; `published_at_label` is the site's Turkish date label.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page of the complaint feed. |
| brand_slugrequired | string | Brand slug as it appears in the brand's sikayetvar.com URL path (lowercase letters, digits and hyphens), e.g. star-tv. |
{
"type": "object",
"fields": {
"page": "integer page requested",
"brand": "object: slug, name, url, logo_url, external_links (brand's own site/social URLs), address {street, locality, region, country}, satisfaction_score (0-100), satisfaction_score_max, rating_count; profile fields are null on pages > 1",
"reviews": "array of rated reviews the site publishes for the brand: headline, body (truncated), date_published (YYYY-MM-DD), author_name, rating with rating_best/rating_worst",
"has_more": "boolean, true when the site advertises a following page",
"next_page": "integer page to request next, or null",
"complaints": "array of complaint cards: id (integer), title, url_path, url, author_name, author_url, published_at_label, view_count, excerpt, upvote_count, comment_count, is_solved, complainant_rating, thank_you_note, image_url, video_poster_url",
"report_card": "AiVar report card object (summary text, metrics [{label, value}], resolution_breakdown [{label, percent}], customer_thanks [{author_name, author_url, text}], top_complaint_topics [{title, items}]) or null when not rendered"
},
"sample": {
"data": {
"page": 1,
"brand": {
"url": "https://www.sikayetvar.com/star-tv",
"name": "Star TV",
"slug": "star-tv",
"address": {
"region": "İstanbul",
"street": "Doğuş Yayın Grubu A.Ş. Ahi Evran Cad. No:4 34398 Maslak",
"country": "TR",
"locality": "Sarıyer"
},
"logo_url": "https://files.sikayetvar.com/lg/cmp/18/182.svg?1522650125",
"rating_count": 15,
"external_links": [
"https://startv.com.tr",
"https://www.facebook.com/startv",
"https://www.instagram.com/startv"
],
"satisfaction_score": 33,
"satisfaction_score_max": 100
},
"reviews": [
{
"body": "Star Tv’de yayımlanan Tuzlu Kahve programının 3. Bölümü 15 Eylül 2026 tarihinde televizyonda yayımlandı. Ancak ...",
"rating": 5,
"headline": "Tuzlu Kahve 3. Bölüm YouTube’da Yüklenmediği İçin İzleyiciler Mağdur",
"author_name": "Tuna",
"rating_best": 5,
"rating_worst": 1,
"date_published": "2026-09-16"
}
],
"has_more": true,
"next_page": 2,
"complaints": [
{
"id": 37168320,
"url": "https://www.sikayetvar.com/star-tv/tuzlu-kahve-dizisinde-oyuncu-performansi-uzerine-geri-bildirim",
"title": "Tuzlu Kahve dizisinde oyuncu performansı üzerine geri bildirim",
"excerpt": "Tuzlu Kahve dizisini ilk bölümünden beri takip ediyorum ancak ...",
"url_path": "/star-tv/tuzlu-kahve-dizisinde-oyuncu-performansi-uzerine-geri-bildirim",
"image_url": null,
"is_solved": false,
"author_url": "https://www.sikayetvar.com/uye/nezahat-17662709",
"view_count": 1,
"author_name": "Nezahat",
"upvote_count": null,
"comment_count": null,
"thank_you_note": null,
"video_poster_url": null,
"complainant_rating": null,
"published_at_label": "28 Eylül 2026 12:47"
}
],
"report_card": {
"metrics": [
{
"label": "Çözüm Başarısı",
"value": 31
},
{
"label": "Çözülen Şikayet",
"value": 5
}
],
"summary": "Star TV izleyicilerinin son 1 yıl içinde ilettiği şikayetlerde en sık uygunsuz içerikler öne çıkıyor; ... Çözümlerde en sık ücret iadesi (%50) izleniyor.",
"customer_thanks": [
{
"text": "Bölümü resmi hesaba yüklediğiniz için teşekkür ederim",
"author_url": "https://www.sikayetvar.com/uye/tuna-15972022",
"author_name": "Tuna"
}
],
"resolution_breakdown": [
{
"label": "Para-ücret iade edildi",
"percent": 50
},
{
"label": "Ürün-hizmet-tarife değiştirildi",
"percent": 25
}
],
"top_complaint_topics": [
{
"items": [
"Uygunsuz içerik: 24 şikayette dini değerlerin ... belirtiliyor. + 4"
],
"title": "Yayın İçeriklerinde Hassasiyet ve Etik Sorunlar"
}
]
}
},
"status": "success"
}
}About the Sikayetvar API
Brand Profile and Complaint Feed
get_brand_page accepts a brand_slug (the lowercase slug from the brand's sikayetvar.com URL, e.g. star-tv) and an optional 1-based page integer. Each response includes a brand object with fields for name, logo_url, external_links, a structured address, and a satisfaction score. The report_card field contains the AiVar summary text, named metrics with values, a resolution breakdown as labeled percentages, and customer-thanks attributions. The complaints array holds up to 24 cards per page, each carrying a numeric id, title, url_path, author_name, published_at_label, view_count, excerpt, and upvote count. Pagination is signaled by has_more (boolean) and next_page (integer or null).
Individual Complaint Detail
get_complaint accepts a complaint_path in the form /<brand-slug>/<complaint-slug> exactly as emitted in complaints[*].url_path from get_brand_page. The response contains the full complaint text, title, brand_name, brand_slug, keywords (a site-assigned string, may be null), view_count, upvote_count (the site's "Destek" metric), and ISO-8601 created/published/modified timestamps using the Europe/Istanbul offset as published. The comments array returns each reply with its text, date_published, author_name, and author_url; it is empty when no comments exist.
Coverage Notes
The API covers public brand pages and public complaints on sikayetvar.com. Brand slugs must match the exact path segment used in sikayetvar.com URLs. Page indexing starts at 1, and results are ordered newest first. The reviews array on get_brand_page reflects rated reviews the site surfaces for the brand, each with a headline, truncated body, date_published, and author_name.
The Sikayetvar API is a managed, monitored endpoint for sikayetvar.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sikayetvar.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official sikayetvar.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track a brand's satisfaction score and AiVar report-card metrics over time using repeated
get_brand_pagecalls - Aggregate complaint excerpts and upvote counts across all pages to identify the most-discussed issues for a brand
- Feed full complaint text from
get_complaintinto NLP pipelines for Turkish-language sentiment or topic classification - Monitor the
resolution_breakdownpercentages from the report card to benchmark how brands compare on complaint resolution - Collect
commentsarrays from individual complaints to study how brands respond publicly to consumer grievances - Build a brand-reputation dashboard combining
view_count,upvote_count, andpublished_attimestamps across paginated feeds - Extract
external_linksandaddressfields from brand profiles for B2B enrichment or contact data research
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does sikayetvar.com offer an official developer API?+
What does `get_brand_page` return beyond complaint cards?+
get_brand_page returns a full brand object (slug, name, logo URL, external links, address, satisfaction score), a reviews array of rated reviews with headlines and dates, and a report_card object containing an AiVar summary, named metrics with values, resolution percentages, and customer-thanks entries — all in one response alongside the paginated complaints array.Can I retrieve complaints in a language other than Turkish, or filter by date range or complaint status?+
Does the API return complaints for any brand, or only specific ones?+
brand_slug to get_brand_page. The slug must match the exact path segment in the brand's sikayetvar.com URL. Private or removed brand pages are not covered. If a brand you need is missing or returns no results, you can fork the API on Parse and revise it to handle alternate slug formats or additional brand discovery.Are complaint author identities or brand responses exposed in the data?+
author_name and author_url as published publicly on the site. The comments array on get_complaint includes replies with author name, URL, and date. Dedicated brand-side response metadata (e.g. a structured resolved/unresolved status field) is not a separate field in the current response shape. You can fork the API on Parse and revise it to surface additional comment-author role signals if the source exposes them.