Action-Apps Article

Action Apps API website integration - Add Cards to your website

Action-Apps API Documentation

Action-Apps allows partner websites to display interactive business cards using simple script includes or direct JSON API requests.

1. Teaser Card Embed

Use this when you want to show a small group of featured cards.

<script 
    src="https://action-apps.com/api/cards.js"
    data-action-apps
    data-keyword="countertops"
    data-limit="3">
</script>

2. Search Results Embed

Use this for a full card results page with search.

<script 
    src="https://action-apps.com/api/card-search.js"
    data-action-apps-search
    data-keyword="countertops"
    data-limit="20">
</script>

Important: In the search embed, data-keyword="countertops" becomes the locked parent filter. Searches only happen inside that group.

3. JSON API Endpoint

https://action-apps.com/api/cards.php

General Search

https://action-apps.com/api/cards.php?keyword=countertops&limit=3

Locked Search

https://action-apps.com/api/cards.php?base_keyword=countertops&search=utah&limit=20

4. Parameters

Parameter	Description
`keyword`	General search term. Used by teaser embeds.
`base_keyword`	Locked parent keyword. Every result must match this term.
`search`	Searches within the locked `base_keyword` result group.
`company`	Filters results by company name.
`region`	Filters results by region.
`clientid`	Filters cards by client ID.
`category_id`	Filters cards by category ID.
`slug`	Returns a specific card by profile slug.
`limit`	Number of cards to return. Maximum recommended value: 50.

5. Response Example

{
  "success": true,
  "count": 3,
  "base_keyword": "countertops",
  "search": "utah",
  "cards": [
    {
      "id": 123,
      "profile_slug": "sample-card",
      "name": "Sample Name",
      "title": "Owner",
      "company": "Sample Countertops",
      "image_url": "https://action-apps.com/uploads/sample.jpg",
      "card_url": "https://action-apps.com/sample-card"
    }
  ]
}

6. Partner Teaser Example

<h2>Featured Countertop Pros</h2>

<script 
    src="https://action-apps.com/api/cards.js"
    data-action-apps
    data-keyword="countertops"
    data-limit="3">
</script>

<a href="/countertop-pros.html">View More Cards</a>

7. Full Results Page Example

<h1>Countertop Professionals</h1>

<script 
    src="https://action-apps.com/api/card-search.js"
    data-action-apps-search
    data-keyword="countertops"
    data-limit="20">
</script>

8. Recommended Partner Flow

Use the teaser embed on high-traffic content pages. Then link visitors to a full results page using the search embed.

Content Page
↓
3-card teaser embed
↓
"View More Cards" button
↓
Full searchable results page
↓
User opens Action-App card