> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Trendyol categories

> Trendyol category tree: 10 departments with nested subcategories (id, name, alias, parent id, URL). Pass a category id or alias to get just that subtree. 5 point per returned record.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-trendyol-categories
openapi: 3.0.0
info:
  title: NeuralVerge API
  version: 1.0.0
  description: >-
    NeuralVerge API for AI research workflows, search, extraction, and
    structured data source execution.
servers:
  - url: https://api.neuralverge.ai
    description: NeuralVerge API
security:
  - BearerAuth: []
tags:
  - name: AI Research
    description: Research workflows and session tracking.
  - name: AI Extract
    description: Schema-driven extraction workflows.
  - name: AI Agents
    description: Reusable saved agents executed through the API.
  - name: Search
    description: Fast, synchronous web search with no session or polling.
  - name: Company intelligence
    description: Company profile lookups from company databases.
  - name: E-commerce & Marketplaces
    description: >-
      Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress,
      and Alibaba.
  - name: Enrichment
    description: Email and phone enrichment, validation, and discovery.
  - name: Product reviews
    description: >-
      Software and business reviews from Capterra, Gartner Peer Insights, and
      Trustpilot.
  - name: Social media
    description: LinkedIn profile, company, and people lookups.
paths:
  /functions/v1/run-trendyol-categories:
    post:
      tags:
        - E-commerce & Marketplaces
      summary: Trendyol categories
      description: >-
        Trendyol category tree: 10 departments with nested subcategories (id,
        name, alias, parent id, URL). Pass a category id or alias to get just
        that subtree. 5 point per returned record.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  description: >-
                    Category id or alias (optional). e.g. e.g. elektronik or 5 —
                    leave empty for the full tree
                  type: string
            example: {}
      responses:
        '200':
          description: Run completed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    description: Session identifier for this run.
                  kind:
                    type: string
                    description: Data source identifier for this endpoint.
                  category: {}
                  human:
                    type: string
                    description: Markdown summary of the result, for display.
                  machine:
                    type: object
                    properties:
                      total_items:
                        type: integer
                      first_item:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          alias:
                            type: string
                          parent_category_id: {}
                          url:
                            type: string
                          image: {}
                          children:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                alias:
                                  type: string
                                parent_category_id:
                                  type: string
                                url:
                                  type: string
                                image: {}
                                children:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      id:
                                        type: string
                                      name:
                                        type: string
                                      alias:
                                        type: string
                                      parent_category_id:
                                        type: string
                                      url:
                                        type: string
                                      image: {}
                                      children:
                                        type: array
                                        items: {}
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            alias:
                              type: string
                            parent_category_id: {}
                            url:
                              type: string
                            image: {}
                            children:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  alias:
                                    type: string
                                  parent_category_id:
                                    type: string
                                  url:
                                    type: string
                                  image: {}
                                  children:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                        name:
                                          type: string
                                        alias:
                                          type: string
                                        parent_category_id:
                                          type: string
                                        url:
                                          type: string
                                        image: {}
                                        children:
                                          type: array
                                          items: {}
                      proxy_traffic_bytes:
                        type: integer
                    description: Structured result payload.
                  total_points:
                    type: integer
                    description: Points charged for this run.
              example:
                session_id: 11111111-1111-1111-1111-111111111111
                kind: trendyol_categories
                category: null
                human: |-
                  # Trendyol categories

                  - **Category filter:** (none - full tree)
                  - **Categories returned:** 1141
                  - **Proxy traffic:** 698.0 KB
                machine:
                  total_items: 10
                  first_item:
                    id: '1'
                    name: Kadın
                    alias: kadin
                    parent_category_id: null
                    url: https://www.trendyol.com/butik/liste/1/kadin
                    image: null
                    children:
                      - id: '82'
                        name: Giyim
                        alias: kadin-giyim
                        parent_category_id: '1'
                        url: https://www.trendyol.com/kadin-giyim-x-g1-c82
                        image: null
                        children:
                          - id: '56'
                            name: Elbise
                            alias: elbise
                            parent_category_id: '82'
                            url: https://www.trendyol.com/elbise-x-c56
                            image: null
                            children: []
                          - id: '73'
                            name: Tişört
                            alias: kadin-t-shirt
                            parent_category_id: '82'
                            url: https://www.trendyol.com/kadin-t-shirt-x-g1-c73
                            image: null
                            children: []
                      - id: '114'
                        name: Ayakkabı
                        alias: kadin-ayakkabi
                        parent_category_id: '1'
                        url: https://www.trendyol.com/kadin-ayakkabi-x-g1-c114
                        image: null
                        children:
                          - id: '107'
                            name: Topuklu Ayakkabı
                            alias: kadin-topuklu-ayakkabi
                            parent_category_id: '114'
                            url: >-
                              https://www.trendyol.com/kadin-topuklu-ayakkabi-x-g1-c107
                            image: null
                            children: []
                          - id: '1172'
                            name: Sneaker
                            alias: kadin-sneaker
                            parent_category_id: '114'
                            url: https://www.trendyol.com/kadin-sneaker-x-g1-c1172
                            image: null
                            children: []
                  items:
                    - id: '1'
                      name: Kadın
                      alias: kadin
                      parent_category_id: null
                      url: https://www.trendyol.com/butik/liste/1/kadin
                      image: null
                      children:
                        - id: '82'
                          name: Giyim
                          alias: kadin-giyim
                          parent_category_id: '1'
                          url: https://www.trendyol.com/kadin-giyim-x-g1-c82
                          image: null
                          children:
                            - id: '56'
                              name: Elbise
                              alias: elbise
                              parent_category_id: '82'
                              url: https://www.trendyol.com/elbise-x-c56
                              image: null
                              children: []
                            - id: '73'
                              name: Tişört
                              alias: kadin-t-shirt
                              parent_category_id: '82'
                              url: https://www.trendyol.com/kadin-t-shirt-x-g1-c73
                              image: null
                              children: []
                        - id: '114'
                          name: Ayakkabı
                          alias: kadin-ayakkabi
                          parent_category_id: '1'
                          url: https://www.trendyol.com/kadin-ayakkabi-x-g1-c114
                          image: null
                          children:
                            - id: '107'
                              name: Topuklu Ayakkabı
                              alias: kadin-topuklu-ayakkabi
                              parent_category_id: '114'
                              url: >-
                                https://www.trendyol.com/kadin-topuklu-ayakkabi-x-g1-c107
                              image: null
                              children: []
                            - id: '1172'
                              name: Sneaker
                              alias: kadin-sneaker
                              parent_category_id: '114'
                              url: >-
                                https://www.trendyol.com/kadin-sneaker-x-g1-c1172
                              image: null
                              children: []
                    - id: '2'
                      name: Erkek
                      alias: erkek
                      parent_category_id: null
                      url: https://www.trendyol.com/butik/liste/2/erkek
                      image: null
                      children:
                        - id: '82'
                          name: Giyim
                          alias: erkek-giyim
                          parent_category_id: '2'
                          url: https://www.trendyol.com/erkek-giyim-x-g2-c82
                          image: null
                          children:
                            - id: '73'
                              name: Tişört
                              alias: erkek-t-shirt
                              parent_category_id: '82'
                              url: https://www.trendyol.com/erkek-t-shirt-x-g2-c73
                              image: null
                              children: []
                            - id: '119'
                              name: Şort
                              alias: erkek-sort
                              parent_category_id: '82'
                              url: https://www.trendyol.com/erkek-sort-x-g2-c119
                              image: null
                              children: []
                        - id: '114'
                          name: Ayakkabı
                          alias: erkek-ayakkabi
                          parent_category_id: '2'
                          url: https://www.trendyol.com/erkek-ayakkabi-x-g2-c114
                          image: null
                          children:
                            - id: '109'
                              name: Spor Ayakkabı
                              alias: erkek-spor-ayakkabi
                              parent_category_id: '114'
                              url: >-
                                https://www.trendyol.com/erkek-spor-ayakkabi-x-g2-c109
                              image: null
                              children: []
                            - id: '1352'
                              name: Günlük Ayakkabı
                              alias: erkek-gunluk-ayakkabi
                              parent_category_id: '114'
                              url: >-
                                https://www.trendyol.com/erkek-gunluk-ayakkabi-x-g2-c1352
                              image: null
                              children: []
                  proxy_traffic_bytes: 714705
                total_points: 5
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '402':
          description: Payment Required
        '500':
          description: Internal Error
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````