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

# Guía paso a paso

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

<div id="how-to-get-access-to-the-ads-api">
  ## Cómo obtener acceso a la Ads API
</div>

1. Regístrate para obtener una [cuenta de desarrollador](https://developer.x.com/en/apply-for-access).
2. Crea una [App de desarrollador](https://developer.x.com/app) y protege tu token.
3. Visita [ads.x.com/help](https://ads.x.com/help) para enviar una solicitud de acceso a la Ads API para cada una de tus App de desarrollador.

<Note>**Nota:** Si ya estás utilizando la X Developer Platform y ya tienes una cuenta de desarrollador, ve al paso tres.</Note>

<div id="step-one-signup-for-a-developer-account">
  ### Primer paso: Regístrate para obtener una cuenta de desarrollador
</div>

Para realizar solicitudes a cualquiera de los productos de la API de X, primero debes registrarte para obtener una cuenta de desarrollador. Dentro de la Consola de desarrollador, crea una App y una App de desarrollador. Esto te proporcionará un conjunto de credenciales que usarás para autenticar todas las solicitudes a la API.

<Button href="https://developer.x.com/en/apply-for-access">
  Regístrate para obtener una cuenta de desarrollador
</Button>

<div id="step-two-save-your-apps-key-and-tokens-and-keep-them-secure">
  ### Paso dos: Guarda la clave y los tokens de tu App y mantenlos seguros
</div>

Dentro de tu App de desarrollador, se te proporcionará un conjunto de claves de API (API Keys, también conocidas como Consumer Keys). También tendrás la oportunidad de generar un conjunto de Access Tokens que se pueden usar para realizar solicitudes en nombre de tu cuenta personal de X, y un Bearer Token que se puede usar para autenticar endpoints que requieren OAuth 2.0 Bearer Token. Como estas claves y tokens no caducan a menos que se regeneren, sugerimos crear variables de entorno o usar un gestor de contraseñas seguro.

Toma también nota de tu App ID, que se puede encontrar en la URL de los detalles de tu App. Esto facilitará solicitar acceso a la Ads API en el siguiente paso.

<Note>
  **Nota:** Tus claves y tokens solo se mostrarán una vez en la Consola de desarrollador, por lo que es importante que almacenes estas credenciales en tu gestor de contraseñas tan pronto como las generes.

  Si pierdes u olvidas las claves y los tokens, tendrás que regenerarlos, lo que crea nuevas claves y tokens e invalida los anteriores. Esto significa que tendrás que actualizar cualquier integración que puedas haber configurado con tus credenciales anteriores.

  Obtén más información sobre nuestras [mejores prácticas de autenticación](https://developer.x.com/en/docs/authentication/guides/authentication-best-practices).
</Note>

<div id="step-three-apply-for-access-to-the-ads-api">
  ### Paso tres: solicita acceso a la Ads API
</div>

En este punto ya tendrás [acceso básico a la X API](https://developer.x.com/en/docs/twitter-api/v1), pero no a la funcionalidad específica de la Ads API de X. A continuación, deberás solicitar acceso y obtener la aprobación para usar la Ads API. Visita [ads.x.com/help](https://ads.x.com/help) para solicitar acceso a la Ads API para cada una de tus Apps de desarrollador.

<div id="access-tiers">
  ### Niveles de acceso
</div>

Como parte del proceso de solicitud, deberás especificar qué nivel de acceso necesitas. Obtén más información sobre los [permisos a nivel de App y a nivel de cuenta publicitaria](https://developer.x.com/en/docs/twitter-ads-api/obtaining-ads-account-access#levels-of-access).

<div id="conversion-only">
  #### Solo conversiones
</div>

Acceso a los endpoints de conversiones móviles y web con permisos de lectura y escritura.

<div id="standard-access">
  #### Acceso estándar
</div>

Acceso a los endpoints de Analytics, Campaign Management, Creatives, Custom Audiences y Conversion con permisos de lectura y escritura.

<Note>**Nota:** Después de que tu App sea aprobada para el acceso a Ads API, tendrás que [regenerar todos los tokens de acceso de usuario](https://developer.x.com/resources/fundamentals/authentication/obtaining-user-access-tokens) para realizar [solicitudes a Ads API correctamente autenticadas](https://developer.x.com/en/docs/twitter-ads-api/making-authenticated-requests).</Note>

<Note>**Nota:** Los desarrolladores de Ads API que solicitaron acceso antes de julio de 2023 pueden tener diferentes niveles de acceso y permisos, y pueden estar limitados a cinco tokens OAuth. Consulta nuestra guía sobre [cómo aumentar tu nivel de acceso](https://developer.x.com/en/docs/twitter-ads-api/increasing-access) para obtener acceso a endpoints adicionales o eliminar los límites de tokens para las aplicaciones existentes.</Note>

<div id="make-your-first-request">
  ## Realiza tu primera solicitud
</div>

Para probar tu acceso a la Ads API, realiza una solicitud al endpoint [GET accounts](https://developer.x.com/en/docs/twitter-ads-api/campaign-management/api-reference/accounts). Este endpoint devolverá las cuentas publicitarias a las que el usuario autorizado actual tiene acceso. Usa los `id` de las cuentas publicitarias de esta solicitud en solicitudes posteriores a la API para leer y escribir datos de una cuenta publicitaria específica. Usando [Twurl](https://developer.x.com/en/docs/tutorials/using-twurl) en la línea de comandos, la solicitud tendría el siguiente aspecto.

**Solicitud de ejemplo**

```bash theme={null}
twurl -H ads-api.x.com "/11/accounts"
```

**Ejemplo de respuesta**

```json theme={null}
{
  "request": {
    "params": {}
  },
  "data": [
   {
    "name": "Furni",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-04-06T07:00:00Z",
    "id": "18ce54ayf0z",
    "created_at": "2016-04-07T14:40:15Z",
    "salt": "b88939e5cabbca720159cb3659d73c06",
    "updated_at": "2017-02-08T08:49:53Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
     }
   ]
}
```

<div id="up-next">
  ## A continuación . . .
</div>

* Revisa los conceptos fundamentales de la [documentación de Ads API](https://developer.x.com/en/docs/twitter-ads-api), como el [control de versiones](https://developer.x.com/en/docs/twitter-ads-api/versioning) y la [terminología de jerarquías](https://developer.x.com/en/docs/twitter-ads-api/hierarchy-terminology).
* Explora las distintas [herramientas y bibliotecas de Ads API](https://developer.x.com/en/docs/twitter-ads-api/tools-and-libraries) que pueden ayudarte en tu integración con Ads API.
* Entiende los pasos para [aumentar el acceso a Ads API](https://developer.x.com/en/docs/twitter-ads-api/increasing-access).
* Familiarízate con los [recursos de soporte](https://developer.x.com/en/support/twitter-ads-api) disponibles.
* Sigue a [@API](https://x.com/API) para recibir actualizaciones en tiempo real sobre cambios en la API, incidencias de servicio y mejoras en los productos promocionados de X.