Doordash

Doordash Keywords (SP) API

For Sponsored Products campaigns only.

GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /ads/api/v1/sp/keywords Get keyword recommendations for products · Get recommended keywords #
Ask an LLM
“Which keywords should I bid on for these products?”
“Can I get keyword recommendations for a specific placement type?”
Tell an agent
Recommend keywords for products {products} in placements {placements}.
Suggest keywords to bid on for {products}.
POST /ads/api/v1/sp/adGroups/{adGroupId}/keywords Get recommended keywords with ad group status · Get recommended keywords with status in ad group #
Ask an LLM
“Which recommended keywords are new to my ad group?”
“Can I see the status of recommended keywords inside an existing ad group?”
Tell an agent
Show recommended keywords and their status in ad group {adGroupId} for {products}.
Find which recommended keywords are new to ad group {adGroupId} for placements {placements}.

Documentation

📖
APIReference
https://developer.doordash.com/en-US/api/ads
📖
APIReference
https://developer.doordash.com/en-US/api/storefront
📖
APIReference
https://developer.doordash.com/en-US/api/drive_v2_parcel
📖
Documentation
https://developer.doordash.com/en-US/docs/drive/how_to/Parcel/error_handling
📖
APIReference
https://developer.doordash.com/en-US/api/drive_refunds
📖
APIReference
https://developer.doordash.com/en-US/api/drive_redelivery
📖
APIReference
https://developer.doordash.com/en-US/api/drive_dasher_feedback
📖
APIReference
https://developer.doordash.com/en-US/api/external_checkout
📖
APIReference
https://developer.doordash.com/en-US/api/marketplace_legacy
📖
Documentation
https://developer.doordash.com/en-US/docs/marketplace/faq/legacy_partner_migration

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/doordash/refs/heads/main/openapi/doordash-keywords-sp-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/doordash-keywords-sp-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

doordash-keywords-sp-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.29
  title: DoorDash Ads Keywords (SP) API
  description: DoorDash Ads API for Sponsored Products for campaign management and reporting operations.
servers:
- url: https://openapi.doordash.com
security:
- Ads API Key Authentication: []
tags:
- name: Keywords (SP)
  description: For Sponsored Products campaigns only.
paths:
  /ads/api/v1/sp/keywords:
    post:
      tags:
      - Keywords (SP)
      operationId: getRecommendedKeywordsForProducts
      summary: Get recommended keywords
      description: Get a list of recommended keywords for the provided products and placement type.
      requestBody:
        description: List of placement types and list of product IDs.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetRecommendedKeywordsRequest'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecommendedKeywordsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /ads/api/v1/sp/adGroups/{adGroupId}/keywords:
    post:
      tags:
      - Keywords (SP)
      operationId: getRecommendedKeywordsAdGroupStatus
      summary: Get recommended keywords with status in ad group
      description: Get a list of recommended keywords and their status within the given ad group (e.g. new) for the provided products and placement type.
      parameters:
      - name: adGroupId
        in: path
        description: Unique identifier for an ad group
        required: true
        schema:
          type: string
      requestBody:
        description: List of placement types and list of product IDs.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetRecommendedKeywordsRequest'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecommendedKeywordsStatusResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ProductIdType:
      description: Product ID type
      type: string
      enum:
      - GTIN_14
      - UPC
      - DD_SIC
    RecommendedKeywordsResponse:
      required:
      - recommendedKeywords
      properties:
        recommendedKeywords:
          type: object
          properties:
            SEARCH:
              type: array
              items:
                type: string
          required:
          - SEARCH
          additionalProperties:
            type: array
            items:
              type: string
    KeywordStatus:
      properties:
        keyword:
          type: string
        status:
          type: string
          enum:
          - NEW
    Placement:
      required:
      - type
      properties:
        type:
          description: Specifies an ad group surface
          type: string
          enum:
          - SEARCH
          - CATEGORIES
          - COLLECTION
          - DOUBLEDASH
    Error:
      properties:
        code:
          description: An enumerated error for machine use.
          type: string
          readOnly: true
        details:
          description: A human-readable description of the error.
          type: string
          readOnly: true
    GetRecommendedKeywordsRequest:
      required:
      - placements
      - products
      properties:
        placements:
          type: array
          items:
            $ref: '#/components/schemas/Placement'
          description: Placement type must be 'SEARCH' for recommended keywords.
        products:
          description: List of product IDs
          type: array
          items:
            properties:
              idType:
                $ref: '#/components/schemas/ProductIdType'
              productId:
                $ref: '#/components/schemas/ProductId'
    ProductId:
      description: Unique product identifier based on product ID type.
      type: string
    RecommendedKeywordsStatusResponse:
      required:
      - recommendedKeywords
      properties:
        recommendedKeywords:
          type: object
          properties:
            SEARCH:
              type: array
              items:
                $ref: '#/components/schemas/KeywordStatus'
          required:
          - SEARCH
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/KeywordStatus'
  responses:
    Unauthorized:
      description: Unauthorized.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: One or more query parameters contained an invalid value.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Bad request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    Ads_API_Key_Authentication:
      type: apiKey
      scheme: bearer
      in: header
      name: Authorization
      description: We will be using stateful token based API keys to authenticate clients, passed in the 'Authorization' header as 'Bearer {API_KEY}'.